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. |
| Rails | YAML с локалью в корневом ключе и поиск средствами фреймворка. |
| Laravel | Файлы ресурсов и загрузка средствами фреймворка. |
Для ресурсов платформ и документов используются CLI и соответствующие обработчики форматов. Само по себе их присутствие в этой подборке примеров не означает, что им нужна среда выполнения React.