添加章节

加入新章节

在testbook下新建3个文件,然后修改 SUMMARY.md,内容如下:

  1. # Summary
  2. * [A](a.md)
  3. * [B](b.md)
  4. * [C](c.md)

此时看到的内容如下:

添加新章节 - 图1

左侧导航栏中会列出当前所有的章节,方便跳转。

下面红框中的这个按钮可以关闭/打开左侧的导航栏:

添加新章节 - 图2

导航栏层次

gitbook默认支持导航栏的层次结构:

  1. # Summary
  2. * [A](a.md)
  3. * [A1](a1.md)
  4. * [A2](a2.md)
  5. * [B](b.md)
  6. * [C](c.md)

子章节只需要缩进一个 TAB 就可以了。

效果如下:

添加新章节 - 图3

多级导航栏

老版本的gitbook默认只支持两层的导航栏,在遇到内容比较多而需要章节层次比较深时,很不方便。

好在后来新版本的gitbook终于提供了多级导航栏的支持,方式和前面一致,继续 TAB 缩进就是:

  1. # Summary
  2. * [A](a.md)
  3. * [A1](a1.md)
  4. * [A1-1](a1-1.md)
  5. * [A1-1-1](a1-1-1.md)
  6. * [A2](a2.md)
  7. * [B](b.md)
  8. * [C](c.md)

多级导航栏的效果如下:

添加新章节 - 图4

注: 之前的gitbook版本为了支持 多级导航栏,需要将第一行从 “# Summary” 修改为 “bui# Summary”,最新的版本不需要了

使用目录管理

当章节较多时,如果都放在根目录下,难于查找和管理。

gitbook支持目录,可以将不同内容放在不同的目录下,然后修改 SUMMARY.md ,将路径加入即可。

下面例子中将所有的 *.md 文件分别存放在 a/b/c 三个子目录中:

  1. # Summary
  2. * [A](a/a.md)
  3. * [A1](a/a1.md)
  4. * [A1-1](a/a1-1.md)
  5. * [A1-1-1](a/a1-1-1.md)
  6. * [A2](a/a2.md)
  7. * [B](b/b.md)
  8. * [C](c/c.md)

注意:每个文件的目录都必须完整,多层结构中路径是不会自动继承上级目录的路径的。

导航栏占位符

某些情况下,当章节内容还没有开始编写,也不想放置一个空文件时,可以使用类似占位符的方式先占据导航栏的位置。

此时只需要将文件路径设置为空即可,如下面的D:

  1. # Summary
  2. * [A](a/a.md)
  3. * [A1](a/a1.md)
  4. * [A1-1](a/a1-1.md)
  5. * [A1-1-1](a/a1-1-1.md)
  6. * [A2](a/a2.md)
  7. * [B](b/b.md)
  8. * [D]()