⭐ 步驟 - 如何使用 gitbook 寫書
什麼是 gitbook
- gitbook 是好用的寫書工具，可以用來解釋有點複雜、沒辦法一頁說完的事情。當你開始寫書，它就馬上自動生出一個線上閱讀的網址，讓你可以把最新進度貼給別人看，你寫到哪，別人就可以看到哪。像是：
跟 gitbook 有關的宅宅名詞們
- git 是幫你管理文件版本的工具，它管的文件通常是程式碼，但也可以是一般純文字文件
- github 是幫你管理 git 的工具，原本在用的人比較多是工程師，但網頁介面變得越來越和藹可親、推出可愛的 app 以後，越來越多正常人使用了
- gitbook 是幫你利用 github 的版本管理功能來寫書的工具，為了讓正常人使用所以有 web editor，如果需要離線寫書的話也有可愛的 app 可以用
步驟
申請 github 與 gitbook 帳號
- 申請 github 帳號
- 帳號申請：https://github.com/
- （optional）如果需要離線寫書的話，要另外：下載與安裝 github app
- mac 版下載：github for mac
- windows 版下載：github for windows
- 申請 gitbook 帳號
- 帳號申請：https://www.gitbook.com/
- （optional）如果需要離線寫書的話，要另外：下載與安裝 gitbook app
- linux 版 / mac 版 / windows 版下載：gitbook editor
- （optional）加入 g0v 零時政府的 GitBook 團體：https://www.gitbook.com/@g0v
在 gitbook 開一本新的書
很簡單，在一登入的 dashboard 畫面，按下 create a new book 綠色按鈕，輸入書名跟想要的網址就可以了。
- 瞧瞧這好精美的 dashboard
- 瞧瞧這好精美的 new book
開始寫書
打開 Editor 之後，從左上角的 Table of Contents 選擇要編輯的檔案
寫到一個段落，存檔發佈
按 Save 按鈕儲存（上方工具列最左邊那個）
請別人來幫忙寫書
- 個人帳號底下的書
- 在書的設定頁（Settings）邀請協作者（ Collaborators）
- 團體（organization）底下的書
- 將別人加入團體，並給予編輯權限
- 在書的設定頁（Settings）邀請協作者（ Collaborators）
- 以上兩種方式可設定標示作者的方式不同。
寫別人的書
需被加入擁有該書的團體，或是被加為協作者。
在沒有網路的地方寫書
可能得透過 Git 在本地端編輯了。
gitbook 架構
gitbook主要分為四個部分。
SUMMARY.md
這是書籍的目錄結構，裡面是內容的部份。結構請參考此：
http://help.gitbook.io/book/chapters.html
README.md
這是書籍的前言，不用把它加在目錄結構裡面。
1-0.md 1-1.md 1-2.md.....
這些是章節內容，如1-2代表第一章第二節。不過命名方式沒有強制，只要SUMMARY中有定義就可以。
cover.jpg cover_small.jpg
這是封面
尺寸如下：
cover.jpg 1800x2360
cover_small.jpg 200x262
book.json
參數設定用，說明請見：http://help.gitbook.com/format/configuration.html
Working with GitHub
如果要用 GitBook 連結一個現有的 GitHub repo.，則必須有該 repo. 的權限。
以 g0v dev team 的 repo. 為例，需要：
- 找一個已經在 g0v GitHub 團體裡面的人，然後請他將你的帳號加入 dev team
- 請至您 GitHub 的帳號 email 收信，並同意邀請加入 g0v
- 在 GitBook 帳號設定（Account Settings）裡面連結你的 GitHub 帳號（Connect to GitHub）
- 找一個已經在 g0v Gitbook 團體裡面的人，然後請他加入你的帳號
參考書本內容
https://github.com/billy3321/TaiwanFEPZS
相關文件
http://gitbookio.gitbooks.io/documentation/