基于centos6构建私有gitbook平台

Posted 2020-07-28 南非波波

前言：

　　开源gitbook工具可以让你方便有效的管理自己的文章笔记、发布产品文档等。这里为了学习，基于centos系统构建一个私有的gitbook项目。与公有云gitbook平台相比，这里是简单的展示页面，后面可以进行相关的学习再更新此文章。

 

一、基础环境：参考链接：http://www.cnblogs.com/songqingbo/articles/5611532.html 

　　nodejs 

　　nginx

　　python2.7

　　npm  参考链接：快速切换npm源的开源工具--nrm

二、部署GitBook及calibre组件

　　1. 安装GitBook

$ npm install gitbook -g
$ npm install gitbook-cli -g

　　2.安装calibre

wget -nv -O- https://raw.githubusercontent.com/kovidgoyal/calibre/master/setup/linux-installer.py | python -c "import sys; main=lambda x:sys.stderr.write(\'Download failed\\n\'); exec(sys.stdin.read()); main(\'/usr/local\')"

　　命令的最后 main(\'/usr/local\') 中/usr/local 为Calibre的安装目录，可根据需要修改。该步骤下载时间比较漫长，根据网络环境决定安装速度。

三、初始化demo

$ cd /var/www/html
$ mkdir gitbook
$ cd gitbook/
$ mkdir demo
$ cd demo/
$ gitbook init

　　执行最后一个命令之后会在 /var/www/html/gitbook/demo/ 下生成 README.md 和 SUMMARY.md 两个文件，可以将Gitbook-editer客户端编写的文档文件上传到该目录下面。

四、生成HTML以及其他格式的文件

1.生成完整的静态 HTML：

$ cd /var/www/html/gitbook/demo/
$ gitbook build

　　会在/var/www/html/gitbook/demo/ 目录下生成 _book 目录，即为完整的HTML静态网站。使用nginx配置路径到/var/www/html/gitbook/demo/_book，即可通过页面进行访问

2.生成其他格式的文件 

　　安装gitbook-pdf插件

1.手动安装phantomjs，直接通过npm下载安装会失败
淘宝镜像源下载地址：https://npm.taobao.org/dist/phantomjs/
这里以phantomjs-1.9.7-linux-x86_64.tar.bz2为例：
wget https://npm.taobao.org/mirrors/phantomjs/phantomjs-1.9.7-linux-x86_64.tar.bz2
tar xf phantomjs-1.9.7-linux-x86_64.tar.bz2 -C /usr/local/
#vim /etc/profile.d/phantomjs.sh
export PATH=$PATH:/usr/local/phantomjs-1.9.7-linux-x86_64/bin

source  /etc/profile

2. npm install gitbook-pdf -g

先切换到项目的目录下：比如本机的/home/gitbook/

PDF: 在执行这个命令的时候会报错，主要gcc版本比较低造成的，升级gcc参考文档：https://blog.csdn.net/rbpicsdn/article/details/79565383 

gitbook pdf ./demo ./demo.pdf

ePub:

gitbook epub ./demo ./demo.epub

MOBI:

gitbook mobi ./demo ./demo.mobi

注：需要提前安装Calibre，Gitbook会使用其中的ebook-convert功能组件来完成书籍格式的转换。