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