小さな貢献をしたい場合は、クイックスタートガイドを読んでみてください。
資料を翻訳する前に、翻訳者のガイドラインと、行動規則を、読んでください
また、私たちのSlackワークスペースに参加してください。 #swcarpentryのSlackチャンネルもあります。 ここは、翻訳を進める上で発生する疑問に関して質問するのに最適の場所です。
ツイッターでswcarpentry-jaも更新の発表をやっています。ぜひフォローしてください。
レポジトリは、ソフトウェアカーペントリーのレッスンを英語から他の言語(現在日本語に取り組んでいます)へ翻訳するのを容易にするために必要なファイルやツールをホストするためにあります。また、英語とスペイン語のレッスンの多言語化をしてマージするためでもあります。
ソフトウェアカーペントリーのメインのウェブサイトが他の言語と一緒にホストされ互換性があり、英語のレッスンの新しいリリースに合わせて日本語のレッスンも最新に維持するように計画しています。
私達は、ソフトウェアカーペントリーのオリジナルのレッスンを改定するのではなく、レッスを翻訳(そして最新の状態に維持)をしています。
もしあなたが、レッスン自体の問題に気づいたら、英語のレッスンに対して、issueをたてたり、プルリクエストを送ってください。
ここでは、あなたが、GitとGitHubについて知っているという仮定をしています。
もし、gitをインストールするのに手助けが必要ならば、gitのインストールガイドを読んでみてください
各レッスンのテキストを直接翻訳するのではなく、翻訳には、PO ファイルを使います。
POファイルは、複数のエントリで構成されるテキスト形式のファイルです。各エントリーは、元のテキストと、その翻訳の短い部分が含まれています。オリジナルのレッスンごとに、1つのPOファイルがあります。例えば、Software Carpentry 'git novice' lessonは、複数の markdown形式のドキュメントで構成され、日本語の翻訳に関しては1つの git-novice.ja.po
というPOファイルがあります。これにより、手動ではなく、オリジナルのテキストの追跡を行うことができ、オリジナルのレッスンが更新されたときに、変更され翻訳が必要とされる部分を正確に把握することができます。無料のPOエディタは、いくつかあります: PoEdit,GTranslator, Lokalize. これらのいずれかを使用して、POファイルを翻訳することをお勧めします。
レッスンはサブモジュールとしてインポートされます。この作業はレッスンにつき1度だけ行われ、ほとんどの翻訳者はこれを行う必要はありません。もし、あなたが新しいレッスンをインポートしたいときには、インポートのガイドを参照してください。
これは、翻訳者からの手助けが最も必要なタスクです!
これは、インポートのガイドで説明されているように、swcarpentry-ja/i18n
がサブモジュールとして既に追加されていることを前提としています。あなたは、そのレッスンの翻訳に貢献したいとします。
-
個人のGitHubアカウントで、このレポジトリの"フォーク"を作成します。 (
https://github.com/swcarpentry-ja/i18n
の右上の"フォーク(fork)"をクリックします。 corner of thehttps://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
で見つけることができます。
レッスンの(完全な)翻訳が存在しても、メインの英語のレッスンが新しくリリースされることがあります。 更新されたバージョンの英語のレッスンは、現在の翻訳されたものにマージされる必要があります。
レッスン更新時のガイドを見てください。
レッスンを編集するときには翻訳者のためのガイドラインに従ってください。
レッスン間で用語が一貫して使われていることを確認するために 技術用語のリスト があります。必要に応じてこれを参照したり更新したりしてください。
一貫性を担保するために、日本語に翻訳されない概念などの標準化された取り扱いについては、 カルチャーノート を参照してください。
進捗と、ゴールを記録するために変更履歴を持っています。
メンテナーと管理者のガイド を見てください
ご協力いただきありがとうございます。たとえ小さな貢献であっても、大歓迎です。