Skip to content

CLI — UI文字列 ​

extract ​

概要: ai-i18n-tools extract

includeUiLanguageEnglishNamesが有効な場合、t("…") / i18n.t("…")リテラル、任意のpackage.json記述、および任意のバンドルマスターenglishNameエントリからstrings.jsonを更新します(ui.uiExtractorを参照。languagesManifestPathは読み取りません)。各ブロックのui-languages.jsonも再生成します。.html / .htmがui.uiExtractor.extensionsにリストされている場合は、HTMLからdata-i18n / data-i18n-title / data-i18n-placeholderマーカー文字列も抽出します。sourceRootsを持つすべてのuiブロックを走査します。--ui-blockにより、実行対象を1つのブロック(インデックス、記述、またはstringsJsonパス)に制限します。LLMの呼び出しは行いません。

関連項目: UI文字列の概要, プレーンHTMLアプリ


migrate-intlayer ​

概要: ai-i18n-tools migrate-intlayer [paths...] [--write] [--report <path>] [--content-glob <glob>] [--t-import <specifier>]

Intlayer *.content.ts 辞書を strings.json とフラットなロケール ファイルにインポートし、単純な useIntlayer / getIntlayer 呼び出しサイトを t('source string') に書き換えます。文字列は sourceLocale で記述され、任意の言語を使用できます。デフォルトではドライランです (レポートは引き続き書き込まれます)。--write はカタログをシードし、安全な書き換えを適用します。LLM は呼び出しません。

レポートは--writeが残したすべてのものの引き継ぎであり、残りの作業を順序付けたステップバイステップのTODOで締めくくられます。これには、各手動サイトに対する具体的なt()またはJSX呼び出し、import { t }行、辞書ファイルおよび後で削除するIntlayerProviderの残留ファイル、extractしてからtranslate-uiする必要があるソース文字列、そしてアプリのi18nモジュールに貼り付けて上書きするi18nextランタイムブートストラップが含まれます。ロケール制御はloadLocaleだけでなくi18n.changeLanguageも呼び出す必要があります。extractはui-languages.jsonを記述し、そのブートストラップがこれをインポートします。strings.json、フラットなロケールファイル、またはui-languages.jsonを手動で編集しないでください。

主なオプション: --write, --report, --content-glob (デフォルト **/*.content.ts), --t-import

関連情報: Intlayerからの移行


translate-intlayer ​

概要: ai-i18n-tools translate-intlayer [paths...] [-l <codes>] [--ui-block <selector>] [--dry-run] [-j <n>]

Intlayer *.content.ts 辞書内の欠落している、または古いロケールのリーフをインプレースで翻訳し、辞書を信頼できる情報源 (source of truth) として維持します。migrate-intlayer とは異なり、これはアプリを Intlayer から移行するのではなく、t({ … }) リーフを埋めるだけです。ランタイムで Intlayer を維持し、ai-i18n-tools を翻訳エンジンとして使用したい場合に使用します。

すべてのt({ … })リーフを抽出し、選択されたUIブロックのstrings.jsonにソーステキストをシードし、translate-uiと同じエンジン(プロバイダー選択、用語集、翻訳コンテキスト、およびモデルフォールバック)を実行した後、新しいロケールごとの文字列を各t({ … })オブジェクトに書き戻します。編集は正確です。欠落している、または古くなったロケール行のみが変更されるため、書式設定とコメントは保持されます。Intlayer {token} プレースホルダーは、翻訳のために{{token}}へ往復します。

リーフとロケールの組み合わせは、ロケールがリーフに存在しない場合 (欠落)、またはそのロケールの前回実行以降にソースロケールのテキストが変更された場合 (古い) に翻訳されます。古さは cacheDir で追跡されるため、そのソース文字列を編集すると、次回の実行時にそのリーフが再翻訳されます。ソース言語は sourceLocale で、任意の言語を使用できます。--dry-run は、LLM を呼び出したり何も書き込んだりせずに、欠落/古いカウントを報告します。features.translateUIStrings と UI ブロックの stringsJson (translate-ui と同じ) が必要です。

主なオプション: -l / --locale、--ui-block、--dry-run、-j / --concurrency

[paths...]: スキャン対象のファイル/ディレクトリ/グロブ (デフォルト: ブロックの sourceRoots)。-l / --locale: 埋める対象ロケール (コンマ区切り) (デフォルト: ブロックに設定された targetLocales)。--ui-block: 0ベースのインデックス、説明、または stringsJson パス (デフォルト: ブロック 0)。-j はロケールを並列化します。

関連項目: migrate-intlayer、Intlayer からの移行


mark-html ​

概要: ai-i18n-tools mark-html [paths...] [--write]

ソーステキストが1箇所(要素自体)にのみ記述されるよう、HTMLにbare data-i18n / data-i18n-title / data-i18n-placeholderマーカーを挿入します。指定されたファイル/ディレクトリ/globパターンをスキャンします(デフォルト:各ブロックのsourceRoots配下の.html / .htm)。デフォルトではドライランとなり(ファイルごとの追加数と、手動での<span data-i18n>が必要な混合コンテンツ要素を報告します)、--writeを指定すると変更が適用されます。冪等性を備え、data-i18n-ignoreに従い(要素とそのサブツリーをスキップ)、コード系要素(code、pre、kbd、samp、var)や空文字列/数値のみのテキストには干渉せず、値付きマーカーを出力することもありません。LLMの呼び出しは行いません。

主なオプション: --write

関連項目: 翻訳用のHTMLのマーキング


generate-ui-languages ​

概要: ai-i18n-tools generate-ui-languages [--master <path>] [--dry-run]

sourceLocale + targetLocalesとバンドルされたdata/ui-languages-complete.json(または--master)を使用して、ui-languages.jsonをlanguagesManifestPath(デフォルトは{ui.flatOutputDir}/ui-languages.json)に書き込みます。マスターファイルにないロケールに対して警告し、TODOプレースホルダーを出力します。カスタマイズされたlabelまたはenglishNameの値を持つ既存のマニフェストがある場合、それらはマスターカタログのデフォルトに置き換えられます。後で生成されたファイルを確認して調整してください。

主なオプション: --master, --dry-run


translate-ui ​

概要: ai-i18n-tools translate-ui [-l <codes>] [--force] [--dry-run] [-j <n>]

UI文字列のみを翻訳します(strings.json → ロケールJSON)。features.translateUIStringsが必要です。

主なオプション: -l / --locale, --force, --dry-run, -j / --concurrency

-l / --locale: カンマ区切りのターゲットロケール (デフォルト: 設定 targetLocales から sourceLocale を除く)。--force: ロケールごとにすべてのエントリを再翻訳する (既存の翻訳は無視する)。--dry-run: 書き込みなし、API呼び出しなし。-j は ロケールを並列化します。各ロケール内では、設定 uiBatchConcurrency (デフォルト 2) がLLMバッチ (50文字列のチャンク、次に複数形グループ) を並列化します。uiBatchConcurrency のCLIフラグはありません。成功した各バッチは、次のバッチが開始する前に strings.json とフラットロケールファイルに書き込まれます。sync-ui と sync のUIステップは同じ書き込みを使用します。

プレースホルダーがソースと一致しない保存済みの翻訳は、再度翻訳されます。このチェックは、名前の変更({schedule} が {cronograma} になるなど)、トークンの削除または新規作成、およびフォーマット指定の変更({price:,.2f} が {price} になるなど)を対象とします。カウントは、--dry-run を含め、バッチの前に出力されます。モデルが user-edited である行は、そのまま残され、警告のみが行われます。{state} · {title} のような、プレースホルダーと句読点のみで構成される文字列は、コピーされ、モデルには送信されません。プレースホルダーの名前を変更するバッチは拒否され、そのエラーが追加された状態でチェーン内の次のモデルが試行されます。ダッシュボードは同じ行にフラグを立て、プレースホルダーを壊す翻訳を保存する前に確認を求めます。


sync-ui ​

概要: ai-i18n-tools sync-ui [-l <codes>] [--force] [--dry-run] [-j <n>]

UI文字列を抽出してから翻訳します (features.translateUIStringsが必要)。UIのみ — ドキュメント、SVG、json[]は含みません。translate-uiと同じ-l、--force、--dry-run、-jオプション。


proofread-ui ​

概要: ai-i18n-tools proofread-ui [-l <code>] [--chunk <n>] [--dry-run] [--json] [-j <n>]

最初に extract を実行し (features.translateUIStrings が必要)、選択された各カタログがソースと一致するようにします。その後、ソースロケールのUI文字列のLLMレビュー (スペル、文法) を実行します。--ui-block は抽出とレビューを1つのブロックに制限します。用語のヒントは glossary.userGlossary CSV のみから取得されます (translate-ui と同じスコープです — UIカタログはフィードバックされないため、不適切なコピーが用語集として強化されることはありません)。アクティブなLLMプロバイダー (そのAPIキー環境変数) を使用します。

失敗時(機能フラグの未設定、抽出の失敗、カタログの欠落または無効、APIキーの欠落、あるいは全バッチの失敗)には、1 で終了します。実行が正常に完了した場合(検出結果はあくまで参考情報です)には、0 で終了します。cacheDir 配下に proofread-ui-results_<timestamp>.log を、人が読みやすい形式のレポート(概要、問題点、未レビューの行、および文字列ごとの正常行)として出力します。ターミナルには概要の件数と問題点のみが表示されます(文字列ごとの [ok] 行は出力されません)。バッチが失敗した場合、あるいはモデルの応答がバッチより短く、各スロットに利用可能な index がない場合は、該当する文字列は未レビューとしてカウントされます。短い配列が誤った文字列に適用されるのを防ぐため、これらの問題点は破棄されます。最終行にはログファイル名が出力されます。--json を指定すると、人が読みやすい形式の出力は標準エラー出力に送られます。リンクには、ダッシュボードUIの文字列リンクボタンと同様に path:line が使用されます。

主なオプション: -l / --locale, --chunk (デフォルト 50), --dry-run, --json, -j / --concurrency


export-ui-xliff ​

概要: ai-i18n-tools export-ui-xliff [-l <codes>] [-o <dir>] [--untranslated-only] [--dry-run]

strings.jsonをXLIFF 2.0にエクスポートします (ターゲットロケールごとに1つの.xliff)。読み取り専用、APIはありません。

主なオプション: -l / --locale, -o / --output-dir, --untranslated-only, --dry-run

-o / --output-dir: 出力ディレクトリ (デフォルト: カタログと同じフォルダ)。--untranslated-only: そのロケールの翻訳が欠落しているユニットのみ。

MITライセンスの下で公開されています。