前言:
開源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功能組件來完成書籍格式的轉換。