ローカライズ言語貢献ガイド

新しいローカライズ言語サポートを追加する方法

ステップ 1: 言語テンプレートファイルのコピー

# lang/en.json をテンプレートとしてコピー
cp lang/en.json lang/xx.json

ここで xx は追加する言語の ISO639-1 言語コード（zh-CN、ja、ko など）です。完全な言語コードと言語名については、付録 言語コード を参照してください。

ステップ 2: テンプレートファイルの内容を更新

新しく作成した lang/xx.json ファイル、例えば lang/ja.json を編集し、すべての英語コンテンツを対象言語に翻訳します。以下は完全な 日本語 言語ファイルの例です：

{
  "name": "Japanese",
  "author": "https://github.com/your-username",
  "months": "1月|2月|3月|4月|5月|6月|7月|8月|9月|10月|11月|12月",
  "short_months": "1月|2月|3月|4月|5月|6月|7月|8月|9月|10月|11月|12月",
  "weeks": "日曜日|月曜日|火曜日|水曜日|木曜日|金曜日|土曜日",
  "short_weeks": "日|月|火|水|木|金|土",
  "seasons": "春|夏|秋|冬",
  "constellations": "おひつじ座|おうし座|ふたご座|かに座|しし座|おとめ座|てんびん座|さそり座|いて座|やぎ座|みずがめ座|うお座",
  "year": "%d 年",
  "month": "%d ヶ月",
  "week": "%d 週間",
  "day": "%d 日",
  "hour": "%d 時間",
  "minute": "%d 分",
  "second": "%d 秒",
  "now": "たった今",
  "ago": "%s前",
  "from_now": "%s後",
  "before": "%s前",
  "after": "%s後"
}

フィールド説明

フィールド	説明	例
name	ISO 言語名	"Japanese"
author	貢献者のリンク	"https://github.com/your-username"
months	完全な月名、| で区切る	"1月|2月|3月..."
short_months	短縮月名、| で区切る	"1月|2月|3月..."
weeks	完全な曜日名、| で区切る	"日曜日|月曜日|火曜日..."
short_weeks	短縮曜日名、| で区切る	"日|月|火..."
seasons	季節名、| で区切る	"春|夏|秋|冬"
constellations	星座名、| で区切る	"おひつじ座|おうし座|ふたご座..."
year	年フォーマット、単数/複数をサポート	"%d 年"
month	月フォーマット、単数/複数をサポート	"%d ヶ月"
week	週フォーマット、単数/複数をサポート	"%d 週間"
day	日フォーマット、単数/複数をサポート	"%d 日"
hour	時間フォーマット、単数/複数をサポート	"%d 時間"
minute	分フォーマット、単数/複数をサポート	"%d 分"
second	秒フォーマット、単数/複数をサポート	"%d 秒"
now	"now" の翻訳	"たった今"
ago	"ago" の翻訳	"%s前"
from_now	"from now" の翻訳	"%s後"
before	"before" の翻訳	"%s前"
after	"after" の翻訳	"%s後"

単数/複数の説明

1. 東アジア言語（中国語、日本語、韓国語など）：通常、1 つのフォーマットのみを使用

   "year": "%d 年",
   "month": "%d ヶ月"

2. 印欧語族（英語、フランス語、ドイツ語など）：単数/複数を区別する必要がある

   "year": "1 year|%d years",
   "month": "1 month|%d months"

3. スラブ語族（ロシア語、ウクライナ語など）：より複雑な複数規則がある場合がある

   "year": "1 год|2 года|3 года|4 года|%d лет"

ステップ 3: Pull Request の提出

1. ブランチの作成

   git checkout -b add-xx-language-support

2. 変更のコミット

   git add lang/xx.json
   git commit -m "add XX language support #39"

3. プッシュと Pull Request の作成

   git push origin add-xx-language-support

4. Pull Request タイトル形式

   Add XX Language Support #39

ステップ 4: テスト検証

提出前に以下を確認してください：

1. JSON フォーマットが正しい：JSON 検証ツールを使用して構文を確認
2. フィールドが完全：必要な 20 個のフィールドがすべて含まれていることを確認
3. 区切り文字が正しい：配列区切り文字として | を使用
4. プレースホルダーが正しい：数値プレースホルダーとして %d、文字列プレースホルダーとして %s を使用
5. 一貫性を保つ：翻訳スタイルが既存の言語ファイルと一貫していることを確認
6. 文化的適応性：対象言語の文化的背景と表現習慣を考慮

Carbon プロジェクトへの新しいローカライズ言語サポートの貢献に感謝します！