# General Translation Integrations: Настройка Mintlify
URL: https://generaltranslation.com/ru/docs/integrations/mintlify/guides/configuring-mintlify.mdx
---

title: Настройка Mintlify
description: "Как подключить репозиторий документации Mintlify к General Translation: в этом руководстве объясняется, как выбрать языки и настроить запуск переводов."
related:
  links:
    - /docs/integrations/mintlify/guides/translating-content
    - /docs/integrations/mintlify/guides/managing-translations
    - /docs/integrations/mintlify/guides/using-translated-content

---

# Настройка Mintlify

Подключите GitHub-репозиторий с вашей документацией Mintlify к General Translation, затем выберите языки и укажите, как должны выполняться переводы. В [Quickstart](/docs/integrations/mintlify/quickstart) описан самый быстрый способ; в этом руководстве параметры настройки разобраны подробнее.

Интеграция работает на базе [Locadex](/docs/platform/locadex/quickstart), поэтому она настраивается через **Locadex > Agent** в Dashboard, а не через пакет или файл конфигурации, который нужно редактировать вручную.

## Перед началом [#before-start]

* [Проект](/docs/platform/dashboard/get-started) в General Translation на тарифе, включающем функцию `locadex_workflows`.
* Репозиторий GitHub с корректным проектом Mintlify. Locadex проверяет, есть ли в репозитории файл `docs.json`, у которого `$schema` указывает на Mintlify. Проекты, которые всё ещё используют устаревший `mint.json` (сначала перенесите их на `docs.json`) или выглядят как приложение Next.js, отклоняются.

## Подключите и привяжите репозиторий [#connect]

1. В Dashboard откройте свой проект и перейдите в **Locadex > Agent**.
2. Нажмите **Connect GitHub** и авторизуйте приложение General Translation для GitHub в репозиториях, к которым Locadex должен получить доступ.
3. Выберите репозиторий, в котором находится ваша документация Mintlify. К каждому проекту можно привязать только один репозиторий.

## Укажите корневой каталог приложения [#app-directory]

Если ваш `docs.json` находится в корне репозитория, оставьте корневой каталог приложения пустым или укажите `.`. Если документация находится в подкаталоге (например, в монорепозитории), укажите этот путь в качестве корневого каталога приложения, чтобы Locadex работал с нужной папкой. См. [Monorepos](/docs/platform/locadex/guides/using-in-monorepos).

## Выберите языки [#languages]

Укажите **локаль по умолчанию** (язык, на котором написана ваша документация) и **целевые языки**, на которые нужно переводить.

Mintlify поддерживает фиксированный набор кодов языков, а General Translation сопоставляет с ними выбранные вами локали. Использовать можно только те локали, которые соответствуют поддерживаемому в Mintlify языку. См. [Locales](/docs/integrations/mintlify/reference/locales).

Если вы захотите изменить языки позже, см. [Управление переводами](/docs/integrations/mintlify/guides/managing-translations).

## Скрыть локаль по умолчанию [#hide-default]

Используйте переключатель **Скрывать локаль по умолчанию в путях URL**, чтобы управлять тем, как обслуживается ваш исходный язык:

* **Вкл.** (по умолчанию): страницы для локали по умолчанию сохраняют текущие пути (без префикса локали), а префикс локали добавляется только для переведённых языков.
* **Выкл.**: каждый язык, включая язык по умолчанию, обслуживается по собственному префиксу локали.

Этот выбор меняет то, как Locadex перестраивает ваши файлы и навигацию `docs.json`. Точное описание того, что даёт каждый режим, см. в [справочнике по конфигурации](/docs/integrations/mintlify/reference/config).

## Настройте, как запускаются переводы [#triggers]

Locadex открывает pull request для каждого изменения, которое он вносит. В репозиториях с документацией он срабатывает при появлении новых коммитов в вашей ветке по умолчанию и может автоматически сливать pull request с переводами после успешного прохождения проверок, чтобы ваша документация оставалась переведённой без ручных действий. Вы можете в любой момент просмотреть эти настройки и изменить триггер или поведение автослияния — см. [Автослияние](/docs/platform/locadex/guides/auto-merging-prs).
## Next steps

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