まだ作業途中のため問題点や齟齬がある可能性があります。何かあった場合はご指摘をお願いします。
README.md にある通りですが、さらなる簡略版は以下の通りです。
- Git, Node, Yarn をそれぞれ準備して ja.reactjs.org (のフォーク)をクローン
yarnで依存物をインストール（yarn.lockが更新された場合は適宜これをくり返す）yarn devでローカルウェブサーバーが立ち上がるのを確認contentの中身の Markdown ファイルをテキストエディタで編集- ブラウザで確認
当面は reactjs#4 を参照しつつ、他の人と被らないように配慮しながら作業を行ってください。
yarn lint:text で、基本的な文法（全角英数を使わない、句読点の統一）チェックが走ります。
コミット・PR作成の前にはエラーが出ないようにしてください。
-
「です」「ます」調で書く（箇条書きの中など特殊な文脈を除く）。
-
カッコは内部に和文を含む場合は全角、英数字のみ含む場合（特に原文の単語を示す場合など）は半角とする。
-
半角開きカッコの前と半角閉じカッコの後には半角スペースを入れる。ただし別の約物と直接隣接している場合は不要。
避難ハッチ␣(escape hatch)␣を（必要に応じて）利用します。 -
英数字と和文との間には半角スペースを入れる。ただし他の約物（特に句読点 。, 、）と直接隣接している場合は不要。
React␣の␣API␣で、`fooBar`␣を␣1␣回実行。 -
和文内で文の一部として使う記号・約物類は原則全角とする。
「,」,、,。,：,！,？,／などが該当する。 -
用例の直前の行で行末に現れるコロンについても全角とする。ただしこれは毎回使うべきというわけではない。文が途切れる場合は
：が必要だが、不自然にならないのであれば、句点。で終えても構わない。 -
英文から飛躍した意訳や表現の追加・改変を行わない。一方で分かりづらくなるような逐語訳もしない。
-
ひとまず、リンク先の URL は変えない。(MDN などについては後でまとめて日本語版へのリンクに置換するかもしれませんが、まとめてやる方が間違いも少ないと思われるので、気にしないでいいです)
-
#で始まる見出しを翻訳すると現時点では自動生成されるアンカー (<a id="#...">) が変わってしまい、ページ内の見出しへのリンクが壊れてしまうが、これもひとまず気にしないでおく。（これについては こちら で検討中です） -
和文に対する
*強調*（<em>強調</em>に変換される）がうまく表示されない（日本語フォントに斜体が適用されないため）が、ひとまず原文通りに強調を残す形で翻訳する。（恐らく CSS を弄って解決できるはず） -
ごく一般的な日本語表記に関して困ったら概ね公用文作成の要領などに準ずるが、カタカナ語の末尾の長音符については JIS Z 8301 の推奨に従う。そこまで目くじらを立てなくてよいが、基本は要するに以下の通り。
- 3音以上の場合のみ、片仮名語の末尾の長音符を原則省略。「エコー」「マナー」「ハンドラ」「プロパティ」
- ただし「レンダー」だけは例外で、常に「レンダー」と伸ばす。
- 補助動詞（～てください・～てみる・～ておく・～てくる・～てしまう、など）はかな書き。
- 語彙化した副詞はなるべくかな書き。「ついに」「まれに」「ときに」「ようやく」「おそらく」など。
作成中です。
ひとまず reactjs#3 を参照してください。