Internationalisation of carpentry lessons（カーペントリーのレッスンの国際化）

English README

小さな貢献をしたい場合は、クイックスタートガイドを読んでみてください。

資料を翻訳する前に、翻訳者のガイドラインと、行動規則を、読んでください

また、私たちのSlackワークスペースに参加してください。 #swcarpentryのSlackチャンネルもあります。ここは、翻訳を進める上で発生する疑問に関して質問するのに最適の場所です。

ツイッターでswcarpentry-jaも更新の発表をやっています。ぜひフォローしてください。

目的

リポジトリは、ソフトウェアカーペントリーのレッスンを英語から他の言語(現在日本語に取り組んでいます)へ翻訳するのを容易にするために必要なファイルやツールをホストするためにあります。また、英語とスペイン語のレッスンの多言語化をしてマージするためでもあります。

ソフトウェアカーペントリーのメインのウェブサイトが他の言語と一緒にホストされ互換性があり、英語のレッスンの新しいリリースに合わせて日本語のレッスンも最新に維持するように計画しています。

私達は、ソフトウェアカーペントリーのオリジナルのレッスンを改定するのではなく、レッスを翻訳（そして最新の状態に維持）をしています。

もしあなたが、レッスン自体の問題に気づいたら、英語のレッスンに対して、issueをたてたり、プルリクエストを送ってください。

gitについて

ここでは、あなたが、GitとGitHubについて知っているという仮定をしています。

もし、gitをインストールするのに手助けが必要ならば、gitのインストールガイドを読んでみてください

About PO files

各レッスンのテキストを直接翻訳するのではなく、翻訳には、[PO ファイル](https://www.gnu.org/software/gettext/manu al/html_node/PO-Files.html)を使います。

POファイルは、複数のエントリで構成されるテキスト形式のファイルです。各エントリーは、元のテキストと、その翻訳の短い部分が含まれています。オリジナルのレッスンごとに、１つのPOファイルがあります。例えば、 [Software Carpentry 'git novice' lesson](https://github.com/swcarpentry/git-nov ice)は、複数の markdown形式のドキュメントで構成され、日本語の翻訳に関しては１つの git-novice.ja.po というPOファイルがあります。これにより、手動ではなく、オリジナルのテキストの追跡を行うことができ、オリジナルのレッスンが更新されたときに、変更され翻訳が必要とされる部分を正確に把握することができます。無料のPOエディタは、いくつかあります: PoEdit,[GTranslator](https://wiki .gnome.org/Apps/Gtranslator), Lokalize. これらのいずれかを使用して、POファイルを翻訳することをお勧めします。

初めてレッスンをインポートするとき

レッスンはサブモジュールとしてインポートされます。この作業はレッスンにつき１度だけ行われ、ほとんどの翻訳者はこれを行う必要はありません。もし、あなたが新しいレッスンをインポートしたいときには、インポートのガイドを参照してください。

既存のレッスンの翻訳へ貢献する

これは、翻訳者からの手助けが最も必要なタスクです!

これは、インポートのガイドで説明されているように、swcarpentry-ja/i18nがサブモジュールとして既に追加されていることを前提としています。あなたは、そのレッスンの翻訳に貢献したいとします。

個人のGitHubアカウントで、このリポジトリの"フォーク"を作成します。 (https://github.com/swcarpentry-ja/i18nの右上の"フォーク(fork)"をクリックします。 corner of the https://github.com/swcarpentry-ja/i18n webpage)
個人のアカウント(GitHubUserなど)で、このリポジトリをクローンします。これは、翻訳ファイルのバージョン管理するためのローカルコピーです

cd directory
git clone git@github.com:GitHubUser/i18n.git
cd i18n

サブモジュールを使えるようにする.

git submodule init
git submodule update

このリポジトリはすでに、レッスンの翻訳ファイルが含まれています。翻訳に貢献したいときには、 po ディレクトリの中の <レッスン名>.<言語>.po 、例えば git-novice.ja.po に貢献することができます。

cd po
ls git-novice.ja.po

POファイルを編集します。ガイドラインに従って, 頻繁に変更をコミットし、十分だとおもったらpull request を投稿してください。
正確を期すために、あなたのPRについて、レビューが行われます。レビューがパスするまで、編集を続けます。そのようなときは、まずはじめに、組織のリポジトリに対する変更を pull してください。

git checkout ja
git remote add swc-ja git@github.com:swcarpentry-ja/i18n.git
git pull swc-ja ja

PRがレビューをパスするまでステップ4と5を繰り返します

いくつかのメモ:

POファイルを編集しても、翻訳されたWebサイトができあがるわけではありません。メンテナーと管理者ガイドで述べられているように、これはメンテナーに任されています。

POファイルを編集したあと、翻訳された Markdown ファイルを見たいときには、 bash po4gitbook/compile.sh を実行します。これは、あなたの変更を含めた翻訳されたバージョンを生成します。これは、locale/<lang>/<lesson>, 例, locale/ja/git-noviceで見つけることができます。

メインの英語のレッスンが新しくリリースされたら、レッスンを更新するのに貢献する

レッスンの(完全な)翻訳が存在しても、メインの英語のレッスンが新しくリリースされることがあります。更新されたバージョンの英語のレッスンは、現在の翻訳されたものにマージされる必要があります。

レッスン更新時のガイドを見てください。

翻訳のためのリソース

レッスンを編集するときには翻訳者のためのガイドラインに従ってください。

レッスン間で用語が一貫して使われていることを確認するために技術用語のリストがあります。必要に応じてこれを参照したり更新したりしてください。

一貫性を担保するために、日本語に翻訳されない概念などの標準化された取り扱いについては、カルチャーノートを参照してください。

進捗と、ゴールを記録するために変更履歴を持っています。

メンテナーと管理者のガイド

メンテナーと管理者のガイドを見てください

ご協力いただきありがとうございます。たとえ小さな貢献であっても、大歓迎です。

swcarpentry-ja / i18n