396
使用Gitbook寫電子書
工作以來一直有些博客的習慣，除了在各大站長寫博客外，還可以使用 gitbook 將博客整理成電子書出版，如果受到好評還可以將圖書弄成電子版出版。
經過近半年的整理，我的新書《React Native移動開發實戰》就要發售了，提前打個廣告，書名和封麵樣式還在確認中，也歡迎大家給出好的點子。
今天要給大家說的是如何利用GitBook編寫一本屬於自己的點子書。
1，GitBook Editor
首先到官網下載GitBook Editor，目前支持Mac、Linux、Windows主流平台。
安裝完成之後，使用github賬號直接登錄（GitBook提供了四種方式登錄，這裏直接使用gitHub登錄，後麵會用到）。登錄後，可以直接在gitbook上創建書籍，建議在gitbook網站上創建書籍，然後通過GitBook Editor clone 下來；
創建完成時候，就可以寫書了，不過建議先clone到本地後在寫，主要是有時候網絡等問題造成不必要的損失。
注意：此時的GitBook的book頁麵默認沒有download按鈕的，需要做如下的設置。點擊Settting設置打開E-Books選項
2，同步GitHub
如果沒有github賬號，先注冊，之後綁定github賬號。然後依次點擊Setting->github,進行相關的設置即可。
安裝完成之後，就可以關聯github了，先在github上創建一個項目，然後再關聯，第一次關聯可能會有如下的錯誤：
點擊GitBook或者GitHub下麵的鏈接按鈕即可關聯上了。
然後我們添加一篇文章，在gitBook上點擊Updates按鈕。
注意：如果碰到，更新失敗，無法轉換成pdf/mobi/epub格式。
PS:如果涉及到多人協作還可能會涉及其他問題，這裏不多介紹。
3，安裝Node環境
首先我們需要安裝的是Nodejs，關於Node 環境的搭建這裏不再詳述，做過前端開發的通信應該不煳陌生。node安裝完成之後，就可以現在GitBook全局環境了。
4，全局安裝 gitbook
現在我們可以開始安裝全局的 gitbook 了。執行 命令，進行安裝。
npm install gitbook-cli -g
安裝完成之後，可以使用命令來查看是否安裝成功。
gitbook -V
關於GitBook相關的教程，讀者可以參考：GitBook教程
PS:gitbook 常用的命令如下：
gitbook init //初始化目錄文件
gitbook help //列出gitbook所有的命令
gitbook --help //輸出gitbook-cli的幫助信息
gitbook build //生成靜態網頁
gitbook serve //生成靜態網頁並運行服務器
gitbook build --gitbook=2.0.1 //生成時指定gitbook的版本, 本地沒有會先下載
gitbook ls //列出本地所有的gitbook版本
gitbook ls-remote //列出遠程可用的gitbook版本
gitbook fetch 標簽/版本號 //安裝對應的gitbook版本
gitbook update //更新到gitbook的最新版本
gitbook uninstall 2.0.1 //卸載對應的gitbook版本
gitbook build --log=debug //指定log的級別
gitbook builid --debug //輸出錯誤信息
5，GitBook使用
此部分沒有試驗，來自網絡：
gitbook serve
C:\Users\AllenIverson\Desktop\gitbook-test>gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit ...
info: 7 plugins are installed
info: loading plugin "livereload"... OK
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 3 pages
info: found 0 asset files
info: >> generation finished with success in 1.9s !
Starting server ...
Serving book on https://localhost:4000
gitbook ls
C:\Users\AllenIverson\Desktop\gitcourse>gitbook ls
GitBook Versions Installed:
* 3.2.2
Run "gitbook update" to update to the latest version.
gitbook ls-remote
C:\Users\AllenIverson\Desktop\gitcourse>gitbook ls-remote
Available GitBook Versions:
4.0.0-alpha.5, 4.0.0-alpha.4, 4.0.0-alpha.3, 4.0.0-alpha.2, 4.0.0-alpha.1, 3.2.2, 3.2.1, 3.2.0, 3.2.0-pre.1, 3.2.0-
pre.0, 3.1.1, 3.1.0, 3.0.3, 3.0.2, 3.0.1, 3.0.0, 3.0.0-pre.15, 3.0.0-pre.14, 3.0.0-pre.13, 3.0.0-pre.12, 3.0.0-pre.11, 3
.0.0-pre.10, 3.0.0-pre.9, 3.0.0-pre.8, 3.0.0-pre.7, 3.0.0-pre.6, 3.0.0-pre.5, 3.0.0-pre.4, 3.0.0-pre.3, 3.0.0-pre.2, 3.0
.0-pre.1, 2.6.7, 2.6.6, 2.6.5, 2.6.4, 2.6.3, 2.6.2, 2.6.1, 2.6.0, 2.5.2, 2.5.1, 2.5.0, 2.5.0-beta.7, 2.5.0-beta.6, 2.5.0
-beta.5, 2.5.0-beta.4, 2.5.0-beta.3, 2.5.0-beta.2, 2.5.0-beta.1, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.3, 2.3.2, 2.3.1, 2.3.0,
2.2.0, 2.1.0, 2.0.4, 2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-beta.5, 2.0.0-beta.4, 2.0.0-beta.3, 2.0.0-beta.2, 2.0.0-beta.1,
2.0.0-alpha.9, 2.0.0-alpha.8, 2.0.0-alpha.7, 2.0.0-alpha.6, 2.0.0-alpha.5, 2.0.0-alpha.4, 2.0.0-alpha.3, 2.0.0-alpha.2,
2.0.0-alpha.1
Tags:
latest : 3.2.2
pre : 4.0.0-alpha.5
gitbook -V
C:\Users\AllenIverson\Desktop\gitcourse>gitbook -V
CLI version: 2.3.0
GitBook version: 3.2.2
新建一個GitBook項目後，係統會默認新建幾個文件：README.md、SUMMARY.md和chapter1.md。README.md相當於簡介，SUMMARY.md：相當於這本書的目錄，
6，calibre
首先到calibre官網下載對應的版本並安裝，打開後界麵如下：
gitbook-convert
把docx、xml、html、odt文檔轉成GitBook，首先需要安裝gitbook-convert插件。
npm install gitbook-convert -g
如果需要轉換，可以使用下麵的命令：
gitbook-convert [options] <file> [export-directory]
7，常用插件
Gitbook 插件 裏已經有100多個插件，可以在 book.json 文件的 plugins 和 pluginsConfig 字段添加插件及相關配置，添加後別忘了進行安裝。例如：
// book.json
{
"title": "Webpack 中文指南",
"description": "Webpack 是當下最熱門的前端資源模塊化管理和打包工具，本書大部分內容翻譯自 Webpack 官網。",
"language": "zh",
"plugins": [
"disqus",
"github",
"editlink",
"prism",
"-highlight",
"baidu",
"splitter",
"sitemap"
],
"pluginsConfig": {
"disqus": {
"shortName": "webpack-handbook"
},
"github": {
"url": "https://github.com/zhaoda/webpack-handbook"
},
"editlink": {
"base": "https://github.com/zhaoda/webpack-handbook/blob/master/content",
"label": "編輯本頁"
},
"baidu": {
"token": "a9787f0ab45d5e237bab522431d0a7ec"
},
"sitemap": {
"hostname": "https://zhaoda.net/"
}
}
}
然後使用gitbook install安裝插件。
# 安裝插件
$ gitbook install ./
更多插件的使用請參考：GitBook使用教程
最後更新：2017-09-28 14:33:29