栏目 (Section)

Section 是组织 Pages 的树状层级结构。包含 _index.{md,org,html} 文件的目录即为 Section。支持的扩展名和启用方式见 解析器。

目录示例

1content/
2├── _index.md              # 根 Section → /
3└── posts/
4    ├── _index.md          # Section → /posts/
5    ├── article1.md        # → /posts/article1/
6    └── tutorials/         # 子 Section → /posts/tutorials/
7        ├── _index.md
8        └── intro.md       # → /posts/tutorials/intro/

Section FrontMatter

_index.md 中的 FrontMatter 控制 Section 行为：

1---
2title: "文章列表"
3sort_by: "date desc"
4paginate: 10
5template: "custom-section.html"
6---
7这是 Section 描述内容，在模板中通过 `section.Content` 呈现。

FrontMatter 字段

注意：title 留空时自动取目录名，根 Section 默认为 index。assets 字段用于声明栏目附属资源，详见 附件资源。

配置

 1sections:
 2  _default:
 3    path: "{path:slug}/"
 4    sort_by: "date desc"
 5    paginate: 0
 6  posts:
 7    sort_by: "date desc"
 8    paginate: 5
 9    template: "custom.html"
10  pages:
11    path: ""

Section 类型由目录名确定（如 posts、pages、tutorials）。配置级联查找：

1. sections.{目录路径} — 如 posts/tutorials
2. 父目录 — 如 posts
3. sections._default

paginate_path 未设置或为空字符串时会按 Section 输出路径类型选择默认值；分页路径变量和模板对象见 分页。

路径变量

path 支持的占位符：

排序

sort_by 支持多字段逗号分隔：

1sort_by: "date desc, title asc"

可用字段：date（创建时间）、modified（修改时间）、title、weight，以及任意 FrontMatter 字段。

模板查找

渲染 Section 时模板按顺序查找：

1. FrontMatter 中的 template 值
2. section.html
3. 根 Section (_index.md 位于 content/ 根目录) 额外尝试 index.html

过滤表达式

1paginate_filter_by: "'emacs' in tags and not draft"

表达式中的字段为 Page 的 FrontMatter 值。

模板变量

常用关联对象字段：