progit2-zh-tw

progit2-zh-tw copied to clipboard

image::https://travis-ci.org/progit/progit2-zh-tw.svg?branch=master[] = Pro Git, 繁體中文第二版

歡迎您來到 Pro Git 繁體中文第二版

你可以直接在這個網址找到這本書： http://git-scm.com/book

和第一版的書一樣，第二版的書使用創用 CC 開放原始碼授權。

但是從第一版開源以後，我們做了一些修改。 舉例來說，我們已經將書的內容從 Markdown 改成了更令人的驚艷的 Asciidoc 格式。 我們也改用 O'Reilly's https://atlas.oreilly.com[Atlas 平台] 來持續編譯這本書，以便自動幫各國語系自動產生所有常用格式的書。

我們也改用不同的倉儲來保存各國翻譯版本，而不是像之前是在英文版使用子資料夾的方式保存。 請看 link:CONTRIBUTING.md[貢獻須知] 來取得更多資訊。

== 如何產生這本書

有兩種辦法可以從原始碼產生這本電子書。

最簡單的方法是交給我們處理。 有個機器人會持續監視是否有新的內容更新，並且自動從主要的分支產生這本書給每個人下載。

你可以在底下找到最新的版本，如果您需要更多資訊，請查閱 https://progit.org[]。

• https://taichunmin.gitlab.io/progit2-zh-tw/[HTML]
• https://taichunmin.gitlab.io/progit2-zh-tw/progit-kf8.epub[KF8]
• https://taichunmin.gitlab.io/progit2-zh-tw/progit.epub[EPUB]
• https://taichunmin.gitlab.io/progit2-zh-tw/progit.pdf[PDF]

另外一個辦法就是手動使用 Asciidoctor 來產生電子書， 如果你依照底下的指令，你就可以產生 HTML、Epub、Mobi 和 PDF 格式的電子書：

$ bundle install $ TRAVIS_REPO_SLUG="progit/progit2-zh-tw" 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

以上的指令使用 asciidoctor, asciidoctor-pdf 和 asciidoctor-epub 專案。

== 發出新議題

在你發出新議題之前，請先檢查在臭蟲追蹤系統中並沒有相似的議題。

以及，這個議題是否已經在 git-scm.com 網站上被提出來；請交叉確認它是否在 PDF 版本上也殘留一樣的問題。議題有可能已經被修正了，但修正好的內容可能尚未發佈。

== 貢獻本專案

如果您希望可以幫我們修改或是翻譯文件，麻煩您查看 link:CONTRIBUTING.md[貢獻須知] 及 link:TRANSLATION_NOTES.asc[翻譯須知]。