Gitbook的注意事项和使用心得
折腾gitbook期间，也算踩过一些坑，总结了些经验，整理如下：
最新版本Gitbook的bug很多，以及没有命令行工具了
详见：
多章节的编号显示有问题
虽然开始好像是用插件支持了：
但是最终还是没法正常的实现自己要的 章节按照1，2，3去编号：
【部分解决】Gitbook中添加多章节且希望一级章节也显示编号
后来又去试了试：
【未解决】Gitbook中实现多章节中一级章节目录显示一级编号
虽然找到了别人为了解决次bug而去改动的gitbook的源码的位置，但是由于无法找到
此处Mac中用npm install gitbook后，应该去哪里找到对应的位置，所以此处还是无法解决问题。
调试时添加--log以便于看到详细的错误信息
在用serve去调试本地的gitbook时，有些细节和错误，比如markdown的插件中语法写错了，是不知道，也看不到错误信息的。
而想要看到，则需要添加--log的参数，可以输出详细的log日志信息，从而可以看出原因和细节。
比如，语法高亮插件中用的是prism，而markdown源码写了个md的语法：
```markdown
`Markup` : `markup`
```
时，结果log中即可看到错误信息：
gitbook serve /Users/crifan/GitBook/Library/Import/ebook_system_gitbook /Users/crifan/GitBook/Library/Import/ebook_system_gitbook/debug --log debug
...
debug: index page gitbook_plugins/code_highlight.md
Failed to load prism syntax: md
{ Error: Cannot find module 'prismjs/components/prism-md.js'
at Function.Module._resolveFilename (internal/modules/cjs/loader.js:594:15)
at Function.Module._load (internal/modules/cjs/loader.js:520:25)
at Module.require (internal/modules/cjs/loader.js:650:17)
at require (internal/modules/cjs/helpers.js:20:18)
at requireSyntax (/Users/crifan/GitBook/Library/Import/ebook_system_gitbook/node_modules/gitbook-plugin-prism/index.js:31:3)
at Object.code (/Users/crifan/GitBook/Library/Import/ebook_system_gitbook/node_modules/gitbook-plugin-prism/index.js:103:11)
at Record.TemplateBlock.applyBlock (/Users/crifan/.gitbook/versions/3.2.3/lib/models/templateBlock.js:205:23)
at /Users/crifan/.gitbook/versions/3.2.3/lib/output/getModifiers.js:56:33
at /Users/crifan/.gitbook/versions/3.2.3/lib/output/modifiers/highlightCode.js:47:24
at /Users/crifan/.gitbook/versions/3.2.3/lib/output/modifiers/editHTMLElement.js:11:16 code: 'MODULE_NOT_FOUND' }
如此，才真正知道自己写错了，然后才能想到，去参考prism官网，找到并修改为正确写法是：markdown：
```markdown
`Markup` : `markup`
```
即可解决错误，代码能真正的语法高亮：
代码中包含花括号
【已解决】Gitbook中Markdown的代码中如何包含左右花括号{}
代码块显示代码行号
不过gitbook中的prism插件暂时还没有直接支持行号显示：
【未解决】Gitbook中Markdown的代码段中如何添加行号)
跨页面引用和跳转
跨页面的话，貌似只能直接用链接地址了：
【已解决】gitbook如何实现book内部的跨页面的跳转或引用
后记：
已经实现了：
引用gitbook的root目录之外是不支持的
【未解决】gitbook中用markdown的include实现根目录外部的README.md文件内容同步
不过倒是可以通过:
{% include "../README.md" %}
去引入gitbook内部的其他的章节的。
左侧添加下载PDF按钮
没有完全实现，间接实现了类似效果：
【部分解决】给gitbook中左侧添加PDF及其他格式的下载按钮
调试时文件改动后页面刷新特别慢
详见：
gitbook中表格中无法嵌入code代码
详见：