Gitbook 编辑

本章节将和大家说明如何使用 Gitbook 在我们私有文档服务器上添加一本书,并且如何编辑、保存 并发布此书。23

Git简介

Gitbook 是结合 Git 和 Markdown 来进行编排文本的服务软件,此服务已经在我司文档服务器中安装。

这里我对 Gitbook 的文件系统进行一个简短的介绍,在Gitbook 书籍的根目录下,一般有有三个文件:

book.json --书籍生成配置json字符串,可以配置书籍语言、格式等,以及生成书籍时的插件及其配置
SUMMARY.md --书籍的目录结构,支持子级目录
README.md --可选,一般作为书籍的总览

其余的目录结构可以自行根据书籍的章节进行编排,书籍内容文件使用标准的 Markdown 语法进行编写,并在SUMMARY.md 中进行关联。

本书的book.json内容如下:

{
 "language": "zh",
 "plugins":["tree"] 
}

本书的目录结构如下,给大家做个参考:

对应到SUMMARY.md 中 如下: