グローバリゼーション検査

「グローバリゼーション品質管理におけるチェック機能により、国際化されたプロジェクトを世界で利用可能な状態に保ちます。この機能はタスクQAおよびプルリクエストで実行され、変更が対象とする範囲のみを読み取ります：

1. カタログ。変更によって追加または変更された文字列で、すべての言語に対応します。
2. コード。変更によって追加される行で、特定の言語や文化を前提としたテキストや書式設定が含まれます。
3. ページ。プロジェクトがアプリケーションの起動方法を指定する際、レンダリングされるページには「疑似翻訳。

ウィザードは、pull requestがマージされるとデフォルトでこのチェック機能を有効にします。その設定は品質管理 → グローバリゼーション；ワークベンチの設定この機能が有効かどうかが表示されます。

デフォルトでブロックされる項目#

文字列が欠落または破損している場合、あるいは追加されたコードが読者が直接読むテキストをコード内に埋め込んだり、断片から文を組み立てたりする場合、その変更内容は修正のために差し戻されます。それ以外の項目はすべて「指摘事項」として報告されますが、指定してブロックするまで実際にはブロックされません。書式設定、並べ替え、レイアウトに関する指摘事項も、プロジェクト固有のコードで確認されるまで報告され続けます。

何をブロックするかは「品質管理」で選択します品質管理 → グローバリゼーション：カタログコード、コード内のどの要素が変更を差し戻すのか、および修正のために変更内容が差し戻されるページ上の問題。ソースコードを確認およびページをレンダリングコード処理とページ生成のステップを無効にします。

カタログコード#

設定ファイルで指定されている場合、用語集や長さ制限、禁止用語のルールはそれぞれ独自のコードを報告します。

翻訳処理では、不要な文字列をすべての言語から削除し、ソースが存在しなくなったページの翻訳も消去します。ただし、Coroidで翻訳されたファイルのみが削除され、単一言語で存在するページは決して削除されません。

コードコード#

あらゆる市場向けのデザイン各問題の修正内容がここに示されています。

チェック項目の内容#

このコードステップはJavaScriptおよびTypeScriptを解析し、JSXやVue、Svelte、Astro、HTML、ERB、Handlebarsテンプレート、CSSもテキストとして読み取ります。ルールが適用されるのは、その文脈で指定された場合のみです。例えば郵便番号パターンは郵便番号フィールドの近くでのみ報告され、連結リストも人がそれを読む場所でのみ検出されます。

• 定義に基づいて翻訳されます。プロジェクト内の翻訳呼び出しやコンポーネント内のテキスト（t()、formatMessage、<Trans>、<FormattedMessage>、 $t()）および設定ファイルに記載された関数です。
• 決して実行しないテキスト。保護された用語や、設定ファイルで許可されている単語です。
• 意図的に除外されています。「"という行にはi18n-ignoreコメントが含まれ、その次の行にも記載されています。理由を記入してください：// i18n-ignore: product name。

オプションのworldのセクションは.coroid/i18n.json以下の設定を行います：

{
  "world": {
    "exclude": ["src/legacy/**", "scripts/**"],
    "translate": ["translateText", "i18n.translate"],
    "allow": ["Storefront", "OK"]
  }
}

検出結果と修正内容#

各検出結果はチェック実行時に保存され、タスク内の検出結果一覧に表示されます。検出された問題：カタログ別、キー別、言語別に検出結果を分類し、コードの検出結果はファイル、行、発見されたテキスト別に、ページの検出結果はページ、要素、テキスト別に整理します。同じ作業に対する最新のチェックで該当する検出結果がなくなった場合に、その検出結果は修正済みとみなされます。

プルリクエストでは、コードの検出結果も変更された行上の注釈として表示されます。ブロックする場合はエラーとして、報告のみの場合は警告として示されます。

チェックでタスクがブロックされると、開発者エージェントに各ブロッキング検出結果が渡されます。例えばsrc/pricing.tsx:7 hardcoded_text: “Simple pricing”のように、修正方法も併せて提供されます。エージェントはタスク専用の翻訳セッションを通じて翻訳を修正し、他言語のカタログを手動で編集することはありません。テキストをソースカタログに移し、組み立てられた文をプレースホルダー付きの1つのメッセージに書き換え、タスクを引き継ぐ前に自身の変更に対してコードルールを実行します。

あらゆるソースからの貢献#

誰が作成した変更でも、チェックでは同一の基準が適用されます：

• Coroidのエージェント国際化プロジェクトで作業する場合、各タスクではソースカタログと翻訳関数、文ごとの1つのメッセージ、プロジェクトのフォーマッター、右から左へ書かれる言語の論理的レイアウト、Cultureで定められた市場の慣習が指定されます。
• 人間や他のツールからのプルリクエストはCoroid Checkを通じてチェックを受け、同じ検出結果と注釈が付与されます。CoroidのGitHub Appがリポジトリにインストールされ、プロジェクトのポリシーがプルリクエスト時に対象となるすべてのpull request上で実行されます。
• チェックを通過せずにマージされた変更はマージ後に検出されます。 Coroid外でマージされた文字列を翻訳するこのチェックはpull request上で実行された結果を読み取り、pull requestで不足または古くなった文字列の翻訳タスクを作成します。コード検出でエラーが発生した場合には、以下のようなタスクも作成されます。 マージされたコードを国際化するpull requestで確認すべき箇所を一覧表示します。マージごとに各種類のタスクは最大1つまで作成されます。

既存のコードは決してブロックされません：グローバル対応それらを一覧表示し、ユーザーが選択したタイミングで修正タスクを作成します。

自分で実行する#

エンジンはコマンドラインツールcoroid-i18nであり、設定ファイルで指定されたバージョンが使用されます：

coroid-i18n check                       # catalogues
coroid-i18n source --changed main       # the code a branch adds since main
coroid-i18n check --source --changed main

sourceはカタログを読み取らずにコードを解析するため、カタログが未設定の状態でも動作します。--changedまたは--diffを使用するとリポジトリ全体が対象となります。何かが見つかった場合、両コマンドはステータスコード1で終了します。機械可読なレポートを得るには--format jsonを追加してください。

関連項目#

• グローバリゼーション
• あらゆる市場向けのデザイン
• 疑似ローカライゼーション
• グローバル対応とCulture
• 品質ポリシーとゲート
• チェック、実行、検出結果