配置

Snow 使用 YAML 格式配置，默认为站点根目录下的 config.yaml，可通过 --config 参数指定其他文件。

站点信息

目录

Snow 使用固定项目目录：content/、static/、templates/、themes/。这些目录名不可通过配置修改；主题名称仍通过 theme 配置选择，对应 themes/{theme}/。

内容处理

ignored_content 与 ignored_static 按相对路径匹配。以 _ 或 . 开头的内容文件默认忽略，_index.{md,org,html} 除外。

多环境 (Modes)

1base_url: "http://127.0.0.1:8000"
2
3modes:
4  publish:
5    base_url: "https://example.com"
6  develop:
7    debug: true
8    include: "develop.yaml"

通过 --mode publish 构建时，base_url 等配置会被覆盖。include 可引用外部文件合并配置。

语法高亮 (Markups)

 1markups:
 2  _default:
 3    style: "monokai"
 4    show_toc: true
 5    show_line_numbers: true
 6    prevent_pre_code: true
 7  markdown:
 8    enabled: true
 9    unsafe: false
10    directive_blocks: false
11  orgmode:
12    enabled: true
13  niklasfasching:
14    enabled: false
15  html:
16    enabled: true

常见样式：monokai、github、dracula、solarized-dark。

markups._default 为所有解析器提供默认渲染选项；markups.markdown、markups.orgmode、markups.niklasfasching、markups.html 可以分别覆盖。默认启用 Markdown 和 Org-mode，HTML 与 niklasfasching parser 已内置注册但默认未启用。解析器行为见 解析器。

输出格式 (Formats)

1formats:
2  rss:
3    template: "partials/rss.xml"
4  atom:
5    template: "partials/atom.xml"

每个内容类型可通过 formats.{name}.path 和 formats.{name}.template 覆盖默认值。

Section 配置

 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: ""

配置查找：sections.{目录名} → 父目录 → sections._default。

未设置或设为空字符串时，分页器会按输出路径类型选择默认值：pretty 路径使用 page/{number}/，ugly 路径使用 {name}{number}{extension}；详见 分页。

Page 配置

 1pages:
 2  _default:
 3    path: "{path:slug}/{slug}/"
 4  posts:
 5    path: "articles/{date:%Y}/{date:%m}/{slug}.html"
 6  pages:
 7    hidden: true
 8    template: "page.html"
 9  drafts:
10    draft: true

配置查找：pages.{目录名} → 父目录 → pages._default。

Path Style 配置

path_style 用于在路径变量解析后做统一后处理，可用于 Page、Section、Taxonomy 和 Taxonomy Term。可选值为 none、lower、slug、slug_unicode，也可以用逗号按顺序组合，例如 lower,slug。

Slugify 配置

1slugify:
2  lowercase: true
3  preserve_unicode: false
4  preserve_chars: ""

Slugify 配置用于 {slug}、{path:slug}、{title:slug}、{term:slug} 和 path_style: slug。默认会将 Unicode 字符转写为 ASCII，例如中文标题会生成类似 ni-hao-world 的 slug；如果希望保留中文等 Unicode 字符，可以设置 slugify.preserve_unicode: true。

Taxonomy 配置

 1taxonomies:
 2  _default:
 3    path: "{taxonomy}/"
 4    sort_by: "name"
 5    term:
 6      path: "{taxonomy}/{term:slug}/"
 7      sort_by: "date desc"
 8  tags:
 9  categories:
10  authors:

只需在 taxonomies 下列出名称即可启用。配置查找：taxonomies.{name}.{key} → taxonomies._default.{key}。

Hook 配置

默认启用 assets、encrypt、links、shortcode。其他内置 Hook 只设置默认权重，不会自动挂载：

weight 越小越先执行；权重相同时按 Hook 名称排序。如果显式配置 hooks.<name>.enabled: true，但对应 Hook 未注册，构建会返回错误。各 Hook 的具体配置见 插件。

多语言

1language: "zh"
2
3languages:
4  en:
5    translations: "i18n/en.yaml"
6  fr:
7    translations:
8      - id: "tags"
9        tr: "Tags"

每个语言可覆盖任何全局配置。

主题

1theme: "snow"