# General Translation Knowledge Base: Mintlify のドキュメントサイトを翻訳するには？
URL: https://generaltranslation.com/ja/kb/translate-mintlify-docs.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: すべてのページの翻訳版を言語ごとのフォルダーに作成し、各言語を docs.json のナビゲーションに追加します。General Translation の AIエージェントである Locadex が、翻訳済みページと言語別ナビゲーションを追加するプルリクエストを作成し、以降の変更も翻訳します。
Category: ワークフローツール
Last updated: 2026-10-21
Authors: Kevin Liu, Kevin Wu
Published: 2026-10-21

Mintlify のドキュメントサイトを翻訳するには、すべてのページの翻訳版を言語ごとのフォルダーに作成し、`docs.json` のナビゲーションにある `languages` 配列に各言語を記載します。ページには本文のほか、コードブロック、MDX コンポーネント、フロントマター、リンクが混在しています。そのため、本文と `title`・`description` フィールドは翻訳する一方で、コードとコンポーネントには手を加えず、内部リンクは読者の言語のページを指すようにする必要があります。また、翻訳元のページを編集するたびに、誰かが翻訳し直すまでその翻訳は古い内容のまま残ります。

## Video

The video is narrated in English, with English captions.

[How do I translate a Mintlify docs site?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-translate-mintlify-docs.mp4) (47 秒)

General Translation lets you choose languages, and Locadex opens a translation pull request. Authorize the General Translation app on GitHub, choose your docs repository in the Dashboard, create an automation from the Generate translations and push template for Mintlify, run its setup with your languages, and merge the pull request that adds a navigation entry per language and the translated pages.

## Mintlifyサイトを翻訳する方法

| アプローチ                                  | 得意なこと                                                                 | 自分で対応する必要があること                                                        |
| -------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- |
| Mintlifyの`languages`ナビゲーション＋手作業での翻訳    | `docs.json`から言語切り替え機能と言語ごとのページツリーを構築する                                | 翻訳したすべてのページを各言語フォルダに作成し、言語ごとにナビゲーション全体を記述し、翻訳元の編集によってどの翻訳が古くなったかを追跡する |
| Google Translate                       | 貼り付けたページをセットアップなしで翻訳する                                                | 文章をそれぞれ個別に翻訳するため、本文とコードやコンポーネントの切り分け、フォルダとナビゲーションの作成は自分で行う必要がある       |
| AI API(OpenAI API、Claude API)を使ったスクリプト | 本文のみを翻訳し、コードブロックやコンポーネントには手を加えないよう指示できる                               | MDX構文を保護し、ページをまたいで製品用語を統一し、フォルダとナビゲーションを作成し、ページの変更時に再実行するスクリプトを用意する   |
| General Translation (Locadex)          | 翻訳済みページ、言語ごとのナビゲーション、ローカライズ済みリンクを含むプルリクエストを作成し、以降は選択したトリガーで変更のたびに翻訳する | セットアップ用プルリクエストのレビューとマージ、以降のプルリクエストのレビュー(または**Auto-merge**の有効化)        |

ほとんど変更のない少数のページを翻訳者が担当する場合は、Mintlifyのナビゲーションと手作業での翻訳が適しています。小規模で更新の少ないサイトを一度だけ翻訳する場合は、Google Translateや単発のAI APIスクリプトで十分です。リリースのたびにドキュメントが更新され、すべての言語をそれに追随させる必要がある場合は、General Translationを使用してください。

## Locadex で Mintlify ドキュメントを翻訳する

General Translation では、AIエージェントの Locadex を使って Mintlify ドキュメントを翻訳できます。利用には Starter プランまたはエンタープライズプランが必要です。

1. ダッシュボードの **Project > Integrations > Catalog** で GitHub を接続します。
2. **Project > Automations** で **Generate translations and push** からオートメーションを作成し、フレームワークに **Mintlify** を指定します。
3. **Run setup** をクリックし、言語を選択します。
4. Locadex が作成したプルリクエストを確認してマージします。

このプルリクエストでは、`gt.config.json`、言語ごとの `docs.json` ナビゲーションエントリ、翻訳済みページが追加されます。翻訳済みページではコードやコンポーネントの構造がそのまま維持され、翻訳済みページへのリンクも読者の言語のまま保たれます。Mintlify 向けの **Run setup** ダイアログには **Hide default locale in URL paths** トグルがあり、デフォルトでオンになっています。オンの場合、翻訳元のページは現在のパスのままで、翻訳先の各言語には `/es/...` のような専用のロケールフォルダが用意されます。トグルをオフにすると、翻訳元のページもロケールフォルダに移動するため (英語ページは `/en/...` に移動) 、URL が変わります。

## 翻訳を最新の状態に保つ

以降は、プルリクエストが更新されたとき (デフォルト) またはコミットがプッシュされたときに Locadex が実行されます。各実行では、プロジェクトに割り当てられたコンテキストグループ (用語集とカスタムプロンプト) が適用されます。コンテキストグループはアプリと共有できるため、製品名を両者で統一できます。詳しい手順は [Mintlify クイックスタート](/docs/integrations/mintlify/quickstart) を参照してください。

## Related questions

- [Locadex エージェントは何をするのか？](https://generaltranslation.com/ja/kb/what-is-locadex.mdx): Locadex は General Translation の AI エージェントで、GitHub リポジトリ内のコードを国際化し、コンテンツを翻訳します。自動化はプルリクエストの作成時、コミットのプッシュ時、または手動で開始したときに実行され、すべての変更はプルリクエストとして届きます。
- [Sanity でコンテンツを翻訳するには？](https://generaltranslation.com/ja/kb/translate-sanity-content.mdx): 各言語を個別のドキュメントとして保存するか、各フィールドにロケールごとの値として保存し、翻訳元をすべての対象ロケールに翻訳します。General Translation の gt-sanity プラグインは Sanity Studio に Translate アクションを追加します。デフォルトでは各翻訳が下書きとしてインポートされるため、レビューしてから公開できます。
- [Storyblok でコンテンツを翻訳するにはどうすればよいですか？](https://generaltranslation.com/ja/kb/translate-storyblok-content.mdx): Storyblok では、スペースに対象言語を追加し、翻訳可能な各フィールドに言語ごとの値を設定します。General Translation の Storyblok インテグレーションを使うと、ダッシュボードの「同期して適用」でこれらの値が下書きとして入力されるので、Storyblok 上でレビューして公開できます。
- [翻訳をレビュー・編集するにはどうすればよいですか？](https://generaltranslation.com/ja/kb/review-translations.mdx): 各翻訳を翻訳元や他のロケールと見比べ、不自然な箇所を修正します。General Translation では、ダッシュボードの翻訳ページで翻訳を編集し、ラベルとコメントでレビューの進捗を管理します。編集内容は、AIエージェントである Locadex による次回の翻訳実行でプルリクエストに取り込まれます。

## Previous and next questions

- Previous question: [Locadex エージェントは何をするのか？](https://generaltranslation.com/ja/kb/what-is-locadex.mdx)
- Next question: [Next.js App Router アプリに i18n を追加するには？](https://generaltranslation.com/ja/kb/add-i18n-to-nextjs.mdx)

## Sitemap

See the [Knowledge Base sitemap](https://generaltranslation.com/ja/kb/sitemap.md) for every article.