# General Translation Integrations: Конфигурация
URL: https://generaltranslation.com/ru/docs/integrations/mintlify/reference/config.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Справочник по `gt.config.json`, который General Translation генерирует для проекта Mintlify. Справочник по конфигурации интеграции Mintlify.

General Translation генерирует `gt.config.json` для вашего проекта Mintlify на этапе настройки — вручную создавать этот файл не нужно. На этой странице описано, что он содержит, чтобы вы могли проверить или при необходимости донастроить его после принятия pull request с настройкой.

Это стандартная конфигурация CLI General Translation. Каждый общий key описан один раз в [справочнике по конфигурации CLI](/docs/cli/reference/config); на этой странице рассматриваются только варианты, специфичные для Mintlify, и два режима, которые генерирует интеграция.

## Режимы [#modes]

Если запустить настройку из **проект > 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)                     | Преобразует исходные пути в пути с папками локалей. | `{ match: "^(snippets/)?(.*)$", replace: "$1{locale}/$2" }` | *(нет)*                                                                   |
| [`options.jsonSchema`](#options)                    | Предустановка для локализации `docs.json`.          | `mintlify-hide-default`                                     | `mintlify`                                                                |
| [`options.docsHideDefaultLocaleImport`](#options)   | Скрывать локаль по умолчанию в импортах.            | `true`                                                      | *(опущено)*                                                               |
| [`options.experimentalHideDefaultLocale`](#options) | Отдавать локаль по умолчанию без префикса локали.   | `true`                                                      | *(опущено)*                                                               |

## Файлы [#files]

Блок `files` указывает CLI General Translation, что нужно переводить. Для проекта Mintlify он всегда включает `docs.json` и страницы документации.

* `files.json.include` — всегда `['./docs.json']`. Навигация и подписи в `docs.json` локализуются с помощью пресета в `options.jsonSchema`.
* `files.mdx.include` — страницы `.mdx` и `.md`, которые нужно переводить. В режиме hide-default-locale это всё дерево (`./**/*.mdx`, `./**/*.md`), а transform перемещает файлы в папки локалей; в режиме show-default-locale используются существующие папки для каждой локали.
* `files.mdx.transform` — в режиме hide-default-locale переписывает каждый исходный путь в папку `{locale}/` (сохраняя начальный префикс `snippets/` на месте). В режиме show-default-locale `transform` не используется, потому что контент уже находится в папках локалей.
* `files.mdx.exclude` — сами папки локалей, а также общие файлы репозитория, которые никогда не следует переводить (см. [Поддерживаемый контент](/docs/integrations/mintlify/reference/supported-content#excluded)).

(Полное описание семантики `files`, `include`, `exclude` и `transform` см. в [справочнике по конфигурации CLI](/docs/cli/reference/config), а особенности отдельных форматов — на [странице о формате MDX и Markdown](/docs/cli/reference/formats/mdx-md-files) и [странице о формате JSON](/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]`. Шаблон, используемый при локализации импортов сниппетов.
* `generateRedirects` — `./docs.json`. Создает перенаправления в `docs.json`, чтобы существующие ссылки продолжали работать после перестройки навигации.
* `experimentalLocalizeStaticImports` — `true`. Локализует пути статических импортов (например, сниппетов).
* `experimentalLocalizeStaticUrls` — `true`. Локализует внутренние статические URL-адреса, чтобы ссылки оставались в пределах языка читателя.
* `experimentalLocalizeRelativeAssets` — `true`. Локализует относительные ссылки на ресурсы.
* `experimentalAddHeaderAnchorIds` — `'mintlify'`. Добавляет к каждому переведенному заголовку нативный для Mintlify синтаксис `{#id}`, используя ID исходного заголовка, чтобы внутристраничные ссылки вели на одну и ту же цель на разных языках. Заголовки с глубокой вложенностью в JSX сдвигаются к краю, поскольку Mintlify распознает этот синтаксис только при не более чем трех ведущих пробелах.
* `docsHideDefaultLocaleImport` — `true` *(только для режима hide-default-locale)*. Скрывает локаль по умолчанию в сгенерированных импортах.
* `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.