Skip to content

ai-i18n-tools単一言語のプロジェクトを多言語化。

ガイド付きセットアップと AI 翻訳を使用して、アプリ、ウェブサイト、またはリポジトリのドキュメントに言語を追加します。プロバイダーとモデルを選択し、プロジェクトの成長に合わせてキャッシュされた翻訳を再利用します。

ai-i18n-tools ロゴ

既存のプロジェクトから始める ​

現在は単一言語ですか?ここから始めましょう。その言語はどの言語でもかまいません。sourceLocale として設定してください。このガイドでは、一般的な例として英語を使用します。国際化 (i18n) は、プロジェクトがさまざまな言語をサポートするための準備です。このガイドでは、セットアップから最初の翻訳体験までを案内します。これには、GitHub、GitLab、またはその他のホストでリポジトリにすでに表示されている README も含まれます。

JavaScript または TypeScript アプリ ​

プレーンテキストのボタン、ラベル、メッセージを多言語UIに変えます。ランタイムを設定し、翻訳するテキストをマークし、言語切り替えを接続します。準備ステップ用のコーディングエージェントプロンプトが含まれています。

React · Next.js · Node.js · CLI

JS/TS アプリに i18n を追加する

Python アプリ ​

ユーザー向けテキストをラップし、生成されたヘルパーで翻訳済みメッセージを読み込みます。既にDjangoまたはGNU gettextを使用していますか?gettext呼び出しを維持し、ツールに.poファイルを埋め込ませてください。個別のNode.jsインストールなしで、スタンドアロンの実行可能ファイルから翻訳CLIを実行します。

Streamlit · FastAPI · Flask · Django · CLI

Pythonアプリにi18nを追加する · Django / Python gettextアプリにi18nを追加する

.NET アプリ ​

C#およびXAMLのテキストをラップし、埋め込みJSONから翻訳をロードするか、ResourceManagerを保持して.resxサテライトを作成します。ドライランコマンドは、補間をT()呼び出しに変換し、変換するためのResources.LoginButtonのような名前付きリソースキーをリストします。

Avalonia ・ WPF ・ MAUI ・ ASP.NET ・ Blazor

.NETアプリにi18nを追加 ・ .NET ResourceManagerアプリにi18nを追加

ウェブサイトまたはドキュメント ​

ローカライズされたページを公開し、サイトの言語ルートに接続します。ナビゲーション、テーマラベル、および言語メニューについて、フレームワーク固有の手順に従ってください。

VitePress・Starlight・Docusaurus・Astro

ウェブサイトまたはドキュメントサイトに i18n を追加する

リポジトリの README とドキュメント ​

README.mdやその他のMarkdownファイルを、言語ごとに1つのファイルに翻訳し、それらの間にリンクの行を設けます。アプリのUI文字列と組み合わせるか、READMEを単独で翻訳します。

GitHub・GitLab・Bitbucket

README と Markdown ドキュメントに i18n を追加する

どのパスが適しているかわからない場合は、プロジェクトにi18nを追加するにすべてのウォークスルーが記載されています。パイプラインがどのように連携するかについては、ai-i18n-toolsの機能を参照してください。

セットアップから最初の新しい言語まで ​

  1. プロジェクトを準備します。 使用する言語、翻訳プロバイダー、および試すモデルを選択します。アプリの場合、ユーザーに表示されるテキストをマークし、翻訳ランタイムを設定します。サイトの場合、フレームワークの言語ルーティングを有効にします。ガイドには、ソースの変更が必要な箇所でコーディングエージェントプロンプトが含まれています。
  2. 使用できるファイルに翻訳します。 セットアップが完了したら、syncを実行します。これにより、サポートされているアプリの文字列が抽出され、有効にしたコンテンツが翻訳され、ロケールファイルまたはローカライズされたページが書き込まれます。
  3. ロード、確認、続行します。 出力をアプリまたはサイトに接続し、言語切り替えを接続し、ターゲット言語を確認します。ソースの変更後に再実行して、新しいテキストまたは変更されたテキストを翻訳します。

ランタイムとルーティングのセットアップは、手動またはコーディングエージェントを使用して行います。CLIは、抽出、翻訳、検証、ファイル生成を処理します—ソースの自動書き換えや言語スイッチャーのインストールは行いません。完全なクイックスタートに従ってください。

