Next.js アプリをフランス語 🇫🇷、スペイン語 🇪🇸、日本語 🇯🇵 など任意の言語に翻訳するのは、手間も時間もかかります。

Locadex は、国際化（i18n）作業を完全自動化するために設計された AI エージェントです。 インストールは 5 分で完了します。

Locadex でできること:

• プロジェクトを gt-next の i18n ライブラリで動作するように設定
• 多言語対応のために React コンポーネントと文字列を自動変更
• 必要なだけ多言語へアプリを翻訳
• 新しいコンテンツをプッシュするたびに継続的に国際化と翻訳を実行

セットアップ手順

ステップ 1：General Translation のDashboardにサインイン

Dashboard にアクセスし、アカウントにサインインします。

ステップ 2: GitHub を連携する

1. ダッシュボードの「GitHub 連携」セクションに移動します
2. 「Connect GitHub」をクリックして GitHub アカウントを連携します
3. 接続を承認するために GitHub にリダイレクトされます

ステップ 3: GitHub アプリをインストールする

1. GitHub を連携すると、Locadex の GitHub アプリのインストール画面にリダイレクトされます
2. Locadex にアクセスを許可するリポジトリを選択します：
   • すべてのリポジトリにインストールする、または
   • 特定のリポジトリを選択する
3. 「Install」をクリックして GitHub アプリのインストールを完了します

ステップ4：リポジトリをプロジェクトにリンクする

1. GT の dashboard に戻り、国際化したいリポジトリを選択します
2. これにより、リポジトリが翻訳設定と対象言語にリンクされます
3. 1 つのプロジェクトにリンクできるリポジトリは 1 つだけですが、複数のプロジェクトを作成し、それぞれ異なるリポジトリを割り当てることができます

手順 5: 設定の構成

設定画面で以下を設定します：

• 対象言語：翻訳するロケールを選択

ステップ6：インストールを完了する

1. 設定内容を確認する
2. 「Install」をクリックして、リポジトリで Locadex を有効にする
3. 接続済みの GitHub リポジトリが表示される概要ページに移動します

次の流れ

初期セットアップ

インストールが完了したら：

1. PRを即時作成: Locadex がメインブランチに pull request を作成します
2. フルセットアップ: この PR では、以下を実行する Locadex のフルセットアップコマンドが走ります:
   • GT ライブラリをインストール
   • プロジェクトを i18n 用に構成
   • 翻訳インフラをセットアップ
3. レビューとマージ: PR をレビューしてマージし、i18n セットアップを完了します

継続的な国際化

初期セットアップをマージした後は、次のとおり進みます:

1. Locadex がメインブランチまたは指定したブランチのプルリクエストを監視します
2. 翻訳対象のコンテンツを含む新しいコードをプッシュしたら、Locadex がコミットを PR に追加するまで待ちます
3. Locadex が PR にコミットしたら、安全にマージできます――新しいコードは国際化されています
4. 手動での対応なしに、アプリは翻訳済みの状態を維持します

リポジトリのモニタリング

ダッシュボードのステータス

dashboard では、次の内容を監視できます:

• Repository Status: 稼働監視インジケーター
• Configuration: 現在の設定とターゲット言語

GitHub 連携

• ステータスチェック: Locadex がプルリクエストにステータス更新を追加します
• チェックラン: GitHub 上に Locadex の処理状況が表示されます

トラブルシューティング

よくある問題

Locadex が PR を作成しない

• GitHub アプリにリポジトリへのアクセス権が付与されているか確認する
• コミットに翻訳対象のコンテンツが含まれているか確認する

設定の変更が必要

• GT の dashboard でブランチ設定を更新する
• 変更は更新後の新規コミットから適用される

サポート対象のフレームワーク

現時点では、Locadex は Next.js の App Router を利用するアプリのみをサポートしています。