グローバル対応と文化

国際化されたプロジェクトには、ワークベンチ内に2つのセクションがあります。国際化それらはワークベンチ内に存在します。ワールド対応性これは既に存在するコードに関するものです。文化これは販売対象となる市場に関するものです。グローバリゼーションチェック新しいコードがワールド対応性で検出された問題を増やさないようにします。

ワールド対応性#

ワールド対応性では、デフォルトブランチ上のコードが依然として特定の言語や文化を前提としている箇所を一覧表示します。Coroidは、変更に対してグローバリゼーションチェックが適用するのと同じルールでコードを読み取り、実行せずにすべての検出結果を報告します。ここでの処理で何かがブロックされることはありません。これは既存のコードであり、ユーザー自身のペースで修正できます。

このセクションには以下が表示されます：

• 検出結果、読み取られたファイル数と前回のチェック以降の変更内容が含まれます。
• 検出結果：検出種類ごとに1行ずつ、その件数が示されます。コードに記述されたテキストや部品から構成される文は「デフォルトで新しいコードによってブロックされる」とマークされます。これはグローバリゼーションチェックが変更内容を返すためです。
• ファイル：検出件数が最も多いファイルから順に表示されます。種類を選択すると該当するファイルのみが表示され、ファイルを選択すると各行とそのテキストが確認できます。

ワールド対応性を開いた際に、デフォルトブランチ上のコードが前回のチェック以降に変更されている場合、Coroidが再度チェックを実行します。再チェックが今すぐコードを読み取ります。検出件数が20,000件を超えるプロジェクトでは最初の20,000件のみが一覧表示されますが、件数にはすべての検出結果が含まれます。

検出種類と各修正方法については各市場向けの設計。意図的に除外したコードにはi18n-ignoreコメントで理由を記載し、設定ファイル内でフォルダー全体を除外することも可能です（詳細はチェックの読み取り内容)。

修正タスク#

オーナーや管理者は修正タスクを作成を検出種類ごとに選択します。Coroidがその種類に対応するタスクを1つ作成し、修正対象のファイルと行番号、修正方法を指定します。1つのタスクで扱うのは最大15ファイルまたは150件の検出結果で、問題の多いファイルから優先的に表示されるためレビューが容易です。タスクがマージされると、次回のチェックで未修正の箇所が示されます。

タスクは開始を待機します。開いている状態で再度実行を要求しても同じタスクが開かれます。その行には修正タスクが進行中か、完了したか、停止したかが表示されます。

文化#

文化では、各市場で日付・数字・通貨・住所・電話番号・氏名がどのように扱われるかを確認できます。これらの情報は公開データに基づいており、形式・カレンダー・単位・用紙サイズにはUnicode CLDR、住所や郵便番号にはGoogleのデータ、電話番号にはlibphonenumberが利用されています。読者のロケールに基づいてフォーマットするコードであれば、ほとんどの場合自動的に正しく表示されます。

上部には：

• フォーマッター：コードが読者のために数字・日付・通貨をフォーマットする方法で、例えばnext-intlのフォーマッター、react-intl、i18nextのフォーマット機能、Angularのパイプ、または単純なIntl。フォーマッターがない場合、エージェントはIntlと読者のロケールに基づいてフォーマットします。
• 市場ごとの通貨：各市場で使用される通貨です。各市場ではまずその地域の通貨が設定されます。

市場ではすべての市場を横並びで比較でき、数字・通貨・日付・時刻・週の始まりとなる日・道路距離・用紙サイズが確認できます。これらすべてで同じ瞬間と金額が使用されます。元の市場と異なる値は太字で表示されます。

市場を開くと詳細が確認できます：

ウィザードの文化ステップでフォーマッターと市場ごとの通貨を変更できます。文化（ウィザードでの変更）。これらの選択内容は設定ファイルにworld.formatterとworld.currencies、またCLI 1.14.0以降が必要です。ウィザードは古いバージョンのピンを移動させます。

エージェントへの指示内容#

国際化プロジェクトを担当する開発エージェントには、フォーマッターが渡され、各市場ごとにソース市場との差異のみが指定されます。具体的には通貨、カレンダー、数字の表記、時計、週の開始日と週末、用紙、単位、名前の順序、テキストの方向、郵便番号などです。また、郵便番号や電話番号はテキストとして保持し、電話番号はE.164形式で保存すること、市場の要件に応じて名前を分割しない限り1つのフィールドに収めること、検証時にはあらゆる文字種を許容するよう指示されます。

関連項目#

• グローバリゼーション
• グローバリゼーションのチェック
• すべての市場に対応した設計
• プロジェクトを国際化する