Gitbook使用Gitbook的編輯軟體,是最為簡單的方法創建書籍,若多人共同編輯一本書,這時使用git的概念會更方便管理。以下就來介紹搭配github來建置gitbook書籍,隨後只要文件退送到github上,gitbook就會更新,這個就是gitbook使用github的repository。
第一步 Github創建一個Repository
第二步 gitbook創建書籍
1.在gitbook網站後端建置一本書選擇github方式
2.若沒有安裝任何gitbook在你的github上,選擇右邊的Install github integration。
可選擇你剛才創建的repositories,並按下確認install按鈕。
確認github密碼後完成安裝
此時會導入github頁面可以看到applications選項內gitbook Repository access 的設定。
現在可以回到創建書籍的畫面,選擇github方式創建,輸入標題title與description,在選擇這個書本要連結的github的repository,這邊選擇剛剛在github創建的learnen。選擇之後按下create book。
第三步 用Markdown寫本書
首先沒有安裝node.js先至node.js網站下載安裝,基本上就會連同Node.js的npm一起安裝完成。( http://nodejs.org/ )
接著就是打開 cmd ( windows ) 或 terminal ( Mac ),安裝 gitbook,安裝的方法就是直接輸入下列命令,就可以將 gitbook 安裝到全域。
npm install -g gitbook-cli
之後開啟一個資料夾如book,在資料夾目錄下輸入下列指令
gitbook init
資料夾book就產生了README.md與SUMMARY.md檔案
SUMMARY.md檔案是主要連結gitbook的檔案,內容寫作方式也如同Markdown語法的list方法,就像排列式你的目錄,連結你的內容資料夾內的檔案。如以下範例清楚明白。
# Summary
* [Introduction](README.md)
* [基本安裝](howtouse/README.md)
* [Node.js安裝](howtouse/nodejsinstall.md)
* [Gitbook安裝](howtouse/gitbookinstall.md)
* [Gitbook命令行速覽](howtouse/gitbookcli.md)
* [圖書項目結構](book/README.md)
* [README.md 與 SUMMARY編寫](book/file.md)
* [目錄初始化](book/prjinit.md)
* [圖書輸出](output/README.md)
* [輸出為靜態網站](output/outfile.md)
* [輸出PDF](output/pdfandebook.md)
* [發布](publish/README.md)
* [發佈到Github Pages](publish/gitpages.md)
* [結束](end/README.md)
SUMMARY.md寫好對應連結資料夾內的.md內容檔案就可上傳到你的github
如book資料夾內有個檔案叫做book1.md,我的SUMMARY.md檔案可以這樣寫。
# Summary
* [Introduction](README.md)
* [我的第一章](book1.md)
第四步 git書本檔案到github
基本上有了README.md與SUMMARY.md你就可以推上github上,在專案目錄下輸入以下指令。
git init
git add .
git commit -m 'first commit'
git remote add origin https://github.com/改成你的github Repository網址
git push -u origin master
沒問題的話,重整你的gitbook畫面,你就可以看到gitbook成功的畫面。按下Access your content
可以看到完成的書本畫面。
這樣的方法在多人同時創作一本書時會有很大幫助,也對於習慣寫程式設計師的人,很容易上手及方便管理你檔案。
相關連結:用GitBook來寫本書吧!