ProGit2 簡體中文翻譯

jopen 10年前發布 | 27K 次閱讀 ProGit2 Git 版本控制系統

歡迎閱讀 Pro Git 第二版。

您可以在以下地址找到本書的在線版本: http://git-scm.com/book

與第一版類似,Pro Git 第二版以知識共享協議開放源代碼。

自第一版開源以來,許多事情都發生了改變。其一,我們將本書的文本由 Markdown 遷移至 Asciidoc。同時,我們還開始使用 O’Reilly 的 Atlas平臺生成本書的持續構建,所以,所有主要格式在每種語言都是一致的。

我們還在獨立的資源庫中進行翻譯,而不是在英文資源庫的子目錄中。詳見翻譯部分。

貢獻

為向本資源庫貢獻勘誤表或新的內容,您需要開啟一個 GitHub 的 Pull Request。一般地,一個比較好的做法是,在進行任何大的改變之前,先開啟一個問題(issue)并且確保您的工作能夠被接受。

如果我們認為有助于內容的改進,勘誤表和說明都會被接受。您也可以開啟一個問題,以便我們能夠找出如何或者這個問題是不是能夠被定位。

請對那些徹底的內容審查修改保持克制,因為那些修改通常不會被接受,我們不希望浪費您的時間。這種修改通常非常主觀,只能提供給少部分人閱讀,接受它們并不值得。書中內容已經經過多次專業的內容審查,所以您可能有一些比我們更好的文風和語法,但是您的個人討論不大可能比本文的闡述好得多,從而導致我們需要修改本書的大部分內容。

如何生成本書

有兩種辦法可以通過源代碼生成電子書。

最簡單的辦法是讓我們去做這個工作。我們有一個機器人時刻準備著,尋找主分支上的新工作,為每個人自動構建。

您可以在 http://git-scm.com/book找到當前構建,詳情請見 https://progit.org

另一個生成電子書文件的方法是使用 Asciidoctor 手動完成。如果您運行下面的命令,您可能獲得 HTML、Epub、Mobi 和 PDF 輸出文件:

$ bundle install
$ bundle exec rake book:build
Converting to HTML...
 -- HTML output at progit.html
Converting to EPub...
 -- Epub output at progit.epub
Converting to Mobi (kf8)...
 -- Mobi output at progit.mobi
Converting to PDF...
 -- PDF  output at progit.pdf

這些命令使用了asciidoctorasciidoctor-pdfasciidoctor-epub項目。

翻譯

我們非常鼓勵將本書翻譯成其它語言,但是與第一版相比有一些區別。現在,我們將每一個翻譯放在一個獨立的資源庫,通過 Atlas 自動構建輸出文件。這與上一版非常不同。

由于每一個翻譯都是不同的資源庫,我們就能夠為每一個項目指定不同的維護人員。Pro Git 團隊只需要進行拉取操作,并且為每一個翻譯團隊進行構建。為了進行自動構建,翻譯的資源庫需要添加到 GitHub上的progit組織

您可以在 http://progit.org/translations找到所有當前翻譯的信息以及如何開始您自己的翻譯。

圖表

本書中的圖表使用 Sketch 3生成, 包含sketchbook文件

添加圖表:

  1. 向sketchbook添加新頁,盡可能使用已經包含的符號。

  2. 向您的頁面添加“切片”,并給它一個相對于源代碼根目錄的與目標PNG文件名一致的名字。

  3. 確保您的切片以3x的尺寸導出。

項目主頁:http://www.baiduhome.net/lib/view/home/1415926870164

 本文由用戶 jopen 自行上傳分享,僅供網友學習交流。所有權歸原作者,若您的權利被侵害,請聯系管理員。
 轉載本站原創文章,請注明出處,并保留原始鏈接、圖片水印。
 本站是一個以用戶分享為主的開源技術平臺,歡迎各類分享!