Gitbook簡易教程

簡介

GitBook 是一個基於 Node.js 的命令行工具，可以使用 Github/Git 和 Markdown 來製做精美的電子書。GitBook支持輸出如下幾種文檔格式

• 靜態站點：GitBook默認輸出該種格式

• PDF：須要安裝gitbook-pdf依賴

• eBook：須要安裝ebook-convert

準備安裝

在使用GitBook 以前, 咱們須要先安裝一些必須的工具，Node.js、GitBook、GitBook Editor、Git版本控制器。

Node.js

Node.js 是一個基於Chrome JavaScript 運行時創建的一個平臺， 用來方便地搭建快速的， 易於擴展的網絡應用· Node.js 藉助事件驅動， 非阻塞 I/O 模型變得輕量和高效， 很是適合 run across distributed devices 的 data-intensive 的實時應用。

一、win下安裝Node.js

直接到nodejs官網下載，簡單安裝便可，此處再也不細述。

二、檢測是否安裝成功

node -v //顯示v4.1.1

GitBook

GitBook 是一個基於 Node.js 的命令行工具，可以使用 Github/Git 和 Markdown 來製做精美的電子書。經過Node.js命令安裝GitBook

一、NMP安裝Gitbook

npm install gitbook -g

二、安裝gitbook CLI

想在系統上的任何地方的gitbook命令，須要安裝「gitbook CLI」，執行如下命令

//安裝命令
npm install -g gitbook-cli
//卸載命令
npm uninstall -g gitbook

三、檢驗下是否安裝成功

gitbook -V //顯示0.4.2

Git

Git是一款免費、開源的分佈式版本控制系統，用於敏捷高效地處理任何或小或大的項目。基本安裝請點擊安裝教程。若是不須要從GitHub更新書到本地再編譯，則能夠不安裝Git。

GitBookEditor

GitBook官方客戶端編輯器，支持Win、Linux、Mac系統。請點擊下載GitBookEditor。使用該編輯器能夠快速的建立、編輯GitBook。安裝具備如下步驟：

• 解壓下載包 gitbook-editor-4.2.1-windows-ia32.zip

• 運行GitBook Editor Setup.exe進行默認安裝

基本使用

GitBook 大體分爲兩種使用方式，即離線和在線。最簡單的使用方式是使用GitBook Editor編輯GitBook ，而後使用相關命令編譯成功HTML。固然還有如下幾種方式

• 使用命令建立基本GitBook

• 使用網頁在線編輯器建立、編輯GitBook。

• 使用itBookEditor客戶端建立、編輯GitBook。

gitBookEditor

使用客戶端方式，支持在線和本地兩種方式建立、編輯GitBook，再執行相關命令編譯成HTML，這種方式比較方便，推薦使用。以本地建立書籍爲例

一、gitBookEditor客戶端基本使用

二、使用命令對已經建立的Book進行編譯

找到須要編譯的書籍所在目錄，執行gitbook serve 命令,在本電腦的默認路徑爲C:UsersQGYGitBookLibraryImportgitbooksimpletutorial，如圖所示

高級擴展

掌握了「基本使用」，但有時候想要gitBook更美觀，或者更符合咱們本身的需求，則經過book.json配置進行自定義、以及安裝一些經常使用的插件等。

Book.json配置

GitBook 在編譯書籍的時候會讀取書籍源碼頂層目錄中的 book.js 或者 book.json，這裏以 book.json 爲例，參考 GitBook 文檔 能夠知道，book.json 支持以下配置

{

    //樣式風格配置格式
    "styles": {
        "website": "styles/website.css",
        "ebook": "styles/ebook.css",
        "pdf": "styles/pdf.css",
        "mobi": "styles/mobi.css",
        "epub": "styles/epub.css"
     },

    //插件安裝配置格式

    "plugins": ["myplugin"],
    "pluginsConfig": {
        "myPlugin": {
            "message": "Hello World"
        }
     }    
}

自定義插件擴展

插件是擴展GitBook功能最好的方法。使得GitBook功能更增強大，例如，把數學公式顯示支持，跟蹤回訪使用谷歌解析，…以toggle-chapters插件爲例
toggle-chapters 插件的效果是默認只在目錄導航中顯示章的標題，而不會顯示小節的標題，點擊每一章或者每一節會顯示當前章或節的子目錄，若是有的話，可是同時會收起其它以前展開的章節。因此，我的認爲不是很是實用，由於這樣子用戶不能快速跳轉到沒有展開的章節！

1、搜索、安裝插件方式

一、編輯器方式（沒成功）

二、經過GitHub方式

www.plugins.gitbook.com

三、node.js命令方式

• 默認安裝在如下路徑

C:\Users\QGY\AppData\Roaming\npm\node_modules

• 把插件文件夾複製到

npm install gitbook-plugin-toggle-chapters --save-dev

2、經過Book.json配置插件

"plugins": ["toggle-chapters"],
    "pluginsConfig": {
        "myPlugin": {
            "message": "Hello World"
        }
     }