# General Translation Integrations: 設定
URL: https://generaltranslation.com/ja/docs/integrations/mintlify/reference/config.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Mintlify プロジェクト用に General Translation が生成する gt.config.json のリファレンス。Mintlify インテグレーション設定のリファレンス。

General Translation は、セットアップ時に Mintlify プロジェクト用の `gt.config.json` を生成します。手動で作成する必要はありません。このページでは、そのファイルに含まれる内容を説明し、セットアップのプルリクエストがマージされた後に内容を確認したり微調整したりできるようにしています。

この設定は、標準的な General Translation CLI の設定です。共通の各キーについては [CLI configuration reference](/docs/cli/reference/config) にまとめて記載されています。このページでは、Mintlify 固有の設定項目と、このインテグレーションによって生成される 2 つのモードのみを扱います。

## モード [#modes]

**Project > Automations** から開始したセットアップでは、すべての言語がロケールプレフィックス付きのパスを使用する、show-default-locale モードが生成されます。既存のプロジェクトでは、ソースページが元のパスを維持するhide-default-locale モードを使用している場合があります。どちらのモードでも `docs.json` とすべての `.mdx`/`.md` ページを翻訳しますが、ファイルの配置とソースロケールの配信方法が異なります。

| キー                                                  | 説明                              | デフォルトロケールを非表示                                               | デフォルトロケールを表示                                                           |
| --------------------------------------------------- | ------------------------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------- |
| [`files.mdx.include`](#files)                       | 翻訳対象のページを指定する glob パターン。        | `./**/*.mdx`, `./**/*.md` (インプレースで翻訳)                       | `./[locale]/**/*.mdx`、`./snippets/[locale]/**/*.mdx`、および `.md` の同等パターン |
| [`files.mdx.transform`](#files)                     | source パスをロケールフォルダー内のパスに書き換えます。 | `{ match: "^(snippets/)?(.*)$", replace: "$1{locale}/$2" }` | *(なし)*                                                                 |
| [`options.jsonSchema`](#options)                    | `docs.json` のローカライズに使用するプリセット。  | `mintlify-hide-default`                                     | `mintlify`                                                             |
| [`options.docsHideDefaultLocaleImport`](#options)   | import でデフォルトロケールを非表示にします。      | `true`                                                      | *(省略)*                                                                 |
| [`options.experimentalHideDefaultLocale`](#options) | ロケールプレフィックスなしでデフォルトロケールを配信します。  | `true`                                                      | *(省略)*                                                                 |

## ファイル [#files]

`files` ブロックは、General Translation CLI に何を翻訳するかを指定します。Mintlify プロジェクトでは、これには常に `docs.json` と Docs ページが含まれます。

* `files.json.include` — 常に `['./docs.json']` です。`docs.json` のナビゲーションと labels は、`options.jsonSchema` のプリセットでローカライズされます。
* `files.mdx.include` — 翻訳対象の `.mdx` ページと `.md` ページです。hide-default-locale モードでは、対象はツリー全体 (`./**/*.mdx`、`./**/*.md`) で、ファイルは transform によってロケールフォルダーへ移動されます。show-default-locale モードでは、既存のロケールごとのフォルダーが対象になります。
* `files.mdx.transform` — hide-default-locale モードでは、各 source パスを `{locale}/` フォルダー内のパスに書き換えます (先頭の `snippets/` プレフィックスはそのまま保持されます) 。show-default-locale モードでは、コンテンツはすでにロケールフォルダー内にあるため、transform は省略されます。
* `files.mdx.exclude` — ロケールフォルダー自体に加え、決して翻訳すべきでない一般的なリポジトリファイルです ([サポートされるコンテンツ](/docs/integrations/mintlify/reference/supported-content#excluded) を参照) 。

(`files`、`include`、`exclude`、`transform` の完全な意味については [CLI configuration reference](/docs/cli/reference/config) を、形式ごとの動作については [MDX and Markdown format page](/docs/cli/reference/formats/mdx-md-files) と [JSON format page](/docs/cli/reference/formats/json-files) を参照してください) 。

## オプション [#options]

`options` ブロックでは、Mintlify 固有の動作を設定します。これらのキーは、モード固有と明記されていない限り、すべての Mintlify プロジェクトで使用されます。

* `mintlify.inferTitleFromFilename` — `true`。ページに明示的なタイトルがない場合、ファイル名からページタイトルを生成します。
* `jsonSchema` — `./docs.json` を、Mintlify のナビゲーションのローカライズ方法を理解しているプリセットにマッピングします。デフォルトロケールが非表示の場合は `mintlify-hide-default`、それ以外は `mintlify` です。
* `docsUrlPattern` — `/[locale]`。ドキュメント URL をローカライズする際に使うパターンです。
* `docsImportPattern` — `/snippets/[locale]`。スニペットの import をローカライズする際に使うパターンです。
* `generateRedirects` — `./docs.json`。ナビゲーションを再構成したあとも既存のリンクが引き続き参照できるよう、`docs.json` にリダイレクトを生成します。
* `experimentalLocalizeStaticImports` — `true`。静的 import パス (スニペットなど) をローカライズします。
* `experimentalLocalizeStaticUrls` — `true`。内部の静的 URL をローカライズし、リンクが閲覧中の言語内にとどまるようにします。
* `experimentalLocalizeRelativeAssets` — `true`。相対アセット参照をローカライズします。
* `experimentalAddHeaderAnchorIds` — `'mintlify'`。翻訳後のすべての見出しに Mintlify ネイティブの `{#id}` 構文を書き込みます。元の見出しの ID を使うため、ページ内リンクは言語をまたいでも同じ対象を指し続けます。JSX の深い位置にネストされた見出しは、Mintlify がこの構文を先頭の空白 3 個までしか認識しないため、余白側に移動されます。
* `docsHideDefaultLocaleImport` — `true` * (hide-default-locale モードのみ) *。生成される import でデフォルトロケールを非表示にします。
* `experimentalHideDefaultLocale` — `true` * (hide-default-locale モードのみ) *。デフォルトロケールをロケールプレフィックスなしで提供します。

## 例 [#example]

以下の例は、ソースロケールを非表示にするよう設定された既存のプロジェクト (ソースは英語、対象はスペイン語とフランス語) を示しています:

```json title="gt.config.json"
{
  "$schema": "https://assets.gtx.dev/config-schema.json",
  "files": {
    "json": {
      "include": ["./docs.json"]
    },
    "mdx": {
      "include": ["./**/*.mdx", "./**/*.md"],
      "transform": {
        "match": "^(snippets/)?(.*)$",
        "replace": "$1{locale}/$2"
      },
      "exclude": [
        "./[locales]/**/*.mdx",
        "./snippets/[locales]/**/*.mdx",
        "./[locales]/**/*.md",
        "./snippets/[locales]/**/*.md"
        // README.md、LICENSE.md、CHANGELOG.md などのリポジトリファイルも除外
      ]
    }
  },
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "options": {
    "mintlify": { "inferTitleFromFilename": true },
    "jsonSchema": { "./docs.json": { "preset": "mintlify-hide-default" } },
    "docsUrlPattern": "/[locale]",
    "docsImportPattern": "/snippets/[locale]",
    "generateRedirects": "./docs.json",
    "experimentalLocalizeStaticImports": true,
    "experimentalLocalizeStaticUrls": true,
    "experimentalLocalizeRelativeAssets": true,
    "docsHideDefaultLocaleImport": true,
    "experimentalHideDefaultLocale": true,
    "experimentalAddHeaderAnchorIds": "mintlify"
  }
}
```

*注: セットアップ後、CLI は `[locales]` の除外用プレースホルダーを実際のターゲットロケールに置き換えます。生成された `gt.config.json` を確認し、リポジトリ内で翻訳対象コンテンツが除外対象パスのいずれかに含まれている場合は、除外ファイルを調整してください。*

## Sitemap

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