博客概覽
本頁內容
博客模塊爲博客站點提供了基本的佈局和模板。
| 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.paginate | number | 9 | 每頁博文數量。 |
blog.post_date_format | string | :date_long | 博文日期格式。 |
blog.post_thumbnail | boolean | true | 是否顯示縮略圖。 |
blog.post_thumbnail_default | string | images/thumbnail.png | 相對於 assets 文件夾的默認縮略圖。 |
blog.post_thumbnail_placeholder | string | 站點標題 | 縮略圖佔位符。 |
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 | 是否於首頁顯示分類統計。 |
terms.paginate | number | 12 | 分類列表博文數量。 |
params.toml
1[hb]
2 [hb.blog]
3 full_width = false
4 paginate = 12
5 post_date_format = ':date_long'
6 post_thumbnail = true
7 post_thumbnail_default = 'images/thumbnail.png'
8 post_thumbnail_placeholder = ''
9 [hb.blog.archives]
10 paginate = 30
11 [hb.blog.home]
12 featured_posts = 5
13 main_sections = ['docs', 'blog']
14 taxonomies = true
15 [hb.terms]
16 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 paginate: 12
13 post_date_format: :date_long
14 post_thumbnail: true
15 post_thumbnail_default: images/thumbnail.png
16 post_thumbnail_placeholder: ""
17 terms:
18 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 "paginate": 12,
17 "post_date_format": ":date_long",
18 "post_thumbnail": true,
19 "post_thumbnail_default": "images/thumbnail.png",
20 "post_thumbnail_placeholder": ""
21 },
22 "terms": {
23 "paginate": 12
24 }
25 }
26}
頁面參數
| Name | Type | Default | Description |
|---|---|---|---|
comments | boolean | true | 是否顯示評論。 |
featured | boolean | false | 是否於首頁幻燈片中顯示該文章。 |
pinned | boolean | false | 是否於首頁置頂該文章。 |
歸檔
博客博客內置了文章歸檔佈局，其可以按年份和月份進行歸檔。你需要手動創建欄目以歸檔文章。
創建歸檔欄目
content/archives/_index.md
1---
2title: Archives
3---
創建按年歸檔欄目
以 archives/2023/ 爲例。
content/archives/2023/_index.md
1---
2title: 2023
3---
創建按月歸檔欄目
以 archives/2023/01/ 爲例。
content/archives/2023/01/_index.md
1---
2title: Jan
3---