ai-i18n-tools とは
アプリ、ウェブサイト、ドキュメントサイト、またはリポジトリのREADMEが1つの言語で書かれており、それを多言語化したいと考えているとします。その言語はsourceLocaleであり、どの言語でもかまいません。このガイドでは、英語が一般的な例です。ai-i18n-toolsはテキストを検索し、選択したLLMプロバイダーのモデルで翻訳し、プロジェクトがすでに読み込んでいるファイルに書き込みます。すべての結果をキャッシュするため、再実行時には新規または変更されたテキストのみがモデルに送信されます。
あなたが行うこととツールが行うこと
| ユーザー | ツール |
|---|---|
| 言語、プロバイダー、試行するモデルを選択 | テキストを抽出し、翻訳し、結果を検証して、カタログまたはページを書き込みます |
ユーザー向けテキストをツールから見えるようにする: アプリコード内の t() 呼び出し、サイト用フレームワーク標準の国際化機能、またはREADME内の言語リストマーカー | 翻訳をキャッシュし、再実行のたびに再利用する |
| 結果をアプリ、サイトのルーティング、またはREADMEの言語行に接続します | 進捗を表示し、ダッシュボードで翻訳を確認できます |
ツールは、migrate-python-i18n または migrate-dotnet-i18n を --write と一緒に実行しない限り、ソースを書き換えません。ラッピングステップのために、コーディングエージェントのプロンプトが提供されます。i18next やサイトフレームワークの i18n をインストールしたり、言語スイッチャーを構築したりすることはありませんが、そのためのランタイムヘルパーは提供されます。
どこから始めればよいですか?
ウォークスルーは プロジェクトに国際化を追加する にまとめられており、共通セットアップとプロジェクトの種類ごとのページがあります。行を選択してください:
| 対象 | ここから開始 |
|---|---|
| ソース内にプレーンテキストがあるジェイエス/ティーエスアプリ(React、Next.js、Node、コマンドラインインターフェイス) | ジェイエス/ティーエスアプリに国際化を追加する |
| Pythonアプリ (Streamlit、FastAPI、Flask、デスクトップ、スクリプト) | Pythonアプリにi18nを追加する |
| .NET アプリ (Avalonia、WPF、MAUI、ASP.NET、Blazor、コンソール) | .NET アプリに i18n を追加する |
すでに ResourceManager または IStringLocalizer を使用している .NET アプリ | .NET ResourceManager アプリに i18n を追加する |
| Djangoアプリ、Flask-Babelカタログ、またはGNU gettextを既に利用しているアプリ | Django / Python gettextアプリにi18nを追加する |
| ウェブサイトまたはドキュメントサイト(VitePress、Docusaurus、Starlight、Nextra、Fumadocs、Astro、プレーンHTML) | ウェブサイトまたはドキュメントサイトに国際化を追加する |
| リポジトリのREADMEとその他のマークダウン形式ファイル(通常はアプリの隣) | READMEとマークダウン形式のドキュメントに国際化を追加する |
| スタンドアロンのネストされたJSONロケールファイル | JSON |
| テキストラベルを含むSVG図 | SVG翻訳 |
| Intlayer辞書(Intlayerから移行) | Intlayerからの移行 |
| Intlayer辞書(Intlayerを維持し、その場で翻訳) | Intlayerをその場で翻訳する |
仕組み
- コマンドラインインターフェイスをインストールし、プロバイダーの認証キーを設定します: インストール。
initを実行してai-i18n-tools.config.jsonを書き込みます: クイックスタート。- プロジェクトを準備します: 文字列を
t()でラップする、サイト用フレームワークの国際化機能を有効にする、またはREADMEに言語リストマーカーを追加します。 syncを実行します。テキストを抽出し、新しい内容を翻訳して、出力を書き込みます。- 出力をアプリまたはサイトで読み込み、言語切り替え機能を追加し、ソースが変更されたら
syncを再実行します。
翻訳モード
内部では、ツールは4つのパイプラインを実行します。設定で必要なものを有効にし、sync がそれらを順番に実行します。
- UI文字列 — JS/TS および Python から
t("…")および_()の呼び出しを抽出し、C# および XAML からT("…")/{loc:Tr '…'}を抽出し (GNU gettext および .NET.resxサテライトを含む)、フラットなロケールごとの JSON、.po/.mo、または.resxを書き込みます。コマンド:extract、translate-ui、migrate-dotnet-i18n。ガイド: UI文字列。Python: Pythonアプリケーション。.NET: .NETアプリケーション および .NET ResourceManager アプリに i18n を追加する。 - ドキュメント —
docs[].contentPathsにリストされている Markdown、MDX、および.astroページを翻訳します。VitePress、Starlight、Docusaurus、Nextra、Fumadocs、Astro、およびその他の静的ドキュメントサイト、ならびにリポジトリの README (docsOutput.styleのflat) と連携します。コマンド:translate-docs。ガイド: ドキュメント および README と Markdown ドキュメントに i18n を追加する。 - JSON — トップレベルの
json[]で定義されているネストされた JSON ロケールバンドル (テーマラベル、i18n オーバーライド、ソースにないアプリコピー) を翻訳します。コマンド:translate-json。ガイド: JSON。 - SVG — SVG イラスト内の表示テキスト (
<text>、<title>、<desc>) を翻訳し、ロケールごとに1つの出力ファイルを書き込みます。ドキュメント翻訳とは別です。コマンド:translate-svg。ガイド: SVG翻訳。
多くのプロジェクトではモードを組み合わせて使用します。一般的な組み合わせは、UI文字列とリポジトリのREADMEです。VitePressなどのドキュメントサイトも、よくある組み合わせです。詳しくは、パイプラインの組み合わせとREADMEとMarkdownドキュメントにi18nを追加するをご覧ください。
例
このリポジトリには、examples/配下に実行可能なサンプルプロジェクトが含まれています。各プロジェクトには、それぞれ独自の設定、コミット済みのロケール出力、READMEがあります。APIキーがなくても翻訳済みファイルを確認できますが、翻訳を再実行するにはプロバイダーキーが必要です。
| 対象 | 例 |
|---|---|
| JS/TSアプリ | console-app, nextjs-app |
| アプリに付随するリポジトリのREADME | console-app, nextjs-app |
| Pythonアプリ | python-streamlit, python-fastapi, python-gettext |
| .NET ヘルパー | dotnet-console、dotnet-resx |
| ドキュメントサイト | docusaurus-docs, vitepress-docs, astro-docs |
| ウェブサイトまたはプレーンHTML | astro-website, plain-html |
全リストとnpx degitのコピーコマンドについては、サンプルをご覧ください。
次のステップ
- インストール — npm パッケージをインストールするか、Python プロジェクト用に スタンドアロン実行可能ファイル をダウンロードして、プロバイダーの API キーを設定します。
- クイックスタート — 設定の雛形を作成し、最初の翻訳を実行します。
- LLM プロバイダー — プロバイダーと API キーを選択し、
-Pで上書きします。 - AI モデル —
suggest-modelsまたはダッシュボードの モデル タブで候補リストをランク付けし、翻訳が失敗した場合に次のモデルを試せるように、複数のモデルを保持します。