Core Handbook

こちらは Core Handbook の翻訳用リポジトリです。

core ディレクトリ内にある英文を翻訳していきます。

ブラウザ上で翻訳したいmdファイルをクリックし、鉛筆マークの「Edit this file」をクリックすることでブラウザ上でも更新（プルリクエスト）できます。

翻訳の始め方

1. 翻訳したいページに該当する原文に該当するURLを明記して翻訳を開始する旨のIssueを立ててください。
2. 翻訳開始の前に原文が更新されてないか目視でざっくりで良いので確認してから作業を始めていただけると助かります。

翻訳方法

原文例：

# Welcome

手順：

1. 原文をコメントアウトします。

   <!--
   # Welcome
    -->
   

   <!-- の後ろと、--> の前には半角スペースと改行を入れてください。翻訳の最小単位 (コメントアウトの単位) は段落 (空行から空行まで) でお願いします。
2. コメントアウトした原文の下に翻訳を追加します。

   <!--
   # Welcome
    -->
   # ようこそ
   

3. main ブランチにプルリクエストします。

• プルリクエストを送る際の説明欄に、"fixes #[Issue 番号]" ([] は不要) というフォーマットで作成した Issue を記述すると、プルリクエストがマージされる際に自動で Issue が閉じられるので便利です。

GitHub が初めての方も 翻訳開始から提案までの流れ を参考に、是非ご参加ください。

翻訳のルール

翻訳を始める前に、WordPress 翻訳ハンドブック に目をお通しください。

翻訳の表記ゆれなど、その他迷った時は Issue を立てるか、 WordPress 日本語 Slack の docs チャンネルまでご相談ください。

原文更新方法

1. en ブランチから en20210905 などのブランチを作成します。
2. 原文を更新します。wp-handbook-converterを使うことをオススメします。

npx wp-handbook-converter core --sub-domain make

3. en ブランチにプルリクエストします。差分を確認して問題なければマージしてください。

en ブランチには翻訳を含めないでください。

4. en から main にプルリクをおくります。差分を確認し、問題なければ、 main にマージし、更新完了です。enブランチは削除しないでください。