Blog-Doc's logo
Docs GitHub logo
> Front-end

Documentation

Getting started
Creating content
Go Static!
Admin
Front-end
Development

Front-end

Front-end preview

A preview of Blog-Doc's front-end.

Content
Information SVG This preview specifically showcases the front-end of the default theme in Blog-Doc for demonstration purposes. The front-end of other themes will have a distinct appearance!

Apart from individual pages and posts, Blog-Doc's front-end is composed of five main routes:

  1. The homepage which also corresponds to the blog
  2. The archive page → List of published posts
  3. The tags page → List of all the tags
  4. The tag page → Posts' list of a tag
  5. The search page

Homepage

The homepage is a paginated blog according to the defined number of posts per page.
The blog sorts the published posts by their publication's dates in descending order, newest to oldest, and displays them according to the defined number of posts per page.
You can modify the number of displayed posts per page in the blog from:
Admin ⚡→ Settings → Site → Posts Per Page

Information SVG The blog will not be paginated if the number of published posts is less than the defined number of posts!
Homepage of Blog-Doc's front-end

You can change the blog featured image from:
Admin ⚡→ Images → Routes → Blog featured image

Archive page

The archive page displays a list of all published posts.
You can change the archive featured image from:
Admin ⚡→ Images → Routes → Archive featured image

Archive page of Blog-Doc's front-end

Tags page

The tags page displays a list of all the tags from the published posts.
In front of each tag is the number of posts tagged with this tag.
Click on a tag to display its corresponding posts.
You can change the tags featured image from:
Admin ⚡→ Images → Routes → Tags featured image

Tags page of Blog-Doc's front-end

Single tag page

Each tag page displays the published posts tagged with this tag.
The number of posts tagged with this tag is displayed in the header of the page.
You can change the tag featured image from:
Admin ⚡→ Images → Routes → Tag featured image

A single tags page of Blog-Doc's front-end

Search page

Blog-Doc has a built-in search feature. Only in Node.js app for now!
The search page allows a user to make a research on the titles and the contents of the published posts.
You can enable or disable the search feature from:
Admin ⚡→ Images → Routes → Search featured image

Search page of Blog-Doc's front-end

Post preview

You'll see that the blog, the archive and the page for each tag have nearly the same layout. They allow us to browse previously published posts, but only the blog is paginated.

When you create a post, you can assign a featured image to it.
If you don't assign a featured image to a post, a fallback image will be displayed.
The default fallback image is a white camera on a black background like the following one:

Search page of Blog-Doc's front-end

You can change the default post preview fallback image from:
Admin ⚡→ Settings → Site → Post Preview Fallback Image

Information SVG The design of posts' card, in the default theme, is the work of Chyno Deluxe.

RSS feed

An RSS feed in automatically generated from the published posts.
To view the RSS feed, visit the /rss route.
To generate a correct RSS feed, input the correct address of your online site in:
Admin ⚡→ Settings → Site → Site URL

Information SVG The address of your live site, in the "Site URL" field, MUST end with a slash "/"

RSS feed's screenshot of Blog-Doc's demo in Vivaldi browser

RSS feed page of Blog-Doc's demo site

Sitemap

A sitemap is automatically generated, like the RSS feed.
To view the sitemap, visit the /sitemap route.
To generate a correct sitemap, input the correct address of your online site in:
Admin ⚡→ Settings → Site → Site URL

Information SVG The address of your live site, in the "Site URL" field, MUST end with a slash "/"

Blog-Doc's footer copyright can be modified from:
Admin ⚡→ Settings → Site → Footer Copyright

Information SVG IF YOU USE HTML IN THE FOOTER COPYRIGHT, ATTRIBUTES MUST BE SINGLE QUOTED! OTHERWISE BLOG-DOC WILL STOP WORKING!