博客概览

2023年3月31日 3 分钟阅读模块文档博客

本页内容

赞助

博客模块为博客站点提供了基本的布局和模板。

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.

站点参数

Parameter	Type	Default	Description
~~`blog.full_width`~~	boolean	`false`	是否全宽。
`blog.list_cols_md`	number	`2`	于 `md` 断点下，列表每行的文章数目。
`blog.list_cols_lg`	number	`3`	于 `lg` 断点下，列表每行的文章数目。
`blog.paginate`	number	`9`	每页博文数量。
`blog.post_date_format`	string	`:date_long`	博文日期格式。
`blog.post_read_more`	boolean	`true`	是否显示阅读更多按钮。
`blog.post_thumbnail`	boolean	`true`	是否显示缩略图。
`blog.post_thumbnail_default`	string	`images/thumbnail.png`	相对于 `assets` 文件夹的默认缩略图。
`blog.post_thumbnail_height`	string	`160px`	缩略图高度。
`blog.post_thumbnail_placeholder`	string	站点标题	缩略图占位符。
`blog.post_thumbnail_position`	string	`top`	缩略图的位置，`start` 或 `top`。
`blog.post_thumbnail_resize_height`	string	`360`	缩略图缩放的高度。
`blog.archives`	object		归档设置。
`blog.archives.paginate`	number	`30`	归档每页博文数量。
`blog.home`	object		博客首页设置。
`blog.home.featured_posts`	number	`10`	特刊博文数量。
`blog.home.main_sections`	array	-	博文栏目，默认所有栏目。
`blog.home.pinned_posts_position`	string	幻灯片右侧	置顶文章的位置，可选项：`list`。
`blog.home.taxonomies`	boolean	`true`	是否于首页显示分类统计。
`blog.toc.position`	string	`end`	`start`：内容左侧、`end`：内容右侧、`content`：内容上方。
`blog.list_style`	string	-	空字符串、`minimalist`、`cascade`。
`terms.list_style`	string	-	空字符串、`minimalist`、`cascade`。
`terms.paginate`	number	`12`	分类列表博文数量。
`terms.profile`	boolean	`true`	为 `false` 时，隐藏简介。
`terms.profile_metrics`	boolean	`true`	为 `false` 时，隐藏简介上的指标。

params.toml

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

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    list_style: ""
15    paginate: 12
16    post_date_format: :date_long
17    post_thumbnail: true
18    post_thumbnail_default: images/thumbnail.png
19    post_thumbnail_placeholder: ""
20    post_thumbnail_position: top
21    toc:
22      position: end
23  terms:
24    list_style: ""
25    paginate: 12
26    profile: true
27    profile_metrics: true

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         "list_style": "",
19         "paginate": 12,
20         "post_date_format": ":date_long",
21         "post_thumbnail": true,
22         "post_thumbnail_default": "images/thumbnail.png",
23         "post_thumbnail_placeholder": "",
24         "post_thumbnail_position": "top",
25         "toc": {
26            "position": "end"
27         }
28      },
29      "terms": {
30         "list_style": "",
31         "paginate": 12,
32         "profile": true,
33         "profile_metrics": true
34      }
35   }
36}

页面参数

Name	Type	Default	Description
`comments`	boolean	`true`	是否显示评论。
`external_url`	string	-	外部文章 URL。
`featured`	boolean	`false`	是否于首页幻灯片中显示该文章。
`pinned`	boolean	`false`	是否于首页置顶该文章。
`toc`	boolean	`true`	是否显示文章目录。
`meta`	boolean/object	`true`	为 `false` 时，禁用所有元信息。
`meta.authors`	boolean	`true`	为 `false` 时，禁用作者元信息。
`meta.date`	boolean	`true`	为 `false` 时，禁用日期元信息。
`meta.reading_time`	boolean	`true`	为 `false` 时，禁用阅读时长元信息。
`meta.taxonomies`	boolean	`true`	为 `false` 时，禁用专栏、分类和标签元信息。
`meta.first_section`	boolean	`true`	是否显示文章的根栏目。