Blog Overview

March 31, 2023 3 min read Modules Docs Blog

On this page

Donate

The blog module provides the basic layouts and templates for blog site.

Module	`github.com/hbstack/blog`
Repository	⭐ Please consider giving a star if your like it.
Stars
Version
Used by
Requirements
License
Usage	See how to use modules.

Site Parameters

Parameter	Type	Default	Description
~~`blog.full_width`~~	boolean	`false`	Whether take full width.
`blog.list_cols_md`	number	`2`	The number of posts per list row on `md` breakpoint.
`blog.list_cols_lg`	number	`3`	The number of posts per list row on `lg` breakpoint.
`blog.paginate`	number	`9`	How many posts per list page.
`blog.post_date_format`	string	`:date_long`	The date format.
`blog.post_thumbnail`	boolean	`true`	Whether to display thumbnail.
`blog.post_thumbnail_default`	string	`images/thumbnail.png`	The default thumbnail image relative to `assets` folder.
`blog.post_thumbnail_placeholder`	string	Site’s title	The thumbnail placeholder.
`blog.post_thumbnail_position`	string	`top`	The position of thumbnail, `start` or `top`.
`blog.archives`	object		Archives settings.
`blog.archives.paginate`	number	`30`	How many posts per page.
`blog.home`	object		Homepage settings.
`blog.home.featured_posts`	number	`10`	The number of featured posts.
`blog.home.main_sections`	array	-	The main sections of posts, default to ALL.
`blog.home.pinned_posts_position`	string	Next to carousel	The position of pinned posts, available options: `list`.
`blog.home.taxonomies`	boolean	`true`	Whether to show the taxonomies stat on home page.
`blog.toc.position`	string	`end`	`start`: on the left of content, `end`: on the right of content, `content`: above the content.
`terms.paginate`	number	`12`	The number of posts per term list page.

params.toml

 1[hb]
 2  [hb.blog]
 3    full_width = false
 4    list_cols_lg = 3
 5    list_cols_md = 2
 6    paginate = 12
 7    post_date_format = ':date_long'
 8    post_thumbnail = true
 9    post_thumbnail_default = 'images/thumbnail.png'
10    post_thumbnail_placeholder = ''
11    post_thumbnail_position = 'top'
12    [hb.blog.archives]
13      paginate = 30
14    [hb.blog.home]
15      featured_posts = 5
16      main_sections = ['docs', 'blog']
17      taxonomies = true
18    [hb.blog.toc]
19      position = 'end'
20  [hb.terms]
21    paginate = 12

params.yaml

 1hb:
 2  blog:
 3    archives:
 4      paginate: 30
 5    full_width: false
 6    home:
 7      featured_posts: 5
 8      main_sections:
 9      - docs
10      - blog
11      taxonomies: true
12    list_cols_lg: 3
13    list_cols_md: 2
14    paginate: 12
15    post_date_format: :date_long
16    post_thumbnail: true
17    post_thumbnail_default: images/thumbnail.png
18    post_thumbnail_placeholder: ""
19    post_thumbnail_position: top
20    toc:
21      position: end
22  terms:
23    paginate: 12

params.json

 1{
 2   "hb": {
 3      "blog": {
 4         "archives": {
 5            "paginate": 30
 6         },
 7         "full_width": false,
 8         "home": {
 9            "featured_posts": 5,
10            "main_sections": [
11               "docs",
12               "blog"
13            ],
14            "taxonomies": true
15         },
16         "list_cols_lg": 3,
17         "list_cols_md": 2,
18         "paginate": 12,
19         "post_date_format": ":date_long",
20         "post_thumbnail": true,
21         "post_thumbnail_default": "images/thumbnail.png",
22         "post_thumbnail_placeholder": "",
23         "post_thumbnail_position": "top",
24         "toc": {
25            "position": "end"
26         }
27      },
28      "terms": {
29         "paginate": 12
30      }
31   }
32}

Page Parameters

Name	Type	Default	Description
`comments`	boolean	`true`	Whether to display comments.
`external_url`	string	-	External post URL.
`featured`	boolean	`false`	Whether to display the post on homepage carousel.
`pinned`	boolean	`false`	Whether to pin the post next to the carousel.
`toc`	boolean	`true`	Whether to show the ToC (Table of Contents).
`meta`	boolean/object	`true`	When `false` then disable all meta.
`meta.authors`	boolean	`true`	When `false` then disable the authors meta.
`meta.date`	boolean	`true`	When `false` then disable the date meta.
`meta.reading_time`	boolean	`true`	When `false` then disable the reading time meta.
`meta.taxonomies`	boolean	`true`	When `false` then disable the taxonimies meta: series, categories and tags.

Browse Modules

Blog Overview

Site Parameters

Page Parameters

Archives

Create Archives Section

Create Archives Section for Year

Create Archives Section for Month