最详细安装、使用gitbook教程

一、安装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就可以写书了。啦啦啦~

推荐阅读更多精彩内容