ソーステキストを多言語に対応させる ​

この JS/TS のサンプルは、ランタイムのセットアップと翻訳後の結果の形式を示します。ソース文字列をマークすることで検出可能になり、生成された各ロケールファイルでその文章が翻訳にマッピングされます。

js
t("Save changes");
json
{
  "Save changes": "Änderungen speichern"
}
json
{
  "Save changes": "Salvar alterações"
}
json
{
  "Save changes": "保存更改"
}

ソース文はコード内で読みやすいままです。アプリは生成されたロケールファイルをランタイムで読み込みます。完全な配線を確認したいですか?動作するNext.jsの例を探索する。ウェブサイトは異なるパスをたどります。すべての段落をラップする代わりに、ローカライズされたページを生成するします。

次のアップデートにも対応 ​

プロバイダーとモデルを選択 ​

OpenAI、Anthropic、OpenRouter、Gemini、ローカルのOllama、またはその他9つの組み込みオプションなど、サポートされているプロバイダーを使用できます。また、OpenAI互換のプロバイダーも使用できます。翻訳品質はモデルリスト (translationModels、およびロケールごとのオーバーライド) に従います。suggest-models、およびダッシュボードのモデルにある同じランキングは、公開されている翻訳ベンチマークからそのリストを構築します。

LLMプロバイダー · AIモデル

既存の作業を再利用 ​

キャッシュされた翻訳により、再実行時にはすべてを再翻訳するのではなく、新規または変更されたテキストに集中できます。

翻訳を維持する

AI の出力をローカルでレビュー ​

翻訳ダッシュボードで、翻訳の検査、表現の修正、用語の管理を行います。

ダッシュボードを見る

アプリとコンテンツを一緒に管理 ​

1つの設定で、アプリのメッセージ、ドキュメント、ネストされたロケールJSON、SVGテキストラベルを翻訳します。必要なものだけを有効にしてください。

パイプラインを組み合わせる

まず動作するプロジェクトを確認 ​

これらの例には、設定ファイルとコミット済みの翻訳ファイルが含まれています。APIキーなしで出力を確認できます。翻訳を再実行するには、設定済みのプロバイダーと、通常はキーが必要です。ローカルのOllamaはAPIキーを必要としません。

多言語アプリ ​

動作するNext.jsプロジェクトで、Reactコンポーネント、ランタイムの連携、複数形、言語の切り替えを確認してください。

Next.js の例を見る

実践的な Python ​

Streamlitアプリが、アプリにJavaScriptランタイムを追加することなく、メッセージをラップして翻訳済みのJSONを使用する方法を確認してください。

Streamlit の例を見る

多言語のドキュメント ​

翻訳されたVitePressページを、ローカライズされたナビゲーションとテーマラベルとともに表示します。

VitePress の例を見る

すべての実行可能な例を参照。これには、.NETヘルパー、プレーンHTML、その他のフレームワーク、および既存のi18nワークフローが含まれます。

既存の i18n を活用 ​

最初からやり直す必要はありません。

図を使用していますか?アプリやドキュメントと一緒に SVG テキストラベルを翻訳 してください。

最初の言語を追加する準備はできましたか? ​

完全なウォークスルーについては プロジェクトを選択 するか、インストールと設定については クイックスタートを開いて ください。

Node.js プロジェクトの場合は、npm パッケージ をインストールしてください。

Python の場合は、スタンドアロンの実行可能ファイル をダウンロードしてください。別途 Node.js をインストールする必要はありません。

npm version License: MIT

Linux x64 Linux arm64 macOS arm64 macOS x64 Windows x64

必要に応じてさらに深く ​

インテグレーション · LLMプロバイダー · AIモデル · 設定 · CLIリファレンス



このサイトについて

英語以外のインターフェースとドキュメントは ai-i18n-tools を使用して翻訳されました。AI による翻訳には誤りが含まれる場合があります。

すべての製品名、ロゴ、および商標は、それぞれの所有者に帰属します。アイコンと名称は、識別のみを目的として使用されています。このプロジェクトは、これらのブランドと提携しているわけでも、承認を受けているわけでもありません。

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