GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书,目前gitbook可以支持生成静态html和pdf文档
安装使用
首先你需要安装node.js的环境,然后便可以使用npm脚手架工具下载安装gitbook工具
npm install gitbook-cli -g
或者使用cnpm淘宝的镜像源
cnpm install gitbook-cli -g
安装成功后,新建一个文件夹,此处为了方便演示,我们新建mybook文件夹
接着开始初始化gitbook项目
gitbook init
初始化成功后,可以看到目录中生成了两个文件
其中SUMMARY.md是目录文档,我们使用notepad++或者记事本打开
此时,gitbook默认生成了一个标题叫Introduction的目录,对应的文档是README.md。在这里为了达到演示效果,新建一个文档
取名字叫content_01,然后使用记事本或notepad++打开编辑
同时编辑SUMMARY.md文件,添加如下内容
保存后,在命令提示符中输入
gitbook serve
在浏览器中打开此地址,即可看到生成的文档
选择“第一章”标题,查看一下生成的文档内容
是不是很到玩呢?哈哈,如果有的小伙伴问二级目录该怎么生成呢?很简单,只需要在目录前加一个空格即可
运行效果如下:
最后,如果想生成html,放在服务器上运行,怎么办?
gitbook build
此时,项目目录下会生成_book文件夹,此文件夹中就是我们想要的html文件
打开_book文件夹
当然,此时若直接打开index.html文件是无法直接运行的,我们需要给它一个web环境,可以在本地启动一个tomcat也可以启动一个IIS,直接将_book文件夹中的内容丢进去即可