Centos之GitBook文档工具安装与使用-yellowcong

我看了GitBook这个文档工具，用得都挺多的，而且看起来很简约，是很适合做文档工具的。GitBook的安装是依赖于nodejs的npm，所以需要将nodejs安装好，然后通过npm工具安装GitBook。然后本次还做了一GitBook的案例，直接就可以访问我的文档了，老爽了。

首先Gitbook和Git/Github都没有什么关系。它只是一个build book的工具而已。但它的Git前缀的确引起了许多人的迷惑，起初我认为至少它也是个和Github类似的Git平台吧，但其实没什么关系，你只要懂几条markdown语法，不必理解任何与Git相关的东西就能用Gitbook了，不要为其名字迷惑。

生成的文档效果图，看起来很漂亮吧

看我做的效果

Nodejs安装

#创建目录
mkdir -p /usl/local/nodejs && cd $_

#官方下载地址
wget https://nodejs.org/dist/v8.9.0/node-v8.9.0-linux-x64.tar.xz

#我的七牛地址
wget http://yellowcong.qiniudn.com/node-v8.9.0-linux-x64.tar.xz

#解压，这个是tar.xz文件，NMD,直接就是二进制的，加压后不需要编译就可以了
tar -xvf node-v8.9.0-linux-x64.tar.xz

#配置环境变量
vim /etc/profile

export NODEJS=/usl/local/nodejs/node-v8.9.0-linux-x64/bin
export PATH=$PATH:$JAVA_HOME/bin:$JRE_HOME/bin:$NODOEJS

#环境生效
source /etc/profile

#查看版本信息
npm -v 
node -v 

大家可以发现npm和npx是软连接的

环境变量配置

版本查看

GitBook安装

npm install gitbook -g

#想在系统上的任何地方的gitbook命令，需要安装“gitbook CLI”，执行以下命令
npm install gitbook-cli

#查看gitbook版本，注意：  V 是要大写的，小写不生效
gitbook -V

#开启端口,后面一个.表示的是当前文件夹
gitbook serve -p 8080 .

后面看到了gitbook版本3.2.3,就表示安装成功了

大家可以发现在nodejs的bin目录，发现了gitbook的命令

查看到的版本号

启动github服务

GitBook插件

插件没用到，所以不讲拉。。。。。。。又需要再说

GitBook Editor 使用

官方的最新版本不能使用Markdown语法编辑，所以不爽，我用的还是老版本。我用的是gitbook-editor-4.2.1的版本

#官网下载地址
https://www.gitbook.com/editor/

#我自己七牛云的下载地址（老版本4.2.1）
#window下解压安装，这个window程序安装，我就不用教你了吧
http://yellowcong.qiniudn.com/gitbook-editor-4.2.1-windows-ia32.zip

#这个是当前（2017/11）最新版7.x版本
http://yellowcong.qiniudn.com/GitBook.Editor.Setup.exe

登录到gitbook，这个玩意不能离线工作，必须在线操作，没有帐号的，自己注册一个

创建书

创建一本书

添加名称

创建完成后

目录结构说明

添加章节

新建文件和文件夹

添加文章的名称，后缀需要自己加上 .md,这样markdown才能打开

设置目录结构

目录结构需要和相应的文件对应上

下面是SUMMARY.md的代码，这个就是用来管理目录结构的

# 我爱打酱油系列

##第一章
* [1.1 我](第一章/chapter1.1.md)
* [1.2 爱](第一章/chapter1.2.md)

##第二章
* [2.1 打](第二章/chapter2.1.md)
* [2.2 酱油](第二章/chapter2.2.md)

发布到服务器上

1 上传到服务器

#xxx 是替换的路径，看你自己的用户了， Import目录，有我们自己建立的那个demo的所有文件
C:\Users\xxx\GitBook\Library\Import\demo

上传到服务器上，然后通过服务器上的gitlab启动服务

2 启动文档服务

必须到bin目录下面才能使用gitbook命令

#进入到这个目录，然后启动服务器
#必须在node的bin目录才能启动gitbook的命令

#启动gitbook服务器
gitbook serve -p 8080 /usl/local/nodejs/demo

大家可以看到，我指定的是8080端口，人家最后启动的是4000端口，我很无奈啊

看了一下后台，发现8080端口，它也在使用，这是想要闹哪样样啊

3 浏览器查看

注意，浏览器使用的地址的端口是4000端口，并不是8080端口

参考文章

Gitbook安装与使用教程 http://blog.csdn.net/feosun/article/details/72806825
Gitbook简易教程 https://segmentfault.com/a/1190000005859901
GitBook 简明教程 https://segmentfault.com/a/1190000004482449