一、安装node
去node官方网站 https://nodejs.org/en/#download 下载安装包、解压。
Snip20180523_1.png
跟着安装就行
image.png
终端执行
node -v
检查安装是否成功image.png
二、安装gitbook
sudo npm install -g gitbook-cli
提示有一个低级漏洞修复下
sudo npm i npm@latest -g
image.png
gitbook -v
查看下,提示实验性警告(我装的最新版,先忽略它)image.png
三、使用gitbook
1、建立书籍名称 (其下 README.md 和 SUMMARY.md两个主要文件)
mkdir rails_book
cd rails_book
touch README.md
touch SUMMARY.md
在 SUMMARY.md 中写入你的大致目录:
* [Chapter1](chapter1/README.md)
* [Section1.1](chapter1/section1.1.md)
* [Section1.2](chapter1/section1.2.md)
* [Chapter2](chapter2/README.md)
最后初始化gitbook gitbook init
image.png
2、开启服务,本地浏览
gitbook serve
浏览器打开:http://localhost:4000/
image.png
四、将github与gitbook关联起来
以下几步:
1.在github 上新建仓库,把我们刚刚创建的书(rails_book)上传到github上。此过程不赘述。
2.创建gitbook账号(利用github就可以登录)
3.在github中授权,gitbook 读取你的仓库
image.png
image.png
image.png
image.png
保存。
4.去gitbook从github仓库中创建书籍
image.png
image.png
保存后就可以看到你的书籍了。
PS:以后你就只需要git 推到github同步更新gitbook就可以写书了。啦啦啦~