# General Translation Knowledge Base: Как перевести сайт документации на Mintlify? URL: https://generaltranslation.com/ru/kb/translate-mintlify-docs.mdx Docs index: https://generaltranslation.com/llms.txt Description: Создайте переведённую копию каждой страницы в отдельной папке для каждого языка и добавьте все языки в навигацию docs.json. AI-агент General Translation под названием Locadex открывает пул-реквест, который добавляет переведённые страницы и навигацию для каждого языка, а затем переводит последующие изменения. Category: Инструменты для рабочих процессов Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Чтобы перевести сайт документации на Mintlify, нужно создать копию каждой страницы в отдельной папке для каждого языка и перечислить все языки в массиве `languages` в навигации `docs.json`. На страницах текст перемежается блоками кода, MDX-компонентами, frontmatter и ссылками, поэтому перевести нужно сам текст и поля `title` и `description`, код и компоненты должны остаться нетронутыми, а внутренние ссылки — вести на страницы на языке читателя. Кроме того, после любой правки исходной страницы её переводы устаревают, пока кто-нибудь их не обновит. ## Video The video is narrated in English, with English captions. [How do I translate a Mintlify docs site?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-translate-mintlify-docs.mp4) (47 с) General Translation lets you choose languages, and Locadex opens a translation pull request. Authorize the General Translation app on GitHub, choose your docs repository in the Dashboard, create an automation from the Generate translations and push template for Mintlify, run its setup with your languages, and merge the pull request that adds a navigation entry per language and the translated pages. ## Способы перевести сайт на Mintlify | Подход | Сильные стороны | Что остаётся на вас | | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Навигация `languages` в Mintlify с ручным переводом | Создаёт переключатель языка и дерево страниц для каждого языка на основе `docs.json` | Размещение каждой переведённой страницы в папке её языка, написание полной навигации для каждого языка и отслеживание того, какие переводы устарели после каждой правки источника | | Google Translate | Переводит вставленную страницу без какой-либо настройки | Переводит каждый фрагмент по отдельности; отделять текст от кода и компонентов, а также создавать папки и навигацию придётся вам | | Скрипт на базе AI API (OpenAI API, Claude API) | Можно поручить переводить текст, не трогая блоки кода и компоненты | Скрипт, который защищает синтаксис MDX, единообразно передаёт термины продукта на всех страницах, создаёт папки и навигацию и перезапускается при изменении страниц | | General Translation (Locadex) | Открывает пул-реквест с переведёнными страницами, навигацией для каждого языка и локализованными ссылками, а затем переводит каждое изменение по выбранному вами триггеру | Проверка и слияние пул-реквеста с настройкой, затем проверка последующих пул-реквестов или включение **Auto-merge** | Навигация Mintlify с ручным переводом подойдёт, если переводчики работают с несколькими редко меняющимися страницами; Google Translate или разовый скрипт на AI API — для однократного перевода небольшого стабильного сайта. Выбирайте General Translation, если документация меняется с каждым релизом и все языковые версии должны оставаться актуальными. ## Перевод документации Mintlify с помощью Locadex General Translation переводит документацию Mintlify с помощью Locadex — собственного AI-агента. Для работы с ним требуется тариф Starter или Enterprise. 1. В панели управления подключите GitHub в разделе **Проект > Integrations > Catalog**. 2. В разделе **Проект > Automations** создайте автоматизацию на основе шаблона **Generate translations and push**, выбрав **Mintlify** в качестве фреймворка. 3. Нажмите **Run setup** и выберите языки. 4. Проверьте пул-реквест, который откроет Locadex, и выполните слияние. Пул-реквест добавляет файл `gt.config.json`, запись навигации в `docs.json` для каждого языка и переведённые страницы. При этом код и компоненты сохраняют свою структуру, а ссылки на переведённые страницы не уводят читателя с выбранного языка. В диалоговом окне **Run setup** для Mintlify есть переключатель **Hide default locale in URL paths**, по умолчанию он включён: исходные страницы остаются по прежним путям, а для каждого языка перевода создаётся отдельная папка локали, например `/es/...`. Если отключить переключатель, исходные страницы тоже переместятся в папку локали (английские — в `/en/...`), и их URL изменятся. ## Поддерживайте переводы в актуальном состоянии Далее Locadex запускается при изменении пул-реквеста (по умолчанию) или при пуше коммита. При каждом запуске применяются назначенные проекту контекстные группы (Glossary и пользовательские промпты). Их можно использовать и в вашем приложении, поэтому названия продуктов будут совпадать и там, и там. Подробная инструкция — в разделе [Быстрый старт для Mintlify](/docs/integrations/mintlify/quickstart). ## Related questions - [Что делает агент Locadex?](https://generaltranslation.com/ru/kb/what-is-locadex.mdx): Locadex — это AI-агент General Translation, который интернационализирует ваш код и переводит контент в вашем репозитории GitHub. Его автоматизации запускаются при открытии пул-реквеста, при пуше коммита или вручную, а каждое изменение поступает в виде пул-реквеста. - [Как перевести контент в Sanity?](https://generaltranslation.com/ru/kb/translate-sanity-content.mdx): Храните каждый язык как отдельный документ или как значение для каждой локали в каждом поле, а затем переведите источник на все целевые локали. Плагин gt-sanity от General Translation добавляет в Sanity Studio действие Translate и по умолчанию импортирует каждый перевод как черновик, который вы проверяете и публикуете. - [Как перевести контент в Storyblok?](https://generaltranslation.com/ru/kb/translate-storyblok-content.mdx): В Storyblok добавьте целевые языки в пространство и задайте для каждого переводимого поля значение на каждом языке. Интеграция General Translation со Storyblok заполняет эти значения из панели управления с помощью действия «Синхронизировать и применить» — в виде черновиков, которые вы проверяете и публикуете в Storyblok. - [Как проверять и редактировать переводы?](https://generaltranslation.com/ru/kb/review-translations.mdx): Сравнивайте каждый перевод с источником и другими локалями и исправляйте то, что звучит неправильно. В General Translation переводы редактируются на странице «Переводы» в панели управления, а ход проверки отслеживается с помощью меток и комментариев. При следующем запуске перевода Locadex, AI-агент платформы, переносит правки в пул-реквест. ## Previous and next questions - Previous question: [Как перевести приложение на Vue?](https://generaltranslation.com/ru/kb/translate-vue-app.mdx) - Next question: [Как перевести строки вне JSX?](https://generaltranslation.com/ru/kb/translate-strings-outside-jsx.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/ru/kb/sitemap.md) for every article.