# General Translation Integrations: Использование переведенного контента
URL: https://generaltranslation.com/ru/docs/integrations/mintlify/guides/using-translated-content.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Как предоставлять переведенную документацию Mintlify с многоязычной навигацией, маршрутизацией по локалям и перенаправлениями.

После слияния установочного pull request ваш сайт Mintlify будет обслуживать все выбранные вами языки. В этом руководстве объясняется, какие изменения интеграция вносит в ваш проект, чтобы читатели попадали на нужный язык.

## Многоязычная навигация [#navigation]

Locadex преобразует навигацию из `docs.json` в многоязычную структуру Mintlify, создавая по одной навигационной записи для каждого языка. Mintlify использует это, чтобы отображать переключатель языка и строить дерево страниц для каждого языка. Если ваша навигация находится в отдельном файле, на который ссылаются через `$ref`, Locadex записывает изменения туда и сохраняет `$ref` в `docs.json`.

## Маршрутизация URL и локаль по умолчанию [#routing]

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

Существующие проекты могут иметь сгенерированную конфигурацию, которая скрывает префикс исходной локали. В такой схеме исходные страницы сохраняют свои исходные пути, а префикс добавляется только для переведённых языков.

(Подробности о том, что даёт каждый режим, см. в [справочнике по конфигурации](/docs/integrations/mintlify/reference/config)).

## Перенаправления и локализованные ссылки [#redirects]

В режиме show-default-locale Locadex локализует исходные и целевые пути существующих перенаправлений верхнего уровня в `docs.json`. Новые записи перенаправлений при этом не создаются. Locadex также локализует внутренние ссылки, статические URL и относительные ссылки на ресурсы, чтобы при просмотре пользователи оставались в пределах своего языка. Ссылки на страницы, у которых нет перевода, по-прежнему ведут на исходный URL.

Если вы запускаете CLI напрямую, включите [`options.mintlify.localizeRedirects`](/docs/integrations/mintlify/reference/config#localized-redirects), чтобы для каждой локали добавлялись копии перенаправлений исходной локали, когда исходная страница переименована или удалена в рамках того же запуска перевода. В конфигурациях, созданных при настройке, этот опциональный параметр отсутствует. CLI не изменяет существующие записи и пропускает локали, для которых нет переведённого целевого пути.

## Страницы OpenAPI [#openapi]

Если в вашем репозитории есть спецификации OpenAPI 3.x в формате JSON или YAML, Locadex регистрирует их переводы в конфигурации Mintlify. После этого Mintlify может отдавать каждую спецификацию по пути соответствующей локали.

Регистрации OpenAPI за пределами `navigation.languages` по-прежнему ссылаются на исходную спецификацию. Регистрации в навигации целевого языка указывают на переведённую спецификацию для этой локали.

## Развертывание [#deploy]

Интеграция изменяет только файлы в вашем репозитории, поэтому публикация работает точно так же, как и в любом проекте Mintlify: выполните merge pull request, и ваш обычный процесс развертывания Mintlify соберет сайт. Никакой дополнительный этап развертывания не требуется.

## Next steps

- /docs/integrations/mintlify/guides/translating-content
- /docs/integrations/mintlify/guides/managing-translations
- /docs/integrations/mintlify/guides/configuring-mintlify

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.