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

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

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

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

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

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

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

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

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

Locadex настраивает проекты Mintlify, Fern и Docusaurus и открывает пул-реквест с конфигурацией и переведёнными страницами. Для документации на других платформах CLI gt переводит файлы Markdown и MDX, используя настройки из gt.config.json.

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

Это зависит от вашей платформы. Для сайта на Mintlify доступны все языки, которые поддерживает Mintlify, а для файлов Markdown и MDX, переводимых с помощью CLI gt, — любая из более чем 120 локалей, поддерживаемых General Translation.

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

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

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

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