JavaScript и React

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

В JavaScript-приложениях перевод нужен в двух местах. Сервер отправляет контент в движок локализации и сохраняет результат. Интерфейс загружает переведённые сообщения и выводит их с нужными значениями, грамматикой и форматированием. Выберите пакет для той части приложения, которую разрабатываете.

Переводите контент на сервере #

В руководстве по JavaScript API вы узнаете, как создавать задания на перевод с помощью встроенного fetch, отслеживать их выполнение и скачивать готовые файлы. Храните ключ API на сервере и сохраняйте идентификатор каждого задания вместе с версией исходного контента, для которой оно создано.

Для приложений на LingoDotDevEngine есть отдельный справочник по SDK v0. В нём по-прежнему описаны Синхронный API и пакетная обработка на стороне клиента.

Выводите сообщения в React #

В React исходное сообщение и его контекст хранятся в компоненте. Каталог содержит переведённый шаблон, а среда выполнения подставляет значения и создаёт React-элементы, которыми управляет ваше приложение. Для вывода сообщений ключ API перевода не нужен.

Начните с одного переведённого компонента и локального каталога. По мере роста приложения извлекайте сообщения и загружайте каталоги. Примеры для Next.js Pages и TanStack Start показывают, как связать эти каталоги с запросами, маршрутами и переключением языка. Если у вас собственный маршрутизатор, locale-router предоставит базовую логику работы с URL и выбора языка с учётом предпочтений.

Подключите приложение на Payload #

Плагин для Payload CMS предоставляет схему полей и уведомляет Lingo.dev об изменениях исходного контента. Интеграция с Payload позволяет настроить, какой контент переводить и куда сохранять перевод.

Примеры проектов #

Эти репозитории показывают, как исходные файлы связаны с загрузкой данных в приложении. Прежде чем адаптировать проект, изучите версии его зависимостей и настройки. Некоторые проекты используют другое поколение пакетов, чем описанное в этих руководствах. Если вы работаете в форке, подключите собственный проект Lingo.dev, прежде чем отправлять задания на перевод.

ПроектС чего начать
React + ViteСообщения в компонентах, их извлечение и загрузка каталогов.
Next.js PagesСообщения на страницах и маршруты с учётом локали.
Модули TypeScriptЭкспортируемые статические данные локали. Используйте формат экспорта по умолчанию, который поддерживает обработчик TypeScript. При неподдерживаемом формате экспорта единицы перевода могут не обнаружиться.
iOSРесурсы Apple и выбор локали средствами платформы.
AndroidКаталоги ресурсов и поиск строк.
FlutterМетаданные ARB и сгенерированные сообщения.
MarkdownПути к документам и метаданные в начале файла.
Markdoc + Next.jsПереводимые свойства тегов и вывод документов.
OpenAPIОписания для людей в спецификации API.
RailsYAML с локалью в корневом ключе и поиск средствами фреймворка.
LaravelФайлы ресурсов и загрузка средствами фреймворка.

Для ресурсов платформ и документов используются CLI и соответствующие обработчики форматов. Само по себе их присутствие в этой подборке примеров не означает, что им нужна среда выполнения React.