progit2-ja

progit2-ja copied to clipboard

= Pro Git 第2版 日本語翻訳

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

• 翻訳を手伝ってみたい
• 書いてある技術的内容or日本語が間違ってるんだけど
• どうやって電子書籍データを生成してるんですか？

などなど、興味を持っていただいた方を歓迎しています。何かありましたら https://github.com/progit/progit2-ja/issues/[Issue] をたてていただくか、メンテナの https://twitter.com/harupong[@harupong] までご連絡いただければ幸いです。

== 翻訳作業のお約束

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

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

具体的な作業手順など、詳しいことは link:TRANSLATION_NOTES.asc[TRANSLATION NOTES] を確認してください。

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

////////////////////////// = Pro Git, Second Edition ////////////////////////// = Pro Git 第2版

////////////////////////// Welcome to the second edition of the Pro Git book. ////////////////////////// Pro Git 第2版へようこそ。

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

////////////////////////// Like the first edition, the second edition of Pro Git is open source under a Creative Commons license. ////////////////////////// 第1版と同様、Pro Git 第2版もクリエイティブコモンズライセンスを用いたオープンソースの本です。

////////////////////////// A couple of things have changed since open sourcing the first edition. For one, we've moved from Markdown to the amazing Asciidoc format for the text of the book. We've also moved to using O'Reilly's https://atlas.oreilly.com[Atlas platform] for generating continuous builds of the book so all major formats are always available in every language. ////////////////////////// 第1版から変わった点が2つあります。まず、MarkdownからAsciidocに本文のフォーマットを変更しました。次に、オライリーの https://atlas.oreilly.com[Atlas platform] を使って継続的に電子書籍データを生成するようにしました。これによって、主要なフォーマットの電子書籍が英語版・翻訳版問わず常に提供できるようになりました。

////////////////////////// We've also moved to keeping the translations in separate repositories rather than subdirectories of the English repository. See link:CONTRIBUTING.md[the Contributing document] for more information. ////////////////////////// また、翻訳用に言語ごとのリポジトリを設け、英語用リポジトリのサブディレクトリは廃止しました。詳しくは link:CONTRIBUTING.md[コントリビューションガイド] を確認してください。

////////////////////////// == How To Generate the Book ////////////////////////// == 電子書籍を生成するには

////////////////////////// There are two ways to generate e-book content from this source code. ////////////////////////// 2つの方法で、電子書籍データをソースコードから生成できます。

////////////////////////// The easiest way is simply to let us do it. A robot is standing by to look for new work on the main branch and automatically build it for everyone. ////////////////////////// 楽な方法は、我々に任せてしまうものです。専用のボットがメインブランチを監視していて、新しい内容が追加されるたびにデータを自動でビルドしてくれています。

////////////////////////// You can find the current builds on http://git-scm.com/book[] and more information about the builds available at https://progit.org[]. ////////////////////////// 最新のビルドは http://git-scm.com/book[] で、提供されているビルドの詳細は https://progit.org[] で確認できます。

////////////////////////// The other way to generate e-book files is to do so manually with Asciidoctor. If you run the following you may actually get HTML, Epub, Mobi and PDF output files: ////////////////////////// もうひとつのやり方は、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

//////////////////////////

$ 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

////////////////////////// This uses the asciidoctor, asciidoctor-pdf and asciidoctor-epub projects. ////////////////////////// この手順では、 asciidoctor 、 asciidoctor-pdf 、 asciidoctor-epub の3プロジェクトを使っています。

////////////////////////// == Signaling an Issue ////////////////////////// == Issueを登録する

////////////////////////// Before signaling an issue, please check that there isn't already a similar one in the bug tracking system. ////////////////////////// issueを登録する前に、似たようなissueがバグ追跡システムにないかどうか確認してください。

////////////////////////// Also, if this issue has been spotted on the git-scm.com site, please cross-check that it is still present in the pdf version. The issue may have already been corrected, but the changes have not been deployed yet. ////////////////////////// もう1点。問題があるのが git-scm.com 関連であれば、PDF版にも同じ問題があるかどうかも確認してください。解決済みだけど、まだサイトには反映されていないだけかもしれません。

////////////////////////// == Contributing //////////////////////////

////////////////////////// If you'd like to help out by making a change or contributing a translation, take a look at the link:CONTRIBUTING.md[contributor's guide]. ////////////////////////// 内容の改善や翻訳を通じて協力していただけるのであれば、まずは link:CONTRIBUTING.md[協力者向けのガイド] を確認してください。