# General Translation Platform: クイックスタート
URL: https://generaltranslation.com/ja/docs/platform/locadex/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: コードベース、翻訳、コンテンツソースをつなぐ AI エージェント、Locadex を使いましょう。General Translation のフルスタックのローカライゼーションを最速で導入する方法です。

Locadex は、コードベース、翻訳、コンテンツソースをつなぐ General Translation の AI エージェントです。

セットアップ後、Locadex はプロジェクトを設定し、選択した言語へ自動的に翻訳できます。

Locadex は現在、**Next.js**、**Mintlify**、**Fern**、**Docusaurus** のプロジェクトに対応しているほか、Vite、Gatsby、Redwood、React Router、TanStack Start、Bazel、esbuild、Rollup、Rolldown、webpack で構築された React アプリケーションもサポートしています。

## Locadex の仕組み [#locadex-works]

Locadex は GitHub リポジトリ内で動作し、生成された変更を含むプルリクエストを自動で作成または更新します。次の 3 つの自動化テンプレートで、ローカライゼーションを最新の状態に保ちます。

* **Generate code** は、`t()` や `T` コンポーネントなどの適切な国際化 (i18n) ライブラリ呼び出しでソースコードをラップします。
* **Generate translations and push** は、ソースコンテンツを各対象言語に翻訳し、翻訳ファイルを更新します。
* **Keep locales in sync** は、言語が追加または削除されたときにプロジェクトファイルを更新します。

各自動化は、手動、プルリクエストに変更があったとき、またはコミットがプッシュされたときに実行できます。トリガー設定は自由に選べます。

## クイックスタート [#quickstart]

開始する前に、Starter、Team、または Enterprise プランの [General Translation](https://dash.generaltranslation.com) プロジェクトと、Locadex がサポートするフレームワークのいずれかで構築されたプロジェクトを含む GitHub リポジトリが必要です。プロジェクトの自動化の作成と実行には `project:locadex:write` 権限が必要です。

1. **GitHub を接続します。** [ダッシュボード](https://dash.generaltranslation.com) でプロジェクトを開き、**Project &gt; Integrations &gt; Catalog** に移動して GitHub を接続します。このプロジェクトで Locadex が使用するリポジトリを選択します。
2. **自動化を作成します。** **Project &gt; Automations** を開きます。**Start with a template** で、**Generate code**、**Generate translations and push**、または **Keep locales in sync** を選択します。
3. **対象を選択します。** 接続済みのリポジトリ、対象ディレクトリ、検出されたフレームワークを選択します。アプリがリポジトリルートにある場合は `.` を使用します。
4. **自動化を確認します。** 対象ブランチ、トリガー、作成するブランチのプレフィックス、auto-merge の動作、変更ファイルのフィルタリング、ローカル編集を保持するかどうかを選択します。**Create automation** をクリックします。
5. **セットアップを実行します。** 自動化を開いて **Run setup** をクリックします。ソースロケールと対象言語を選択します。Locadex がリポジトリを準備し、セットアップ用のプルリクエストを作成します。
6. **確認してマージします。** 自動化ページからセットアップ用のプルリクエストを開き、変更内容を確認して、自動化を実行する前にマージします。

セットアップ用 PR がマージされると、各自動化は設定されたトリガーに従って実行されます。自動実行では、Locadex は同じソースブランチと自動化に対して開いているプルリクエストを再利用し、そのプルリクエストがマージまたはクローズされると新しいものを作成します。プルリクエストを確認するか、**[auto-merge](/docs/platform/locadex/guides/auto-merging-prs) を有効にする**ことで、手作業なしでアプリの翻訳を最新の状態に保てます。

自動化を開き、**今すぐ実行** をクリックすると手動で実行できます。

## Next steps

- /docs/platform/locadex/guides/configuring-automations
- /docs/platform/locadex/guides/managing-languages
- /docs/platform/locadex/guides/auto-merging-prs
- /docs/platform/locadex/guides/viewing-automation-activity

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
