用GitBook搭建文档系统

通过MarkDown写文档，自动生成html在线文档，还可以实时预览，这一切可以通过gitbook来进行。

1.安装node.js  windows版本

2.打开cmd输入下面的命令以安装gitbook 

 npm install -g gitbook-cli

 3.随便新建一个文件夹打开cmd，输入

 gitbook init

生成如下图

 

4.输入以下命令，gitbook以供浏览器查看

 gitbook serve

5.打开浏览器 127.0.0.1:4000

至此gitbook环境搭建完毕。

 

在gitbook的目录新建 book.json 输入以下内容

{
	"title": "用户手册",
	"plugins": ["hide-element","chapter-fold"],
	"pluginsConfig": {
		"chapter-fold": {},
		"hide-element": {
			"elements": [".gitbook-link"]
		}
	}
}

上面的设置包含了2个插件，一个是去掉logo，一个是折叠菜单。

 

打开命令行输入以下命令

 gitbook install

 

输入以下命令 生成html页面，生成的html文件位于当前的额_book目录zhong

 gitbook build

 

至此，可以通过MD编写文档了。