Переведите свою документацию MDX

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

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 $, количество проектов, пользователей и языков не ограничено, а для начала работы предоставляется бесплатный лимит. Полные расценки — на странице тарифов.