https://github.com/progit/progit2-zh-tw

https://github.com/progit/progit2-zh-tw

Last synced: 10 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/progit/progit2-zh-tw
• Owner: progit
• License: other
• Created: 2015-04-24T21:45:49.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-10-19T05:16:33.000Z (about 2 years ago)
• Last Synced: 2024-03-25T22:18:01.479Z (almost 2 years ago)
• Language: CSS
• Size: 164 MB
• Stars: 111
• Watchers: 22
• Forks: 39
• Open Issues: 6
• Metadata Files:
  • Readme: README.asc
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.asc

Awesome Lists containing this project

README

          
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[翻譯須知]。