统计
  • 文章总数:76 篇
  • 评论总数:18 条
  • 分类总数:19 个
  • 最后更新:10月18日

Linux安装gitbook

本文阅读 4 分钟
首页 运维 正文

GitBook是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书

下载node


wget https://nodejs.org/dist/v12.16.1/node-v12.16.1-linux-x64.tar.xz

解压到指定目录

tar -xJf node-v12.16.1-linux-x64.tar.xz -C /usr/local/lib/

cd /usr/local/lib

mv node-v12.16.1-linux-x64/ nodejs

修改环境变量

export PATH=/usr/local/lib/nodejs/bin:$PATH

source /etc/profile

测试是否有npm命令,输入nup -V查看npm的版本

安装gitbook

npm install -g gitbook-cli

这时需要输入gitbook --version查看gitbook版本,输入完成后会自动安装Gitbook

文档初始化

mkdir /book

进入目录

cd /book

初始化文档

gitbook init

这时gitbook会初始化文档目录,在该目录下创建README.md和SUMMARY.md文件

README.md就是文档的说明文档,SUMMARY就是文档目录

之后的内容就是用markdown格式写文档,并且索引到目录内

生成网页

完成书籍或者文档后需要生成html网页,这时在文档目录下输入

gitbook build

这时候Gitbook会生成网页,存放在 _book 目录下

运行gitbook
在该目录下执行

gitbook serve

服务器会自动启动,需要注意的是,Gitbook访问端口是4000,需要开放4000端口。

配置域名和反向代理

这里可以按需配置,其实还有直接解析到端口的方案,但是为了简单我的方案是解析到服务器,再由Nginx反向代理到4000端口

我的方案的简单因为我是宝塔环境,几乎零代码执行的,具体的可以网上看相关教程,这里就不多赘述了。

踩坑&解决方案
无法安装
第一次在ubuntu上安装的时候死活安装不上,一直提示gitbook command not found

解决:安装Node和Gitbook的时候没有配置环境变量

bash故障
这其实算是我的一个失误,由于之前我在服务器上的一些骚操作,我的bash库损坏了,后来是清楚了缓存重装了一堆东西解决的

ssh连接
因为我是ssh连接的gitbook serve,所以只要ssh已断开服务器就会停止

解决:安装screen进程守护,在screen下操作gitbook

ps:这个操作是我之前搭建MC服务器的时候积累的经验 

显示占用端口

这里分几种情况,第一种情况就是由应用占用端口,kill掉就行了。

第二种情况就是你有多个gitbook serve,你启动的gitbook与其它已启动的服务端口冲突了,这时需要手动配置端口

启动第一个gitbook实例:

gitbook serve --port=4000 --lrport=4100

启动第二个gitbook实例:

gitbook serve --port=4001 --lrport=4101

这样多个gitbook示例就不会冲突了

Gitbook 卸载删除

npm uninstall -g gitbook
npm uninstall -g gitbook-cli
npm cache clean -f

环境变量问题

1、npm config get prefix 查询npm全局安装的路径
2、获取bin目录完整路径,如 /usr/local/Cellar/node/12.5.0/bin
3、设置环境变量 export PATH=$PATH:/usr/local/Cellar/node/12.5.0/bin
4、再次运行 gitbook -v

如若转载请注明出处:
-- 展开阅读全文 --
laravel清除缓存命令
« 上一篇 08-18
Linux Centos安装FFMPEG
下一篇 » 08-20

发表评论

发表评论