Giter Club home page Giter Club logo

progit2-ja's Introduction

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

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

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

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.