gitbook安装部署

1、gitbook介绍

GitBook是一个命令行工具（和Node.js库），用于使用GitHub / Git和Markdown（或AsciiDoc）构建精美的书籍；gitbook 的默认语法就是markdown，能够很好的展现你的内容，并且排版都不需要你担心，在此基础上，会自动生成目录、父子级、划分列表，让你把所有的精力都放在内容，还可以直接部署在互联网上；markdown文件的格式为.md，可通过文本编辑器直接打开和编辑，常用Typora软件来编辑；

Typora下载地址：https://www.typora.io/

2、gitbook linux环境安装部署

2.1、nodejs安装部署
1）下载
wget http://cdn.npm.taobao.org/dist/node/v10.16.0/node-v10.16.0-linux-x64.tar.xz
2）解压
tar -xvf node-v10.16.0-linux-x64.tar.xz
3）重命名
mv node-v10.16.0-linux-x64 nodejs
4)移动到/usr/local目录
mv nodejs /usr/local
5)建立软链接(为node和npm建立软链接，确保node和npm命令能直接使用）
ln -s /usr/local/nodejs/bin/node /usr/bin/node
ln -s /usr/local/nodejs/bin/npm /usr/bin/npm
6）安装验证
node -v
成功安装可显示nodejs版本号；

 

2.2、gitbook安装
1）安装gitbook-cli
npm install gitbook-cli -g
2）建立软链接（为gitbook建立软链接）
ln -s /usr/local/nodejs/bin/gitbook /usr/bin/gitbook
3）安装验证
gitbook -V
安装成功，输出gitbook版本号；

 

2.3、gitbook初始化编译启动

1）新建目录gitbook，用于存放gitbook文件

mkdir gitbook

2）初始化gitbook

进入gitbook目录，执行初始化命令：

gitbook init

执行结果：

warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
info: initialization is finished

自动在gitbook目录下生成README.md文件和SUMMARY.md文件；

3）启动gitbook

执行启动命令：

gitbook serve

gitbook启动后，会生成浏览器访问的地址，可通过浏览器访问gitbook内容，默认为：http://localhost:4000

 

2.4、浏览器访问gitbook

在浏览器输入地址：http://localhost:4000，localhost可更改为服务器的IP地址，下面为添加相关目录后显示的内容；

 

gitbook相关操作，详见下一篇：gitboo操作