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

GotGitHub 是 GitHub 的詳細(xì)完整的權(quán)威介紹。

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

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

這本書采用Creative Commons協(xié)議發(fā)布，并托管在GitHub上，意味著您可以免費(fèi)閱讀并可以用GitHub特有的方式參與本書的維護(hù)。

如何離線閱讀

項目 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 的提交歷史可能會周期性刪除或壓縮合并，為避免執(zhí)行 git pull 更新分支時造成困惑，請對本地版本庫進(jìn)行如下設(shè)置。

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

如何編譯

預(yù)備

• Python, docutils

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

• Sphinx

  用 Sphinx 工具進(jìn)行編譯。編譯前先確認(rèn)已經(jīng)安裝 Python、docutils 及 sphinx。

• ImageMagick 及 Inkscape

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

• Git

  不解釋。

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

本書用兩個版本庫維護(hù)：

• 書稿版本庫：

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

• 圖片版本庫：

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

本書的圖片版本庫以子模組形式關(guān)聯(lián)到書稿版本庫，運(yùn)行下面命令執(zhí)行克?。?/p>

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

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

• 默認(rèn)檢出 master 分支。如果當(dāng)前非 master 分支，執(zhí)行下面命令檢出分支。

  $?git?checkout?master

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

  $ git submodule init ?$ git submodule update

編譯書稿

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

$?make?html

編譯后的網(wǎng)頁位于 _build/html 目錄下。

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

$?make

如何貢獻(xiàn)

請采用GitHub方式貢獻(xiàn)。

• 創(chuàng)建派生項目。即 Fork。

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

• 通過 GitHub 向我發(fā)送 Pull Request。

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

目錄

• 1. 探索GitHub

  • 1.1. 什么是GitHub

  • 1.2. GitHub亮點(diǎn)

  • 1.3. 探索GitHub

• 2. 加入GitHub

  • 2.1. 創(chuàng)建GitHub賬號

  • 2.2. 瀏覽托管項目

  • 2.3. 社交網(wǎng)絡(luò)

• 3. 項目托管

  • 3.5.1. 創(chuàng)建個人主頁

  • 3.5.2. 創(chuàng)建項目主頁

  • 3.5.3. 使用專有域名

  • 3.5.4. 使用Jekyll維護(hù)網(wǎng)站

  • 3.4.1. 郵件通知功能

  • 3.4.2. 和Redmine整合

  • 3.3.1. 用戶級公鑰管理

  • 3.3.2. 項目級公鑰管理

  • 3.2.1. 強(qiáng)制推送

  • 3.2.2. 新建分支

  • 3.2.3. 設(shè)置默認(rèn)分支

  • 3.2.4. 刪除分支

  • 3.2.5. 里程碑管理

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

  • 3.1.2. 版本庫初始化

  • 3.1.3. 從已有版本庫創(chuàng)建

  • 3.1. 創(chuàng)建新項目

  • 3.2. 操作版本庫

  • 3.3. 公鑰認(rèn)證管理

  • 3.4. 版本庫鉤子擴(kuò)展

  • 3.5. 建立主頁

• 4. 工作協(xié)同

  • 4.6.1. 維基初始化

  • 4.6.2. 使用維基

  • 4.6.3. 維基與Git

  • 4.5.1. 標(biāo)簽

  • 4.5.2. 里程碑

  • 4.5.3. Issue的生命周期

  • 4.5.4. Pull Requst也是Issue

  • 4.4.1. 提交評注

  • 4.4.2. 逐行評注

  • 4.3.1. 創(chuàng)建新組織

  • 4.3.2. 組織管理

  • 4.3.3. 版本庫管理

  • 4.3.4. 個人還是組織

  • 4.2.1. 版本庫授權(quán)

  • 4.2.2. 與傳統(tǒng)集中式工作模式的異同

  • 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. 組織和團(tuán)隊

  • 4.4. 代碼評注

  • 4.5. 缺陷跟蹤

  • 4.6. 維基

• 5. 付費(fèi)服務(wù)

  • 5.1. GitHub收費(fèi)方案

  • 5.2. GitHub企業(yè)版

• 6. GitHub副產(chǎn)品

  • 6.4.1. GitHub:Jobs

  • 6.4.2. GitHub:Shop

  • 6.4.3. GitHub短網(wǎng)址服務(wù)

  • 6.4.4. GitHub Open Source

  • 6.3.1. github:mac

  • 6.3.2. hub

  • 6.3.3. iOS應(yīng)用

  • 6.2.1. 用SVN操作GitHub

  • 6.2.2. 用Hg操作GitHub

  • 6.1.1. 數(shù)據(jù)的粘貼和引用

  • 6.1.2. Gist背后的Git庫

  • 6.1.3. Greasemonkey

  • 6.1.4. 命令行操作Gist

  • 6.1. GitHub:Gist

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

  • 6.3. 客戶端工具

  • 6.4. 其他

• 7. 附錄：輕量級標(biāo)記語言

?