「GitBook」從0到1

簡(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目錄里面葱色。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市娘香,隨后出現(xiàn)的幾起案子苍狰,更是在濱河造成了極大的恐慌,老刑警劉巖烘绽,帶你破解...
    沈念sama閱讀 216,324評(píng)論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件淋昭,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡安接,警方通過(guò)查閱死者的電腦和手機(jī)翔忽,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,356評(píng)論 3 392
  • 文/潘曉璐 我一進(jìn)店門(mén),熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)盏檐,“玉大人歇式,你說(shuō)我怎么就攤上這事『埃” “怎么了材失?”我有些...
    開(kāi)封第一講書(shū)人閱讀 162,328評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)硫豆。 經(jīng)常有香客問(wèn)我龙巨,道長(zhǎng),這世上最難降的妖魔是什么够庙? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,147評(píng)論 1 292
  • 正文 為了忘掉前任恭应,我火速辦了婚禮,結(jié)果婚禮上耘眨,老公的妹妹穿的比我還像新娘昼榛。我一直安慰自己,他們只是感情好剔难,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,160評(píng)論 6 388
  • 文/花漫 我一把揭開(kāi)白布胆屿。 她就那樣靜靜地躺著,像睡著了一般偶宫。 火紅的嫁衣襯著肌膚如雪非迹。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 51,115評(píng)論 1 296
  • 那天纯趋,我揣著相機(jī)與錄音憎兽,去河邊找鬼冷离。 笑死,一個(gè)胖子當(dāng)著我的面吹牛纯命,可吹牛的內(nèi)容都是我干的西剥。 我是一名探鬼主播,決...
    沈念sama閱讀 40,025評(píng)論 3 417
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼亿汞,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼瞭空!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起疗我,我...
    開(kāi)封第一講書(shū)人閱讀 38,867評(píng)論 0 274
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤咆畏,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后吴裤,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體旧找,經(jīng)...
    沈念sama閱讀 45,307評(píng)論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,528評(píng)論 2 332
  • 正文 我和宋清朗相戀三年嚼摩,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了钦讳。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,688評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡枕面,死狀恐怖愿卒,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情潮秘,我是刑警寧澤琼开,帶...
    沈念sama閱讀 35,409評(píng)論 5 343
  • 正文 年R本政府宣布,位于F島的核電站枕荞,受9級(jí)特大地震影響柜候,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜躏精,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,001評(píng)論 3 325
  • 文/蒙蒙 一渣刷、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧矗烛,春花似錦辅柴、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 31,657評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至歪架,卻和暖如春股冗,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背和蚪。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 32,811評(píng)論 1 268
  • 我被黑心中介騙來(lái)泰國(guó)打工止状, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留烹棉,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 47,685評(píng)論 2 368
  • 正文 我出身青樓怯疤,卻偏偏與公主長(zhǎng)得像峦耘,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子旅薄,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,573評(píng)論 2 353

推薦閱讀更多精彩內(nèi)容