创建你的第一本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(windows系统)

然后执行下面的命令:

gitbook build --gitbook=2.6.7

这时,我们发现文件内多了一个book文件夹,打开里面的index.html就可以看到我们自己写的gitbook了。
# 创建你的第一本gitbook(windows系统)

tips

目录中不能有同名文件。

文件名和目录中不能有小括号,会和路径的小括号冲突。

建议将文件夹同步到github或者云备份,以免文件被破环或者丢失。

如果有什么意见或者建议,欢迎在评论区指正。

相关文章:

  • 2021-10-14
  • 2021-12-22
  • 2022-12-23
  • 2021-11-30
  • 2022-01-01
  • 2021-06-03
  • 2022-02-19
猜你喜欢
  • 2021-09-23
  • 2021-08-16
  • 2021-10-20
  • 2021-05-15
  • 2021-09-17
  • 2021-04-17
  • 2022-12-23
相关资源
相似解决方案