翻訳のお手伝いは大歓迎です。以下の2点を踏まえ、ぜひご協力いただければと思っています。
-
作業を始めるときは意思表示をしてください
-
既訳を尊重してください
具体的な作業手順など、詳しいことは TRANSLATION NOTES を確認してください。
（Below is the translation of original README.asc in English. 以下は英語READMEの翻訳です。）
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がバグ追跡システムにないかどうか確認してください。
もう1点。問題があるのが git-scm.com 関連であれば、PDF版にも同じ問題があるかどうかも確認してください。解決済みだけど、まだサイトには反映されていないだけかもしれません。
内容の改善や翻訳を通じて協力していただけるのであれば、まずは 協力者向けのガイド を確認してください。