什麼是 gitbook

跟 gitbook 有關的宅宅名詞們

步驟

申請 github 與 gitbook 帳號

  1. 申請 github 帳號
  1. 申請 gitbook 帳號

在 gitbook 開一本新的書

很簡單,在一登入的 dashboard 畫面,按下 create a new book 綠色按鈕,輸入書名跟想要的網址就可以了。

  1. 瞧瞧這好精美的 dashboard
  2. 瞧瞧這好精美的 new book

開始寫書

打開 Editor 之後,從左上角的 Table of Contents 選擇要編輯的檔案

寫到一個段落,存檔發佈

按 Save 按鈕儲存(上方工具列最左邊那個)

請別人來幫忙寫書

  1. 個人帳號底下的書
    1. 在書的設定頁(Settings)邀請協作者( Collaborators)
  2. 團體(organization)底下的書
    1. 將別人加入團體,並給予編輯權限
    2. 在書的設定頁(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. 為例,需要:

參考書本內容

https://github.com/billy3321/TaiwanFEPZS

相關文件

http://gitbookio.gitbooks.io/documentation/