文档页
YDoc 借鉴了 Gitbook 中 "书"
的概念:
- YDoc 的每个导航项都是不同的
"书"
- 每本
"书"
都是由目录和页面组成 - YDoc 文档站就是由若干本书及其他页面组成的网站
使用 SUMMARY.md 文件生成一本书的目录,SUMMARY 文件包含了一本书的所有章节信息,具体的文档页面一般是若干 markdown 文件,如果你不知道 markdown 是什么,可以查看本文档中 markdown 的介绍
SUMMARY.md 由一组链接列表组成,将一个列表嵌套到父章节将创建子章节,简单示例如下:
# 目录
### 章节 1
* [快速开始](start.md)
* [安装](installation.md)
* [项目设置](setting.md)
* [配置文件](config.md)
锚点
目录中的章节可以使用锚点指向文件的特定部分。
# 目录
### 章节 2
* [API](api.md)
* [a](api.md#anchor1)
* [b](api.md#anchor2)
章节
目录可以分为多个部分,如下所示:
# 目录
### 章节 1
* [快速开始](start.md)
* [安装](installation.md)
* [项目设置](setting.md)
* [配置文件](config.md)
### 章节 2
* [API](api.md)
* [a](api.md#a)
* [b](api.md#b)