利用Gitbook製作電子書是相當容易的,作者只要熟悉markdown語法以及簡易的安裝,就可以快速編寫屬於自己的書籍,它有著以下幾點特色。
- 利用git 版本控制
- 用git就可以發佈新版本
- 利用markdown語法編寫
- 包含手機版
這邊就簡單介紹如何安裝gitbook server在自己本機上,以利於快速與他人合作。
注意:本文不會提到git操作,在使用gitbook前,請先熟悉git。
https://www.gitbook.io/book/wcc723/google_design_translate
安裝
在安裝Gitbook必須先裝Node.js,Node.js 是一個讓 Javascript 運行在服務端的開發平台。它使用了 Google 的 V8 虛擬機(Google Chrome 瀏覽器使用的 Javascript 執行環境)。
另外還有npm,是由Node.js 官方提供的第三方管理工具,並且是一種在 Node.js 應用程式中建立、分享、重複使用模組,而npm在目前的版本,都會隨著Node.js的安裝同時安裝好npm。
簡而言之,我們使用Node.js的服務,透過npm管理工具,如果還是不知道,就是照著操作就是了。
安裝node.js
Node.js在這一個部分windows與mac其實只是安裝檔不同,只要按照官方程序裝完就可以了。
這邊就只Show出windows版本的安裝(Mac版大致相同,而後面的介紹會兩者混用)
如果是windows,請打開”命令提示字元”,輸入:
node -v
npm -v
預期會出現以下的版本(或者更高)
如果是Mac,請打開終端機,和windows相同,輸入以下指令:
node -v
npm -v
預期會出現以下的版本(或者更高)
安裝gitbook
由於我這邊mac已經裝完,我用windows做範例,當然結果是一樣的。
打開command輸入以下指令。
npm install -g gitbook
安裝完後輸入 gitbook version
,預期會出現以下畫面。
gitbook serve
範例專案:https://github.com/Wcc723/google_design_translate
接下來到一個專案的資料夾,輸入gitbook serve
,它就會打開一個port,並且運行gitbook server。
網址輸入localhost:4000
就可以看到這一個網站。
可能會遇到的問題
我也不知道為什麼…,Mac版會出現這個錯誤,反正有解決方式。
回到Terminal,輸入ulimit -n 4096
,在執行一次gitbook serve
。
ulimit -n 4096
安捏,就可以正常執行了。
剩下的部分,可以參考目前範例的架構。而最近發這篇文,是因為聽說9月9日快到了。