silverskyvicto / progit2-ja

Pro Git 第2版 日本語翻訳

このリポジトリを使って、Pro Git第2版の日本語翻訳作業を進めています。

• 翻訳を手伝ってみたい

• 書いてある技術的内容or日本語が間違ってるんだけど

• どうやって電子書籍データを生成してるんですか？

などなど、興味を持っていただいた方を歓迎しています。何かありましたら Issue をたてていただくか、メンテナの @harupong までご連絡いただければ幸いです。

翻訳作業のお約束

翻訳のお手伝いは大歓迎です。以下の2点を踏まえ、ぜひご協力いただければと思っています。

1. 作業を始めるときは意思表示をしてください

2. 既訳を尊重してください

具体的な作業手順など、詳しいことは TRANSLATION NOTES を確認してください。

---

（Below is the translation of original README.asc in English. 以下は英語READMEの翻訳です。）

Pro Git 第2版

Pro Git 第2版へようこそ。

この本はネット上でも閲覧できます。 http://git-scm.com/book

第1版と同様、Pro Git 第2版もクリエイティブコモンズライセンスを用いたオープンソースの本です。

第1版から変わった点が2つあります。まず、MarkdownからAsciidocに本文のフォーマットを変更しました。次に、オライリーの Atlas platform を使って継続的に電子書籍データを生成するようにしました。これによって、主要なフォーマットの電子書籍が英語版・翻訳版問わず常に提供できるようになりました。

また、翻訳用に言語ごとのリポジトリを設け、英語用リポジトリのサブディレクトリは廃止しました。詳しくは コントリビューションガイド を確認してください。

電子書籍を生成するには

2つの方法で、電子書籍データをソースコードから生成できます。

楽な方法は、我々に任せてしまうものです。専用のボットがメインブランチを監視していて、新しい内容が追加されるたびにデータを自動でビルドしてくれています。

最新のビルドは 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

この手順では、 asciidoctor 、 asciidoctor-pdf 、 asciidoctor-epub の3プロジェクトを使っています。

Issueを登録する

issueを登録する前に、似たようなissueがバグ追跡システムにないかどうか確認してください。

もう1点。問題があるのが git-scm.com 関連であれば、PDF版にも同じ問題があるかどうかも確認してください。解決済みだけど、まだサイトには反映されていないだけかもしれません。

内容の改善や翻訳を通じて協力していただけるのであれば、まずは 協力者向けのガイド を確認してください。