Locadex — AI i18n エンジニア
自動化された国際化エンジニアLocadexを始めよう
Next.jsアプリをフランス語🇫🇷、スペイン語🇪🇸、日本語🇯🇵、その他の言語に翻訳するのは面倒で時間がかかります。
Locadexは、国際化（i18n）作業を100%自動化するAIエージェントです。 インストールはわずか5分で完了します。
Locadexの機能：
- gt-next i18nライブラリを使用するプロジェクト設定
- 多言語対応のためのReactコンポーネントと文字列の変更
- 必要な言語数でのアプリ翻訳
- 新しいコンテンツのプッシュ時に継続的な国際化・翻訳を実行
セットアップ手順
ステップ1: General Translation ダッシュボードにサインイン
ダッシュボードにアクセスし、アカウントにサインインしてください。
ステップ2: GitHubを接続
- ダッシュボードのGitHub連携セクションに移動します
- 「Connect GitHub」をクリックしてGitHubアカウントを連携します
- 連携を承認するためにGitHubにリダイレクトされます
ステップ3: GitHub Appをインストール
- GitHubを接続すると、Locadex GitHub appをインストールするページにリダイレクトされます
- Locadexにアクセス権を付与するリポジトリを選択します：
- すべてのリポジトリにインストール、または
- 特定のリポジトリを選択
- 「Install」をクリックしてGitHub appのインストールを完了します
ステップ4: リポジトリをプロジェクトに連携
- GTダッシュボードに戻り、国際化対応したいリポジトリを選択します
- これにより、リポジトリが翻訳設定とターゲット言語に接続されます
- 1つのプロジェクトに連携できるリポジトリは1つだけですが、それぞれ異なるリポジトリを持つ複数のプロジェクトを作成できます
ステップ5: 設定を構成
設定画面で以下を設定します：
- ターゲット言語: 翻訳先のロケールを選択
- アプリディレクトリ: モノレポを使用している場合はディレクトリを指定（例：
apps/web/） - ブランチプレフィックス: Locadexが作成するブランチのプレフィックスをカスタマイズ（デフォルト：
locadex/）
ステップ6: インストールを完了
- 設定内容を確認します
- 「Install」をクリックしてリポジトリでLocadexを有効化します
- 連携されたGitHubリポジトリを表示する概要ページに移動します
次のステップ
初期セットアップ
インストール完了後の流れ：
- プルリクエストの自動作成: Locadexがメインブランチにプルリクエストを自動作成します
- 完全セットアップの実行: このPRでは完全なLocadexセットアップコマンドが実行され、以下が行われます：
- ライブラリのインストール
- プロジェクトの国際化設定
- 翻訳インフラの構築
- レビューとマージ: PRをレビューしてマージすることで、i18nセットアップが完了します
継続的な国際化
初期セットアップのマージ後：
- Locadexがメインブランチまたは指定ブランチのプルリクエストを監視します
- 翻訳対象のコンテンツを含む新しいコードをプッシュした場合、LocadexがPRにコミットを追加するまでお待ちください
- LocadexがPRにコミットを追加したら、安全にマージできます -- 新しいコードは国際化対応済みです
- 手動操作なしで、アプリの翻訳状態が維持されます
リポジトリの監視
ダッシュボードステータス
ダッシュボードでは、以下を監視できます：
- リポジトリステータス: アクティブ監視インジケーター
- 設定: 現在の設定と対象言語
GitHub連携
- ステータスチェック: Locadexがプルリクエストにステータス更新を追加
- チェック実行: GitHubでLocadexの処理ステータスを表示
トラブルシューティング
よくある問題
LocadexがPRを作成しない場合
- GitHub アプリにリポジトリへのアクセス権限があることを確認する
- コミットに翻訳対象のコンテンツが含まれていることを確認する
設定変更が必要な場合
- GT ダッシュボードでブランチ設定を更新する
- 変更は更新後の新しいコミットに適用される
サポートされているフレームワーク
現在、LocadexはNext.js App routerアプリのみをサポートしています。
他のフレームワークのサポートをリクエストするにはこちら。
このガイドはいかがですか？