什麼是 gitbook
- gitbook 是好用的寫書工具,可以用來解釋有點複雜、沒辦法一頁說完的事情。當你開始寫書,它就馬上自動生出一個線上閱讀的網址,讓你可以把最新進度貼給別人看,你寫到哪,別人就可以看到哪。像是:
- 自經區自經區手冊手冊
- 群眾募資、公司法(vTaiwan之後還會有 8~9 本)
- 憲餅食譜100道
跟 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
在 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/