簡(jiǎn)介
GitBook 是一個(gè)基于 Node.js 的命令行工具抬探,可使用 Github/Git 和 Markdown 來(lái)制作精美的電子書(shū)。GitBook支持輸出以下幾種文檔格式
靜態(tài)站點(diǎn):GitBook默認(rèn)輸出該種格式
PDF:需要安裝gitbook-pdf依賴
eBook:需要安裝ebook-conver
準(zhǔn)備安裝
在使用GitBook 之前, 我們需要先安裝一些必須的工具,Node.js、GitBook、GitBook Editor朴摊、Git版本控制器。
Node.js
Node.js 是一個(gè)基于Chrome JavaScript 運(yùn)行時(shí)建立的一個(gè)平臺(tái)此虑, 用來(lái)方便地搭建快速的甚纲, 易于擴(kuò)展的網(wǎng)絡(luò)應(yīng)用· Node.js 借助事件驅(qū)動(dòng), 非阻塞 I/O 模型變得輕量和高效朦前, 非常適合 run across distributed devices 的 data-intensive 的實(shí)時(shí)應(yīng)用介杆。
1、win下安裝Node.js
直接到nodejs官網(wǎng)下載韭寸,簡(jiǎn)單安裝即可春哨,此處不再細(xì)述。
2恩伺、檢測(cè)是否安裝成功
node -v //顯示v4.1.1
GitBook
GitBook 是一個(gè)基于 Node.js 的命令行工具赴背,可使用 Github/Git 和 Markdown 來(lái)制作精美的電子書(shū)。通過(guò)Node.js命令安裝GitBook
1晶渠、NMP安裝Gitbook
npm install gitbook -g
2凰荚、安裝gitbook CLI
想在系統(tǒng)上的任何地方的gitbook命令,需要安裝“gitbook CLI”乱陡,執(zhí)行以下命令
//安裝命令
npm install -g gitbook-cli
//卸載命令
npm uninstall -g gitbook
3浇揩、檢驗(yàn)下是否安裝成功
gitbook -V //顯示0.4.2
Git
Git是一款免費(fèi)、開(kāi)源的分布式版本控制系統(tǒng)憨颠,用于敏捷高效地處理任何或小或大的項(xiàng)目胳徽。基本安裝請(qǐng)點(diǎn)擊安裝教程爽彤。如果不需要從GitHub更新書(shū)到本地再編譯养盗,則可以不安裝Git。
GitBookEditor
GitBook官方客戶端編輯器适篙,支持Win往核、Linux、Mac系統(tǒng)嚷节。請(qǐng)點(diǎn)擊下載GitBookEditor聂儒。使用該編輯器可以快速的創(chuàng)建、編輯GitBook硫痰。安裝具有以下步驟:1)解壓下載包 gitbook-editor-4.2.1-windows-ia32.zip
2)運(yùn)行GitBook Editor Setup.exe進(jìn)行默認(rèn)安裝
基本使用
GitBook 大致分為兩種使用方式衩婚,即離線和在線。最簡(jiǎn)單的使用方式是使用GitBook Editor編輯GitBook 效斑,然后使用相關(guān)命令編譯成功HTML非春。當(dāng)然還有以下幾種方式
使用命令創(chuàng)建基本GitBook
使用網(wǎng)頁(yè)在線編輯器創(chuàng)建、編輯GitBook。
使用itBookEditor客戶端創(chuàng)建奇昙、編輯GitBook护侮。
gitBookEditor
使用客戶端方式,支持在線和本地兩種方式創(chuàng)建储耐、編輯GitBook羊初,再執(zhí)行相關(guān)命令編譯成HTML,這種方式比較方便弧岳,推薦使用凳忙。以本地創(chuàng)建書(shū)籍為例
使用命令對(duì)已經(jīng)創(chuàng)建的Book進(jìn)行編譯
找到需要編譯的書(shū)籍所在目錄,執(zhí)行g(shù)itbook serve 命令,在本電腦的默認(rèn)路徑為C:UsersQGYGitBookLibraryImportgitbooksimpletutorial禽炬,如圖所示
高級(jí)擴(kuò)展
掌握了“基本使用”涧卵,但有時(shí)候想要gitBook更美觀,或者更符合我們自己的需求腹尖,則通過(guò)book.json配置進(jìn)行自定義柳恐、以及安裝一些常用的插件等。
Book.json配置
GitBook 在編譯書(shū)籍的時(shí)候會(huì)讀取書(shū)籍源碼頂層目錄中的 book.js 或者 book.json热幔,這里以 book.json 為例乐设,參考 GitBook 文檔 可以知道,book.json 支持如下配置
自定義插件擴(kuò)展
插件是擴(kuò)展GitBook功能最好的方法绎巨。使得GitBook功能更加強(qiáng)大近尚,例如,把數(shù)學(xué)公式顯示支持场勤,跟蹤回訪使用谷歌解析戈锻,…以toggle-chapters插件為例toggle-chapters 插件的效果是默認(rèn)只在目錄導(dǎo)航中顯示章的標(biāo)題,而不會(huì)顯示小節(jié)的標(biāo)題和媳,點(diǎn)擊每一章或者每一節(jié)會(huì)顯示當(dāng)前章或節(jié)的子目錄格遭,如果有的話,但是同時(shí)會(huì)收起其它之前展開(kāi)的章節(jié)留瞳。所以拒迅,個(gè)人認(rèn)為不是非常實(shí)用,因?yàn)檫@樣子用戶不能快速跳轉(zhuǎn)到?jīng)]有展開(kāi)的章節(jié)她倘!
一璧微、搜索、安裝插件方式
1硬梁、編輯器方式(沒(méi)成功)
2前硫、通過(guò)GitHub方式
www.plugins.gitbook.com
3、node.js命令方式
默認(rèn)安裝在以下路徑
C:\Users\QGY\AppData\Roaming\npm\node_modules
把插件文件夾復(fù)制到
npminstallgitbook-plugin-toggle-chapters--save-dev
二靶溜、通過(guò)Book.json配置插件
"plugins": ["toggle-chapters"],"pluginsConfig": {"myPlugin": {"message":"Hello World"}? ? }
Windows上使用gitbook制作電子書(shū)
下載ebook-convert,直接到http://www.calibre-ebook.com/download_windows下載
直接安裝軟件,并在將安裝目錄添加到系統(tǒng)path中罩息,默認(rèn)安裝在:C:\Program Files (x86)\Calibre2(安裝成功后嗤详,記得先退出gitbook終端在進(jìn)入才能生效)
生成PDF文件,在電子書(shū)存檔目錄瓷炮,如:E:\xx\gitbook\mybook_test執(zhí)行 gitbook pdf .或者上一級(jí)目錄執(zhí)行g(shù)itbook pdf ./mybook_test
book.pdf生成在mybook_test目錄里面葱色。