结构

文件夹里的每个 .md 文件都会变成一个页面，每个子文件夹变成一个栏目。不需要任何配置——在 moss 中打开文件夹，网站结构已经成型。

文件夹树 = 网站树#

moss 将文件夹结构直接映射为 URL 结构。work/farewell.md 发布后的地址是 /work/farewell/。文件夹变成站点栏目，导航、面包屑和固定链接都随文件系统而定。新建一个文件夹就是新建一个栏目，文件夹嵌套即页面嵌套。

站点树示例及对应 URL：

work/
├── index.md            →  /work/
├── farewell.md         →  /work/farewell/
└── daowu/
    ├── index.md        →  /work/daowu/
    └── gallery.md      →  /work/daowu/gallery/
about.md                →  /about/
index.md                →  /

面包屑遵循同一层级结构——在首页设置 breadcrumb: true，每个页面都会自动生成面包屑导航（首页 / 作品 / 再见），无需手动编写面包屑块。

排除的文件夹#

以下文件夹名称保留给静态资源，不会被当作内容处理：

assets/、images/、static/、public/、img/、css/、js/、fonts/、node_modules/

名称以 .（点）或 _（下划线）开头的文件夹也会被排除。

这些文件夹中的文件会原样对外提供，但不会生成页面或栏目。将图片放在这里，用 ![[文件名.ext]] wikilink 引用——无论源页面在哪，moss 都能解析。

文件夹页面#

文件夹中的 index.md 就是该文件夹的页面。访问文件夹的 URL 时，看到的就是它。

moss 依次识别以下文件名作为文件夹页面：

1. index.md
2. readme.md
3. _index.md
4. main.md

不区分大小写：README.md、Index.md、MAIN.md 都可以。

与父文件夹同名的文件也会被视为文件夹页面：

recipes/
├── recipes.md   ← 文件夹页面（与文件夹同名）
├── pasta.md
└── soup.md

如果文件夹中没有 index.md，moss 会自动生成一个栏目页，列出文件夹中的所有内容。

根文件夹的 index.md 就是你的首页——网站的封面。

my-site/
├── index.md        ← 首页
├── about.md
└── posts/
    ├── index.md    ← /posts/ 的栏目页
    ├── hello.md
    └── world.md

URL#

文件路径决定页面的 URL。moss 去掉文件扩展名，加上尾部斜线，生成干净的 URL：

在 frontmatter 中用 url 字段可以自定义任意页面的 URL：

---
title: Hello World
url: /blog/2024/hello/
---

可见性#

页面有三种可见性级别：

在 frontmatter 中设置：

---
title: 正在撰写
draft: true
---

文件夹名以 _ 开头则完全排除在处理之外：

my-site/
├── _drafts/      ← moss 忽略
├── _templates/   ← moss 忽略
└── posts/        ← 正常处理

排序#

在任意栏目中，内容按以下规则排列：

1. 子文件夹在前，按字母排序
2. 有 date 的文件，最新的排在前面
3. 没有 date 的文件，按字母排序

用 weight 覆盖默认排序——数值越小越靠前，优先级高于日期排序：

---
title: 置顶文章
weight: 1
---

导航#

网站根目录的页面会自动出现在顶部导航栏。用两个 frontmatter 字段控制：

---
title: 关于
nav: true       # 显示在导航栏（根目录页面默认为 true）
weight: 2       # 导航中的位置（数值越小越靠左）
---

不想显示在导航中：

---
title: 隐藏页面
nav: false
---

根目录的文件夹，只要 index.md 设了标题，就会作为导航项出现。