---
title: Перевод сайта MkDocs с помощью ИИ | Smartcat
description: Переведите ваш сайт MkDocs с помощью ИИ и выполните его рецензирование в контексте. Установите через переопределение темы для блока head.
canonical: https://ru.smartcat.com/integrations/mkdocs/
language: ru
updated: 2026-11-16
---

# Перевод сайта MkDocs с помощью ИИ | Smartcat

## Переведите свой сайт MkDocs с помощью ИИ

Добавьте фрагмент кода веб-сайта Smartcat в свой проект MkDocs один раз, разверните его через свой обычный пайплайн и проверьте переводы в Smartcat перед публикацией языка.

- [Попробовать бесплатно](https://smartcat.com/sign-up)

- [Заказать демо-версию](https://www.smartcat.com/book-a-demo/?mkdocs)

## Как добавить Smartcat в MkDocs

Создайте проект веб-сайта Smartcat на основе вашего опубликованного URL-адреса MkDocs и выберите языки перевода.

Установите сгенерированный фрагмент кода Smartcat с помощью переопределения темы для блока head (параметр extra_javascript загружает только ресурсы).

Разверните изменения и откройте опубликованный сайт, чтобы убедиться в наличии фрагмента кода.

Проверьте переводы в визуальном редакторе Smartcat и опубликуйте готовые языки.

## Перевести сайт MkDocs без редактирования сгенерированного HTML

Сохраните интеграцию в конфигурации вашего оригинала текста MkDocs. extra_javascript загружает ресурсы JavaScript, в то время как переопределение темы может потребоваться, если предоставленная установка требует разметки в head. В Material for MkDocs используйте поддерживаемое расширение шаблона вместо изменения установленного пакета темы.

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

## Какие изменения ждут посетителей, а что останется в MkDocs

Перевод веб-сайта вносит изменения в опубликованный читательский опыт. Он не создает переведенные файлы оригинала текста, каталоги сообщений или сборки локалей в вашем репозитории MkDocs.

## Рецензирование перед запуском языка

Машинный перевод дает вам быстрый первый черновик. В визуальном редакторе Smartcat вы видите каждую переведенную строку на странице, можете сокращать заголовки, которые слишком длинны для мобильных устройств, и сохранять единообразие названий продуктов и брендов с помощью глоссария. Назначьте рецензента, когда странице требуется утверждение, и публикуйте только те языки, которые готовы.

## Часто задаваемые вопросы

### Могу ли я вставить HTML-теги script в extra_javascript?

extra_javascript — это конфигурация ресурсов, а не поле заголовка HTML произвольной формы. Следуйте его поддерживаемой структуре и используйте переопределение темы, когда требуется фактическая разметка.

### Могу ли я выполнять редактирование переводов перед публикацией?

Да. Доработайте и подтвердите формулировки в визуальном редакторе Smartcat, затем опубликуйте готовые языки.

### Что происходит, когда я добавляю новую страницу в MkDocs?

Новый текст следует режиму перевода, который был выбран для проекта Smartcat. Выбирайте проверенные переводы, когда каждая новая страница требует утверждения; автоматические режимы могут переводить вновь встречающийся текст. Ни один из режимов не вносит изменения в ваш оригинал текста в MkDocs.

Опубликуйте свой сайт на MkDocs на нескольких языках

Установите фрагмент кода один раз, проверяйте переводы в контексте и публикуйте языки, необходимые вашей аудитории. Посмотреть все [интеграции для веб-сайтов](https://www.smartcat.com/integrations/category/website-translation/) или узнать, как работает [переводчик веб-сайтов](https://www.smartcat.com/website-translator/).

- [Попробовать бесплатно](https://smartcat.com/sign-up)
