前言:
开源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 '); 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功能组件来完成书籍格式的转换。