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操作

原文地址:https://www.cnblogs.com/wzl0916/p/13691625.html