# General Translation Integrations: 設定
URL: https://generaltranslation.com/ja/docs/integrations/mintlify/reference/config.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Mintlify プロジェクト用に生成された 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`                                                      | *(省略)*                                                                 |
| [`options.experimentalClearLocaleDirs`](#options)   | 翻訳を書き込む前に、生成済みのロケールディレクトリを削除します。 | `true`                                                      | `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) を参照) 。

リポジトリに JSON または YAML 形式の OpenAPI 3.x 仕様が含まれている場合、Locadex は各 source 仕様を `files.json` または `files.yaml` に追加します。あわせて、翻訳済みの仕様を対応するロケールのディレクトリに書き出す transform も追加します。

(`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`。ページに明示的なタイトルがない場合、ファイル名からページタイトルを生成します。
* [`mintlify.localizeRedirects`](#localized-redirects) — 任意で、デフォルトは `false` です。セットアップで生成される設定には含まれません。有効にすると、現在の [`gt translate`](/docs/cli/reference/commands/translate) の実行で名前が変更または削除されたソースページについて、ローカライズ版のリダイレクトを追加します。
* `mintlify.openapi.files` — 検出された OpenAPI 3.x 仕様へのパス *(存在する場合)*。翻訳された仕様を Mintlify に登録します。
* `jsonSchema` — `./docs.json` を、Mintlify のナビゲーションのローカライズ方法を理解しているプリセットにマッピングします。デフォルトロケールが非表示の場合は `mintlify-hide-default`、それ以外は `mintlify` です。検出された JSON 形式の OpenAPI 仕様には `openapi` プリセットが使われます。
* `yamlSchema` — 検出された YAML 形式の OpenAPI 仕様を `openapi` プリセットにマッピングします *(存在する場合)*。
* `docsUrlPattern` — `/[locale]`。ドキュメント URL をローカライズする際に使うパターンです。
* `docsImportPattern` — `/snippets/[locale]`。スニペットの import をローカライズする際に使うパターンです。
* `experimentalLocalizeStaticImports` — `true`。静的 import パス (スニペットなど) をローカライズします。
* `experimentalLocalizeStaticUrls` — `{ "skipUntranslatedPages": true }`。内部の静的 URL をローカライズし、リンクが閲覧中の言語内にとどまるようにします。ただし、リンク先のページが未翻訳の場合は、リンクを元の URL のまま残します。
* `experimentalLocalizeRelativeAssets` — `true`。相対アセット参照をローカライズします。
* `experimentalClearLocaleDirs` — `true`。翻訳を書き込む前に生成済みのロケールディレクトリをクリアし、削除されたソースページに対応する古い翻訳ページが残らないようにします。
* `experimentalAddHeaderAnchorIds` — `'mintlify'`。翻訳後のすべての見出しに Mintlify ネイティブの `{#id}` 構文を書き込みます。元の見出しの ID を使うため、ページ内リンクは言語をまたいでも同じ対象を指し続けます。JSX の深い位置にネストされた見出しは、Mintlify がこの構文を先頭の空白 3 個までしか認識しないため、余白側に移動されます。
* `docsHideDefaultLocaleImport` — `true` * (hide-default-locale モードのみ) *。生成される import でデフォルトロケールを非表示にします。
* `experimentalHideDefaultLocale` — `true` * (hide-default-locale モードのみ) *。デフォルトロケールをロケールプレフィックスなしで提供します。

### ローカライズされたリダイレクト

**型** `boolean` · **任意** · **デフォルト** `false`

`options.mintlify.localizeRedirects` を `true` に設定すると、ソースロケールのリダイレクトエントリのうち、同じ [`gt translate`](/docs/cli/reference/commands/translate) の実行中にリダイレクト元のページが名前変更または削除されたものについて、ロケールごとのコピーが追加されます。CLI は元のリダイレクトを変更せず、アンカーと `permanent` の値もそのまま保持します。リダイレクト先のページに翻訳がない場合、そのロケールはスキップされます。

このオプションを使用するには、各 URL にロケールを含めるための `options.docsUrlPattern` が必要です。ソースロケールのパスをプレフィックスなしのままにするかどうかは、`options.experimentalHideDefaultLocale` で制御します。`docsUrlPattern` が指定されていない場合、CLI は警告を出力し、リダイレクトは追加されません。

## 例 [#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"
      ]
    }
  },
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "options": {
    "mintlify": {
      "inferTitleFromFilename": true,
      "localizeRedirects": true
    },
    "jsonSchema": { "./docs.json": { "preset": "mintlify-hide-default" } },
    "docsUrlPattern": "/[locale]",
    "docsImportPattern": "/snippets/[locale]",
    "experimentalLocalizeStaticImports": true,
    "experimentalLocalizeStaticUrls": {
      "skipUntranslatedPages": true
    },
    "experimentalLocalizeRelativeAssets": true,
    "experimentalClearLocaleDirs": 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.