Skip to content

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をその場で翻訳する

仕組み ​

  1. コマンドラインインターフェイスをインストールし、プロバイダーの認証キーを設定します: インストール。
  2. init を実行して ai-i18n-tools.config.json を書き込みます: クイックスタート。
  3. プロジェクトを準備します: 文字列を t() でラップする、サイト用フレームワークの国際化機能を有効にする、またはREADMEに言語リストマーカーを追加します。
  4. sync を実行します。テキストを抽出し、新しい内容を翻訳して、出力を書き込みます。
  5. 出力をアプリまたはサイトで読み込み、言語切り替え機能を追加し、ソースが変更されたら 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
アプリに付随するリポジトリのREADMEconsole-app, nextjs-app
Pythonアプリpython-streamlit, python-fastapi, python-gettext
.NET ヘルパーdotnet-console、dotnet-resx
ドキュメントサイトdocusaurus-docs, vitepress-docs, astro-docs
ウェブサイトまたはプレーンHTMLastro-website, plain-html

全リストとnpx degitのコピーコマンドについては、サンプルをご覧ください。

次のステップ ​

  1. インストール — npm パッケージをインストールするか、Python プロジェクト用に スタンドアロン実行可能ファイル をダウンロードして、プロバイダーの API キーを設定します。
  2. クイックスタート — 設定の雛形を作成し、最初の翻訳を実行します。
  3. LLM プロバイダー — プロバイダーと API キーを選択し、-P で上書きします。
  4. AI モデル — suggest-models またはダッシュボードの モデル タブで候補リストをランク付けし、翻訳が失敗した場合に次のモデルを試せるように、複数のモデルを保持します。

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