This is the Japanese version of Discover Meteor.
Check it out live at http://ja.discovermeteor.com/
レポジトリにissueを追加し、 @SachaG 宛てに参加の意志を伝えてください。英語版のソースへのアクセス権をもらうことができます。
https://www.discovermeteor.com/guidelinesより抜粋
- 各ファイルの先頭にある
---に囲まれた領域 (YAML frontmatter) は変更しないようにしてくださいtitlecontentversionは変更して大丈夫です
- 英語版レポジトリに含まれているファイルのみ翻訳するようにしてください (extra chaptersは翻訳しないように)
- 最終的な見た目を手元の環境で確認したい場合、Discover Meteor Staticを使ってみてください
- GitHub上でもファイルを編集できます
- 公開版に各章の進捗が出ているので、残り作業の目安にしてください
- Dockerを使ったDiscoverMeteor用のmiddleman環境を用意してみました。
- 新しいファイルの翻訳を始める時に、GitHubに新しいissueまたはプルリクエストを追加しておく
- コミットとプッシュを頻繁におこなう
- 作業を始める前にプルしておく
- レイアウトや見た目はなるべく原文に近づけるようにお願いします
- とはいえ、日本語としてすんなり読めるようにおおいに編集してください
- 質問があればチャットかGitHub issuesへ
日本語版レポジトリでは、ファイルの先頭にあるメタデータに、version: x.x という形で対応する原文のバージョンを記録しています。
バージョン番号はChangelogファイルに記録されている 1.7 などの数字を使います。そのバージョンの原文は、GitHub上からだと下のスクリーンショットにあるドロップダウンメニューで、該当する「Tag」を選ぶことで見ることができます。
翻訳する時や修正する時は、対応する英語版のソースを参照するようにしてください。
- 新規に翻訳を始める時は、最新バージョンをベースにする
- バージョンを更新する時は、対象ファイルの元バージョンと最新バージョンの差分を見ながら変更を反映する
- 翻訳・更新が終わったら
version: x.xを更新する
差分はGitHub上で確認できます。例えばバージョン 1.7 と最新版の差分は以下のURLで見られます:
https://github.com/DiscoverMeteor/DiscoverMeteor_En/compare/1.7...master
1.7と1.8を比較するならば、URLの最後を 1.7...1.8 とします。
コマンドラインでOKな方はもちろん git diff 1.7 1.8 でどうぞ。