Gitbook使用Gitbook的編輯軟體,是最為簡單的方法創建書籍,若多人共同編輯一本書,這時使用git的概念會更方便管理。以下就來介紹搭配github來建置gitbook書籍,隨後只要文件退送到github上,gitbook就會更新,這個就是gitbook使用github的repository

第一步 Github創建一個Repository

github創建一個repository

github repository new name

第二步 gitbook創建書籍

1.在gitbook網站後端建置一本書選擇github方式 2.若沒有安裝任何gitbook在你的github上,選擇右邊的Install github integration。

github創建一個book

可選擇你剛才創建的repositories,並按下確認install按鈕。

github install

確認github密碼後完成安裝

github install confirm password

此時會導入github頁面可以看到applications選項內gitbook Repository access 的設定。

github install confirm password

現在可以回到創建書籍的畫面,選擇github方式創建,輸入標題title與description,在選擇這個書本要連結的github的repository,這邊選擇剛剛在github創建的learnen。選擇之後按下create book

gitbook創建書籍

第三步 用Markdown寫本書

首先沒有安裝node.js先至node.js網站下載安裝,基本上就會連同Node.js的npm一起安裝完成。( http://nodejs.org/ )

安裝node.js

接著就是打開 cmd ( windows ) 或 terminal ( Mac ),安裝 gitbook,安裝的方法就是直接輸入下列命令,就可以將 gitbook 安裝到全域。

npm install -g gitbook-cli

之後開啟一個資料夾如book,在資料夾目錄下輸入下列指令

gitbook init

gitbook init cmd

資料夾book就產生了README.md與SUMMARY.md檔案

gitbook folder

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 folder

可以看到完成的書本畫面。

gitbook folder

這樣的方法在多人同時創作一本書時會有很大幫助,也對於習慣寫程式設計師的人,很容易上手及方便管理你檔案。

相關連結:用GitBook來寫本書吧!

您也可能喜歡這些文章

Copyright © 2018 ucamc