# General Translation Integrations: Mintlify の設定
URL: https://generaltranslation.com/ja/docs/integrations/mintlify/guides/configuring-mintlify.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Mintlify のドキュメント用リポジトリを General Translation に接続し、言語と翻訳トリガーを設定する方法。

Mintlify のドキュメントを含む GitHub リポジトリを General Translation に接続し、使用する言語と翻訳の実行方法を選択します。最短で設定したい場合は [Quickstart](/docs/integrations/mintlify/quickstart) を参照してください。このガイドでは、設定オプションをさらに詳しく説明します。

このインテグレーションは [Locadex](/docs/platform/locadex/quickstart) 上で動作するため、そのリポジトリと自動化はダッシュボードの **Project > Integrations** と **Project > Automations** から設定します。

## 始める前に [#before-start]

* General Translation の [プロジェクト](/docs/platform/dashboard/get-started)。
* 有効な Mintlify プロジェクトを含む GitHub リポジトリ。Locadex は、リポジトリ内に `$schema` が Mintlify を指す `docs.json` があることを確認します。従来の `mint.json` をまだ使用しているプロジェクト (先に `docs.json` に移行してください) や、Next.js アプリと見なされるプロジェクトは受け付けられません。

## リポジトリを接続して紐付ける [#connect]

1. ダッシュボードで、**Project > Integrations > Catalog** を開きます。
2. GitHub を接続し、Mintlify ドキュメントを含むリポジトリで General Translation GitHub App を承認します。
3. **Project > Automations** を開き、**Generate translations and push** を選択します。
4. リポジトリ、対象ディレクトリ、**Mintlify** フレームワークを選択します。

## 対象ディレクトリを設定する [#target-directory]

`docs.json` がリポジトリルートにある場合は、**対象ディレクトリ** を `.` に設定します。ドキュメントがサブディレクトリ (モノレポ内など) にある場合は、Locadex が正しいフォルダを対象に動作するよう、**対象ディレクトリ** をそのパスに設定してください。([Using Locadex in a monorepo](/docs/platform/locadex/guides/using-in-monorepos) を参照)。

## 言語を選択 [#languages]

**ソースロケール** (ドキュメントの記述言語) と、翻訳先の**対象言語**を設定します。

Mintlify でサポートされている言語コードは固定されており、General Translation は選択したロケールをそれらにマッピングします。使用できるのは、Mintlify がサポートする言語にマッピングできるロケールのみです。([Locales](/docs/integrations/mintlify/reference/locales) を参照)。

後から言語を変更する場合は、[Managing translations](/docs/integrations/mintlify/guides/managing-translations) を参照してください。

## デフォルトロケールの URL レイアウトを選択する [#default-locale-url]

**Project > Automations** から開始したセットアップでは、ソースロケールを含むすべての言語に対して、ロケールのプレフィックス付き URL レイアウトが作成されます。たとえば、英語のソースページは `/en/...` で配信されます。

ソースロケールを非表示にするよう設定済みの既存のプロジェクトでは、引き続き元のパスでソースページが配信されます。この動作は生成された `gt.config.json` に記録されます。詳しくは [configuration reference](/docs/integrations/mintlify/reference/config#options) を参照してください。

このレイアウトにより、Locadex によるファイルおよび `docs.json` ナビゲーションの再構成方法が変わります。マージ前に、セットアップのプルリクエストを確認してください。

## 翻訳の実行方法を設定する [#triggers]

Locadex は、変更内容を含むプルリクエストを作成または更新します。同じ自動化ブランチでは、開いているプルリクエストを再利用し、前のプルリクエストがマージまたはクローズされると新しいものを作成します。

新しい翻訳の自動化では、既定で **A pull request changes** が設定され、**Auto-merge** はオフになっています。変更が対象ブランチに反映されたあとで翻訳するには **A commit is pushed** を選択し、信頼できる必須チェックでブランチを保護できる場合は **Auto-merge** をオンにしてください。 ([Locadex のプルリクエストの自動マージ](/docs/platform/locadex/guides/auto-merging-prs) を参照してください) 。

## Next steps

- /docs/integrations/mintlify/guides/translating-content
- /docs/integrations/mintlify/guides/managing-translations
- /docs/integrations/mintlify/guides/using-translated-content

## Sitemap

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