前置作業 - gitbook-cli 安裝

身為工程師(嘆氣)
CMD/CLI總是離開不你的生活
就連寫電子書也是一樣啊...

安裝

要開始安裝GitBook，你的系統需要滿足以下兩個條件：

• 已安裝NodeJS（建議使用v6.0.0及以上版本）
• 作業系統為：Windows，Linux，Unix或Mac OS X

這兩點都沒問題的話，讓我們繼續看下去

首先我們要用NPM來安裝gitbook-cli (GitBook的Command Line Interface)
gitbook-cli是Gitbook開發來讓使用者在本地端建立、檢視、測試、發布、輸出電子書的一套工具

gitbook-cli 只支援gitbook 2.0.0(含)以上的版本

$ npm install gitbook-cli -g

-g代表的是把這個套件安裝在全域的環境中

安裝好之後，執行

$ gitbook -V

安裝成功的話會顯示使用中的CLI & Gitbook版本，作者寫作當下的版本如下

CLI version: 2.3.2
GitBook version: 3.2.3

接著輸入

$ gitbook help

這個指令會列出所有gitbook-cli提供的指令與相關說明

從上圖中可以看到，gitbook-cli提供的基本指令一共有8種

• build
• serve
• install
• parse
• init
• pdf
• epub
• mobi

接下來的文章會提到這8種指令的基本用法

Gitbook版本管理

在預設的情況，gitbook-cli，會使用

這個指令用來查看目前已經安裝的Gitbook版本：

$ gitbook ls

舉例來說，作者的電腦會輸出以下資訊，代表作者只有安裝一種Gitbook版本

GitBook Versions Installed:

    * 3.2.3

Run "gitbook update" to update to the latest version.

有時候要安裝其他版本，如果不知道有哪些其他的版本可以安裝，要用這個指令：

$ gitbook ls-remote

該指令會列出NPM上面所有的可安裝版本

vailable GitBook Versions:

     4.0.0-alpha.6, 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.3, 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.3
     pre : 4.0.0-alpha.6

而最下面的資訊代表，穩定版(lastest)是 3.2.3，預覽版(pre)是4..0-alpha.6

假設今天我們需要安裝2.1.0版，會這樣使用

$ gitbook fetch 2.1.0

也可以直接使用beta，安裝預覽版

$ gitbook fetch beta

刪除某特定的版本(假設刪除2.0.1版)

$ gitbook uninstall 2.0.1

或是要更新到最新的版本

$ gitbook update