# General Translation Integrations: 設定
URL: https://generaltranslation.com/ja/docs/integrations/mintlify/reference/config.mdx
---

title: 設定
description: Mintlify プロジェクト向けに General Translation が生成する `gt.config.json` のリファレンス。Mintlify 連携の設定リファレンス。

---

# 設定

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

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

## モード [#modes]

生成される設定は、**URL パスでデフォルトロケールを非表示にする**設定に応じて変わります ([Mintlify の設定](/docs/integrations/mintlify/guides/configuring-mintlify)を参照) 。どちらのモードでも `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'`。安定した見出しアンカー ID を追加し、ページ内リンクが言語をまたいでも機能し続けるようにします。
* `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` を確認し、リポジトリ内で翻訳対象コンテンツが除外対象パスのいずれかに含まれている場合は、除外ファイルを調整してください。*