使用 GIT 更新書籍

使用 GIT 更新書籍

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

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

GIT Url

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

網址看起來像這樣：

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

授權認證

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

儲存你的認證許可（credentials）

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

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

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

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

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

推送到現有的書籍專案

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