3. 详细说明
3.1 编写 README and SUMMARY
此文件为章节目录设置文件,如果我们想为我们的创作添加章节目录,我们可以利用 Sumary.md 文件进行章节目录划分,此文件的书写格式也比较简单,例如:
3.1.1 README.md
这个文件相对于是一本 Gitbook 的简介,比如我们这本书的 README.md :
3.1.2 SUMMARY.md
这个文件相对于是一本书的目录结构。比如我们这本书的 SUMMARY.md
:
SUMMARY.md
基本上是列表加链接的语法。链接中可以使用目录,也可以使用。
3.2 本地预览
3.2.1 gitbook init
在预览之前,还需要做一步操作。
当 README.md、SUMMARY.md 创建完毕之后,我们可以使用 Gitbook 的命令行工具将这个目目录结构生成相应地目录及文件
我们可以看到,gitbook 给我们生成了与 SUMMARY.md
所对应的目录及文件。
每个目录中,都有一个 README.md
文件,用于描述这一章的说明。
3.2.2 gitbook serve
接下来,我们使用
我的操作,启动服务,进行预览:
启动完之后,浏览器输入:http://localhost:4000
注意:
可以事先创建好文章目录,通过执行 gitbook init 自动生成对应的文件,然后在 gitbook serve。