创建你的第一本gitbook(windows系统)
gitbook的好处
gitbook是由Markdown文件生成的,可以保留Markdown的简洁舒适的排版,将大量的markdown笔记生成一个html页面,更适合查看,分享。
环境搭建
gitbook要在安装node.js的前提下才能运行。因为新版的gitbook不支持页面之间的跳转,很不方便,所以,我们暂且使用老版的node.js和gitbook。
需要安装的软件有:
node.js(6.16.0):https://nodejs.org/en/blog/release/v6.16.0/
如果电脑上有其他版本的node.js,可以下载安装nvm,然后再使用gitbook的时候进行node.js的版本切换即可。
gitbook(2.6.7):
下载了node.js后,在windows命令窗口执行以下指令:
npm install -g gitbook-cli
typro(markdown编辑工具)
创建第一本gitbook
首先创建一个文件夹,此处以test为例。
在文件夹内,创建一份markdown笔记。
打开windows命令行工具,切换到test文件夹目录下,执行命令:
gitbook init --gitbook=2.6.7
此时,文件夹内会多出两个文件:README.md和SUMMARY.md第一个文件可以理解为是书的简介,默认放在书的最前面。第二个文件是存储书的目录和各个章节的文件名称和地址的。向gitbook内部添加文件时,
然后添加在文件夹内添加你的笔记,修改SUMMARY.md,添加文件名称和路径,格式如下:
然后执行下面的命令:
gitbook build --gitbook=2.6.7
这时,我们发现文件内多了一个book文件夹,打开里面的index.html就可以看到我们自己写的gitbook了。
tips
目录中不能有同名文件。
文件名和目录中不能有小括号,会和路径的小括号冲突。
建议将文件夹同步到github或者云备份,以免文件被破环或者丢失。
如果有什么意见或者建议,欢迎在评论区指正。