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

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

Интересует именно перевод? См. раздел Перевод MDX.

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

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

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

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

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

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

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

Любые из более чем 120 локалей, поддерживаемых General Translation, включая региональные варианты, такие как pt-BR и zh-Hant, и языки с написанием справа налево, например арабский и иврит. Укажите их в gt.config.json и добавляйте новые в любое время. См. Поддерживаемые Локали.

Да, по мере внесения изменений. Запускайте npx gt translate в CI перед сборкой документации. Команда переводит только контент, в источнике которого появились изменения, и сохраняет ваши локальные изменения. Так каждый релиз выходит на всех языках, а переводы включаются в него вместе с соответствующими изменениями.

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

Нет. CLI переводит человекочитаемое содержимое, сохраняя весь синтаксис и форматирование MDX, а явно заданные идентификаторы заголовков, такие как {#id}, остаются привязанными к своим заголовкам.

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