当前位置: 首页 > 文档资料 > GitBook 中文文档 >

目录结构

优质
小牛编辑
148浏览
2023-12-01

GitBook使用SUMMARY文件管理目录结构,文件支持Markdown和Asciidoc两种语法。 GitBook按照SUMMARY文件中的目录结构生成HTML。 如果你通过GitBook创建一本支持多语言文档,目录结构会稍微不同,具体可参考多语言环境。

一般GitBook目录如下:

.
├── book.json
├── README.md
├── SUMMARY.md
├── chapter-1/
|   ├── README.md
|   └── something.md
└── chapter-2/
    ├── README.md
    └── something.md

简单介绍每一项:

文件说明
book.json保存 配置文件数据(可选)
README.md简介 - 书籍的简单介绍(必填)
SUMMARY.md目录(参见目录管理)(可选)
GLOSSARY.md字段/注释 - 专业术语列表(参见词汇表)(可选)

静态文件

静态文件是在SUMMARY.md中未列出的文件。所有静态文件,包含图片、JS、CSS都会复制到对应目录下,

忽略的文件和文件夹

GitBook将读取.gitignore.bookignore.ignore文件,以获取要忽略的文件和文件夹的列表。被忽略的文件不会被上传到版本中。 这些文件中的格式遵循与.gitignore相同的约定:

#井号代表这是一行注释

#忽略文件test.md
test.md

#忽略目录“bin”中的所有内容
bin/*

以子目录的方式与项目集成

对于软件项目,可以使用子目录(如docs/)来存储项目的文档。您可以在book.json中通过配置选项告诉GitBook在那里找到根目录:

.
├── book.json
└── docs/
    ├── README.md
    └── SUMMARY.md

book.json 中的配置如下:

{
    "root": "./docs"
}