附件资源 (Assets)

Page Bundle 和 Section 都可以声明附件资源。附件会从固定的 content/ 目录中读取，并在构建时复制到对应页面或栏目的输出目录。

Page Bundle 附件

包含 index.{md,org,html} 的目录视为 Page Bundle。目录内除 index.* 之外的文件都可以作为页面附件：

1content/
2└── posts/
3    └── hello/
4        ├── index.md
5        ├── image.png
6        └── gallery/
7            └── cover.png

如果页面没有配置 assets，Snow 会收集 Page Bundle 内的全部附件。

1---
2title: "Hello"
3---

如果配置了 assets，则只收集匹配到的附件：

1---
2title: "Hello"
3assets:
4  - image.png
5  - gallery/**/*.png
6---

assets 支持 glob 匹配，匹配规则使用 doublestar。

Section 附件

Section 附件在 _index.{md,org,html} 的 FrontMatter 中声明：

1---
2title: "Blog"
3assets:
4  - cover.png
5  - media/**/*.png
6---

Section 不会默认收集目录内所有文件；只有 assets 中匹配到的文件会被复制。

路径规则

assets 中的路径必须是相对当前 Page Bundle 或 Section 目录的干净路径：

• 不能是绝对路径
• 不能以 ./ 开头
• 不能包含 ../
• 不能包含会回退到上级目录或需要重新整理的路径片段

合法示例：

1assets:
2  - image.png
3  - media/cover.png
4  - gallery/**/*.jpg

非法示例：

1assets:
2  - /image.png
3  - ./image.png
4  - ../image.png
5  - media/../image.png

输出位置

附件会根据 Page 或 Section 最终的 Path 输出。

如果 Path 以 / 结尾，附件会输出到该目录下：

如果 Path 是具体 HTML 文件，附件会输出到该 HTML 文件所在目录：

子目录结构会保留，只有 Page 或 Section 的输出基准目录会变化。

模板变量

附件会挂载到 page.Assets 或 section.Assets：

示例：

1{% for asset in page.Assets %}
2  <a href="{{ asset.Permalink }}">{{ asset.File.Name }}</a>
3{% endfor %}