目录结构

Snow 站点的标准文件布局：

 1mysite/
 2├── config.yaml          # 站点配置
 3├── content/             # 内容目录（固定名）
 4│   ├── _index.md        # 根 Section
 5│   ├── about.md         # Page
 6│   └── posts/           # Section
 7│       ├── _index.md    # Section 内容
 8│       ├── hello.md     # Page
 9│       └── tutorials/   # 子 Section
10│           └── _index.md
11├── static/              # 静态文件（固定名，原样复制到输出）
12├── templates/           # 站点自定义模板（覆盖主题模板）
13├── themes/              # 主题目录（固定名）
14│   └── snow/            # 主题名称 = theme
15│       ├── theme.yaml
16│       ├── templates/
17│       ├── static/
18│       └── i18n/
19├── assets/              # 需启用 hooks.assets
20│   ├── js/
21│   ├── css/
22│   └── scss/
23└── i18n/                # 翻译文件
24    ├── en.yaml
25    └── zh.yaml

固定目录

核心目录 content、static、templates、themes 使用固定名称；扩展目录（如 assets、data、i18n）由各扩展按需读取。

如果需要把站点外部的文件或目录接入构建流程，可以使用 mount hook。

内容目录详解

识别规则

支持的内容扩展名、启用方式和解析细节见 解析器。

Page

普通文件（.md、.org、.html）即为 Page。输出路径由 pages.{type}.path 决定。

Section

包含 _index.* 的目录为 Section。Section 可嵌套形成层级结构。

Page Bundle

包含 index.{md,org,html} 的目录视为一个页面整体，目录内其他文件为附属资源。

忽略规则

• 以 _ 或 . 开头的文件/目录（_index.* 除外）
• ignored_content 匹配的内容

1ignored_content:
2  - "drafts/"
3  - "private/*"