使用 GIT 更新書籍

gitbook.com 建立一個書籍專案之後,你需要把內容推送上去,使用網頁版的編輯器,或是使用終端機指令更新皆可。

第二種方法其實就是使用 GIT 提交你的內容異動:

GIT Url

每一本書都對應著一個 Git HTTPS 網址,GitBook 的 git 主機還不接受 ssh 傳輸協定。

網址看起來像這樣:

  1. https://git.gitbook.com/{{UserName}}/{{Book}}.git

授權認證

主機需要認證你的 GitBook 帳號,跳出提示時輸入你的 GitBook 帳戶名稱與密碼即可(你也可以使用專屬的 API token)。

儲存你的認證許可(credentials)

為了省去每次推送內容時都得輸入帳號密碼的麻煩,你可以把 GitBook 的認證許可寫到 ~/.netrc 檔案裡。新建或是添加下面的內容到 ~/.netrc 檔案:

  1. machine git.gitbook.com
  2. login USERNAME-or-EMAIL
  3. password API-TOKEN-or-PASSWORD

建議使用 API TOKEN,因為安全性更高些;你可以從網站後台的「API」選項中找到專屬於你的相關資訊。

使用終端機指令建立新的書籍專案

  1. touch README.md SUMMARY.md
  2. git init
  3. git add README.md SUMMARY.md
  4. git commit -m "first commit"
  5. git remote add gitbook https://git.gitbook.com/{{UserName}}/{{Book}}.git
  6. git push -u gitbook master

推送到現有的書籍專案

  1. git remote add gitbook https://git.gitbook.com/{{UserName}}/{{Book}}.git
  2. git push -u gitbook master