# General Translation Integrations: Mintlify の設定
URL: https://generaltranslation.com/ja/docs/integrations/mintlify/guides/configuring-mintlify.mdx
---

title: Mintlify の設定
description: "Mintlify のドキュメントリポジトリを General Translation に接続する方法を説明します。このガイドでは、言語の選択と翻訳の実行方法の設定について解説します。"
related:
  links:
    - /docs/integrations/mintlify/guides/translating-content
    - /docs/integrations/mintlify/guides/managing-translations
    - /docs/integrations/mintlify/guides/using-translated-content

---

# Mintlify の設定

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

この連携は [Locadex](/docs/platform/locadex/quickstart) 上で動作するため、設定はパッケージや手動で編集する設定ファイルではなく、ダッシュボードの **Locadex > Agent** から行います。

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

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

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

1. ダッシュボードでProjectを開き、**Locadex > Agent** に移動します。
2. **Connect GitHub** をクリックし、Locadexがアクセスするリポジトリに対してGeneral Translation GitHub Appを承認します。
3. Mintlifyドキュメントを含むリポジトリを選択します。各Projectには1つのリポジトリを紐付けられます。

## アプリのルートディレクトリを設定する [#app-directory]

`docs.json` がリポジトリのルートにある場合は、アプリのルートディレクトリは空のままにするか、`.` に設定してください。ドキュメントがサブディレクトリにある場合 (たとえばモノレポ内など) は、Locadex が正しいフォルダを対象に処理できるよう、そのパスをアプリのルートディレクトリに設定してください。詳しくは [Monorepos](/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) を参照してください。

## デフォルトロケールを非表示にする [#hide-default]

ソース言語をどのように配信するかは、**URL パスでデフォルトロケールを非表示にする**トグルで設定できます。

* **On** (デフォルト) : デフォルトロケールのページは既存のパス (ロケールプレフィックスなし) のままとなり、翻訳済みの言語にのみロケールプレフィックスが付きます。
* **Off**: デフォルトを含むすべての言語が、それぞれのロケールプレフィックス付きで配信されます。

この設定により、Locadex がファイルと `docs.json` のナビゲーションをどのように再構成するかが変わります。各モードで正確に何が生成されるかについては、[設定リファレンス](/docs/integrations/mintlify/reference/config) を参照してください。

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

Locadex は、変更のたびにプルリクエストを作成します。ドキュメント用のリポジトリでは、デフォルトブランチへの新しいコミットをきっかけに実行され、チェックに通ると翻訳用のプルリクエストを自動的にマージできるため、手動の作業なしでドキュメントを翻訳済みの状態に保てます。これらの設定はいつでも確認でき、トリガーや自動マージの動作も変更できます。詳しくは [Auto-merge](/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