# General Translation Integrations: コンテンツの翻訳
URL: https://generaltranslation.com/ja/docs/integrations/mintlify/guides/translating-content.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Mintlify のドキュメントを翻訳する方法と、Locadex が保持する内容を理解する方法。

リポジトリを接続すると、Locadex は Mintlify のドキュメントを翻訳し、その結果を反映したプルリクエストを作成します。このガイドでは、翻訳実行の仕組みと、変更されるもの・されないものについて説明します。

## 初回の翻訳を実行する [#first-run]

初回の翻訳はセットアップの一環として実行されます。リポジトリを連携して言語を選択すると、Locadex は次の処理を行います。

1. Mintlify 向けに調整された General Translation の設定を生成します。
2. `docs.json` のナビゲーションを、ロケールごとに 1 つのエントリを持つ多言語レイアウトに再構成します。
3. Markdown ファイル、MDX ファイル、および `docs.json` のラベルを翻訳します。
4. 設定、再構成されたナビゲーション、翻訳済みファイルを含むプルリクエストを作成します。

プルリクエストを確認してマージし、翻訳されたドキュメントを公開してください。**プロジェクト > Automations** を開き、**Generate translations and push** を選択して、**今すぐ実行** をクリックすることもできます。

## 翻訳されるもの [#translated]

Locadex は、ドキュメント内の人が読めるコンテンツを翻訳します。

* すべての `.mdx` および `.md` ページ — 見出し、段落、リスト、表、コールアウト。
* ページタイトルや説明などのフロントマターのフィールド。これにより、どの言語でもメタデータが正しく機能します。
* 再利用可能な [snippets](https://mintlify.com/docs) と、`docs.json` 内のナビゲーションラベル。

正確なファイル glob と常に除外されるリポジトリ内のファイルについては、[対応コンテンツ](/docs/integrations/mintlify/reference/supported-content) を参照してください。

## 保持されるもの [#preserved]

翻訳はMarkdownおよびMDXの構文レベルで行われるため、構造やコードはそのまま保たれます。

* コードブロック、インラインコード、シンタックスハイライトは変更されません。翻訳されるのはコメントとドキュメント文字列のみです。
* カスタムコンポーネント、リンク、書式は、記述したとおりにそのまま保持されます。
* General Translation は安定した見出しアンカーIDを追加するため、言語が変わってもページ内リンクはそのまま機能します。

## コンテキストを考慮した翻訳 [#context]

翻訳は、技術用語や周囲のコンテンツを理解するAIエージェントによって生成されるため、意味や製品用語の一貫性を言語間で保てます。プロジェクト全体で用語やトーンを統一するには、Dashboard で翻訳コンテキストを定義してください。 ([翻訳のコンテキストを定義する](/docs/platform/dashboard/guides/defining-context-for-translations) を参照してください。)

## Next steps

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

## Sitemap

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