不解決好這 3 大矛盾，就別搞 DevOps 了>>>>>>

GotGitHub 是 GitHub 的詳細完整的權威介紹。

這是一本關于GitHub的書，在線閱讀請訪問： http://www.worldhello.net/gotgithub 。

動筆寫GitHub不是因為我對其了解，恰恰是對其太不了解。在我寫的 《Git權威指南》 一書中，涉及到GitHub的只有區區三頁紙，這顯然回答不了讀者對于GitHub的諸多疑問。

這本書采用Creative Commons協議發布，并托管在GitHub上，意味著您可以免費閱讀并可以用GitHub特有的方式參與本書的維護。

如何離線閱讀

項目 gotgit/gotgithub 的版本庫中的 gh-pages 分支保存著本書編譯后的頁面，意味著您只要下載版本庫并檢出 gh-pages 分支即可在本地瀏覽。

• 克隆版本庫。

  $?git?clone?git://github.com/gotgit/gotgithub.git

• 檢出 gh-pages 分支。

  $?cd?gotgithub
  $?git?checkout?gh-pages

• 用瀏覽器打開 index.html 即可離線閱讀。

因分支 gh-pages 的提交歷史可能會周期性刪除或壓縮合并，為避免執行 git pull 更新分支時造成困惑，請對本地版本庫進行如下設置。

$?git?config?--add?remote.origin.fetch?+refs/heads/gh-pages:refs/heads/gh-pages

如何編譯

預備

• Python, docutils

  本書使用 reStructuredText 格式撰寫，格式解析依賴 Python 和 docutils 包。

• Sphinx

  用 Sphinx 工具進行編譯。編譯前先確認已經安裝 Python、docutils 及 sphinx。

• ImageMagick 及 Inkscape

  本書圖片矢量圖采用 Inkscape 繪制，位圖處理采用 GIMP 。上述格式圖片在網頁顯示需要格式轉換，格式轉換需用到 ImageMagick 和 Inkscape。

• Git

  不解釋。

克隆版本庫（本書書稿及圖片）

本書用兩個版本庫維護：

• 書稿版本庫：

  https://github.com/gotgit/gotgithub/

• 圖片版本庫：

  https://github.com/gotgit/gotgithub-graphics/

本書的圖片版本庫以子模組形式關聯到書稿版本庫，運行下面命令執行克隆：

• 若尚未克隆書稿版本庫，先克隆書稿版本庫。

  $?git?clone?git://github.com/gotgit/gotgithub.git
  $?cd?gotgithub

• 默認檢出 master 分支。如果當前非 master 分支，執行下面命令檢出分支。

  $?git?checkout?master

• 通過子模組更新命令克隆子模組版本庫（即保存圖片的版本庫）并檢出。

  $ git submodule init ?$ git submodule update

編譯書稿

確保安裝了 Sphinx、ImageMagick、Inkscape。編譯本書使用命令：

$?make?html

編譯后的網頁位于 _build/html 目錄下。

更多的格式輸出參見下面的命令輸出：

$?make

如何貢獻

請采用GitHub方式貢獻。

• 創建派生項目。即 Fork。

• 修改您覺得不滿意的地方。修改后推送到您創建的分支版本庫中。

• 通過 GitHub 向我發送 Pull Request。

-- 蔣鑫, http://weibo.com/gotgit/

目錄

• 1. 探索GitHub

  • 1.1. 什么是GitHub

  • 1.2. GitHub亮點

  • 1.3. 探索GitHub

• 2. 加入GitHub

  • 2.1. 創建GitHub賬號

  • 2.2. 瀏覽托管項目

  • 2.3. 社交網絡

• 3. 項目托管

  • 3.5.1. 創建個人主頁

  • 3.5.2. 創建項目主頁

  • 3.5.3. 使用專有域名

  • 3.5.4. 使用Jekyll維護網站

  • 3.4.1. 郵件通知功能

  • 3.4.2. 和Redmine整合

  • 3.3.1. 用戶級公鑰管理

  • 3.3.2. 項目級公鑰管理

  • 3.2.1. 強制推送

  • 3.2.2. 新建分支

  • 3.2.3. 設置默認分支

  • 3.2.4. 刪除分支

  • 3.2.5. 里程碑管理

  • 3.1.1. 新版本庫即是新項目

  • 3.1.2. 版本庫初始化

  • 3.1.3. 從已有版本庫創建

  • 3.1. 創建新項目

  • 3.2. 操作版本庫

  • 3.3. 公鑰認證管理

  • 3.4. 版本庫鉤子擴展

  • 3.5. 建立主頁

• 4. 工作協同

  • 4.6.1. 維基初始化

  • 4.6.2. 使用維基

  • 4.6.3. 維基與Git

  • 4.5.1. 標簽

  • 4.5.2. 里程碑

  • 4.5.3. Issue的生命周期

  • 4.5.4. Pull Requst也是Issue

  • 4.4.1. 提交評注

  • 4.4.2. 逐行評注

  • 4.3.1. 創建新組織

  • 4.3.2. 組織管理

  • 4.3.3. 版本庫管理

  • 4.3.4. 個人還是組織

  • 4.2.1. 版本庫授權

  • 4.2.2. 與傳統集中式工作模式的異同

  • 4.2.3. 合并后推送

  • 4.2.4. 合并還是變基

  • 4.1.1. 版本庫派生

  • 4.1.2. Pull Request

  • 4.1.3. 手工合并

  • 4.1.4. 在線編輯

  • 4.1.5. 簡化的 Fork + Pull Request

  • 4.1. Fork + Pull模式

  • 4.2. 共享版本庫

  • 4.3. 組織和團隊

  • 4.4. 代碼評注

  • 4.5. 缺陷跟蹤

  • 4.6. 維基

• 5. 付費服務

  • 5.1. GitHub收費方案

  • 5.2. GitHub企業版

• 6. GitHub副產品

  • 6.4.1. GitHub:Jobs

  • 6.4.2. GitHub:Shop

  • 6.4.3. GitHub短網址服務

  • 6.4.4. GitHub Open Source

  • 6.3.1. github:mac

  • 6.3.2. hub

  • 6.3.3. iOS應用

  • 6.2.1. 用SVN操作GitHub

  • 6.2.2. 用Hg操作GitHub

  • 6.1.1. 數據的粘貼和引用

  • 6.1.2. Gist背后的Git庫

  • 6.1.3. Greasemonkey

  • 6.1.4. 命令行操作Gist

  • 6.1. GitHub:Gist

  • 6.2. 其他版本控制工具支持

  • 6.3. 客戶端工具

  • 6.4. 其他

• 7. 附錄：輕量級標記語言

?