Локализуйте документацию Mintlify

Перевод — это передача контента с одного языка на другой. Интернационализация (i18n) готовит сайт к поддержке нескольких локалей: это касается маршрутизации, навигации, дат и форм множественного числа. Локализация (l10n) — более широкое понятие: адаптация всего продукта для каждой локали, от текста до форматирования. На сайте Mintlify интернационализация — это маршрутизация по локалям и многоязычная навигация, которые настраивает Locadex, а перевод — ваши страницы на каждом языке. General Translation обеспечивает непрерывную работу всего рабочего процесса локализации.

Нужен именно перевод? См. раздел Перевод документации Mintlify.

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

Ваши страницы — не просто текст. Компоненты MDX, инструкции импорта и блоки кода должны сохраняться в точности, ключи во frontmatter — оставаться прежними, а идентификаторы заголовков вроде {#configure-client} — оставаться на своих местах, чтобы ссылки на разделы не ломались.

Ваша документация — это сайт, а не одна страница. Для каждого языка нужна своя версия навигации, коды локалей должны соответствовать требованиям вашей платформы, а слово «workspace» должно переводиться одинаково и на первой, и на четырехсотой странице (и в вашем приложении, локализацию которого мы тоже поддерживаем).

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

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

General Translation берет на себя весь этот процесс end-to-end. Мы обрабатываем тысячи PRs по локализации для наших клиентов, чтобы они могли сосредоточиться на создании продукта, который полюбит весь мир.

Всего несколько минут — без миграции. Подключите репозиторий, выберите языки и выполните слияние пул-реквеста, созданного General Translation. После этого вы сможете переводить контент в больших объёмах (компания Ramp перевела 40 000 ключей — миллионы слов — за несколько минут). Вы также можете поручить настройку своему агенту для написания кода с помощью кнопки «Настройка для агентов».

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

Да, по мере внесения изменений. Наш Locadex Agent запускается по выбранным вами триггерам: при создании пул-реквеста, коммите или вручную. Он переводит только изменённый контент, а не весь сайт, и отправляет результат в виде пул-реквеста. Так каждый релиз выходит на всех языках, а переводы включаются в него вместе с соответствующими изменениями.

General Translation позволяет задавать пользовательские промпты с указаниями по тону и стилю, а также вести Glossary, закрепляющий названия продуктов и ключевые термины. Один и тот же контекст учитывается во всех ваших переводах: в приложении, на сайте, в документации, презентациях и дизайн-файлах.

Нет. При переводе человекочитаемого контента сохраняются синтаксис MDX и структура компонентов. Для сайтов Mintlify также переводятся заголовки и описания в метаданных frontmatter.

Оплата по мере использования — без платы за каждого пользователя и без подписок. На тарифе Starter плата за платформу составляет 0 $, количество проектов, пользователей и языков не ограничено, а для начала работы предоставляется бесплатный лимит. Полные расценки — на странице тарифов.