翻訳

翻訳とは、英語のファイルを自分の言語のフォルダーの同じパスにコピーし、テキストだけを翻訳したものです。どの言語に現れた事実も、ほかのすべての言語に反映されます

ミラーリングされたパス

すべてのページは、どの言語フォルダーでも同じパス、同じファイル名に置かれます：

en/docs/2_editor/4_craft/3_difficulty-curve.md
ru/docs/2_editor/4_craft/3_difficulty-curve.md
zh/docs/2_editor/4_craft/3_difficulty-curve.md
ja/docs/2_editor/4_craft/3_difficulty-curve.md
ko/docs/2_editor/4_craft/3_difficulty-curve.md
es/docs/2_editor/4_craft/3_difficulty-curve.md
fr/docs/2_editor/4_craft/3_difficulty-curve.md

変更しないもの：

• ファイル名とすべてのフォルダー名（プレフィックスを含む）
• frontmatterのdateとtags（titleは翻訳します）
• [[wiki-links]]：リンク先はファイル名で、すべての言語で同じです
• 外部リンク、画像名、コードブロック、インラインコード：ファイル、フィールド、キー、値、コマンド
• 構造：同じ見出しを同じ順序で、同じリスト、表、コールアウト

コールアウトのタイトルはページの言語に翻訳します。詳細：スタイルガイド

英語はフォールバック

ある言語にページがない場合、サイトは注記付きで英語のページを表示します。逆は機能しません：ru/にしかないページは、英語の読者には404になります

すべての言語がすべての事実を持つ

英語が主導するのはアドレスだけで、内容ではありません。事実はどの言語に先に現れてもよく、その後ほかのすべての言語に反映されます。変更後は、どのバージョンも、すべてのバージョンが知っていることをすべて含みます

• 追加はしても、削除はしない。不足している情報は、それが欠けているすべての言語に書き加えます
• 矛盾は推測で解決しない。2つのバージョンで数値が違う、または主張が正反対？ソース（ゲーム、SDK）を確認し、pull requestで問題を提起してください
• 確認なしには何も削除しない。古く見えるテキストも同じです

言い回しの違いは問題ではありません。読者が知る内容の違いが問題です

バージョンの比較

リポジトリには、Claude Code用のスキルcompare-translations（.claude/skills/内）があります。このスキルがこの比較を行います。スキルがない場合は、同じ2つのパスを手作業で行ってください

構造のパスでは、バージョンを要素ごとに比較します：frontmatter、H1、最初の段落、見出し、段落の数、リスト項目、表の行、コールアウト、リンク先、画像、コード

意味のパスでは、各セクションを並べて読み、一方のバージョンにあってもう一方にない事実を探します：数値と単位、フィールド・ボタン・キーの名前、条件と例外、警告、手順のステップとその順序、例

繁体字中国語は自動生成

zh-Hant/は手作業では翻訳しません。スクリプトがzh/から変換します：OpenCC、台湾の語彙を用いた繁体字です。繁体字中国語のページの修正はzh/のページに加えれば、次の変換で反映されます。zh-Hant/を直接編集しても上書きされます

新しい言語

新しい言語は、すべてこのリポジトリ内で追加でき、サイトのコードは変わりません：

1. frontend/en.yamlをfrontend/<code>.yaml（例：frontend/de.yaml）にコピーし、値を翻訳します。これはサイト自身の文字列です：メニュー、ボタン、検索、Cookieバナー。キーとすべての{name}はそのまま残してください
2. en/、ru/、zh/、zh-Hant/、ja/、ko/、es/と同じ階層に<code>/フォルダーを作成し、そこにページを翻訳します。翻訳のないページは注記付きで英語で表示されます

キーにone / few / many / otherの形がある場合、そのキーは数に依存します。言語に必要なすべての形を用意してください。足りない形はビルドが示します。未翻訳のキーは英語で表示されます。ビルドはそのようなキーを警告として一覧表示します

大規模な翻訳を始める前に、2人が同じものを翻訳しないよう、bullet-hero/docsでissueを開いてください