# 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

---

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

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

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

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

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

1. В панели управления откройте **Проект > Интеграции > Каталог**.
2. Подключите GitHub и авторизуйте General Translation GitHub App для репозитория с вашей документацией Mintlify.
3. Откройте **Проект > Automations** и выберите **Сгенерировать переводы и выполнить push**.
4. Выберите репозиторий, целевую директорию и фреймворк **Mintlify**.

## Укажите целевую директорию [#target-directory]

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

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

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

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

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

## Выберите структуру URL для локали по умолчанию [#default-locale-url]

Настройка, запущенная из **Проект > Automations**, создаёт структуру с префиксом локали для каждого языка, включая исходную локаль. Например, исходные страницы на английском будут доступны по пути `/en/...`.

Существующие проекты, настроенные скрывать исходную локаль, продолжат отдавать исходные страницы по их исходным путям. Это поведение фиксируется в сгенерированном `gt.config.json`; см. [справочник по конфигурации](/docs/integrations/mintlify/reference/config#options).

Этот вариант структуры URL влияет на то, как Locadex перестраивает файлы и навигацию в `docs.json`. Перед слиянием проверьте pull request, созданный при настройке.

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

Locadex открывает или обновляет pull request со своими изменениями. Он повторно использует открытый PR для той же ветки automation и открывает новый после слияния или закрытия предыдущего PR.

Для новых automation перевода по умолчанию используется **A pull request changes**, а **Auto-merge** отключён. Выберите **A commit is pushed**, чтобы переводить изменения после их попадания в целевую ветку, и включите **Auto-merge**, если ветка надёжно защищена обязательными проверками. См. [Автослияние PR Locadex](/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