Интеграции
Настройте перевод в репозиториях и CMS, запускайте локализацию в CI, собирайте данные из Crowdin или разбирайте отзывы из Jira.
Используйте Lingo.dev вместе с инструментами, в которых ваша команда создаёт, переводит и проверяет контент. У каждого подключения своя задача: одни возвращают переводы в исходную систему, другие собирают данные или помогают разбирать отзывы.
Переводите контент там, где он хранится #
Эти встроенные интеграции читают выбранный исходный контент, переводят его с помощью движка локализации и записывают результат обратно, используя предоставленный вами доступ к сервису.
| Подключение | Что запускает работу | Куда возвращаются переводы |
|---|---|---|
| GitHub | Настроенные события репозитория или команда перевода с заданной областью действия | В пул-реквест с переводами изменений из ветки по умолчанию или в виде коммитов в ветку пул-реквеста, который соответствует условиям. |
| Payload | Ручная синхронизация или уведомления плагина об изменении исходного контента | В локализованные поля тех же коллекций и глобальных объектов для выбранных целевых локалей. |
| WordPress | Синхронизация вручную или при сохранении опубликованных записей по уведомлению плагина | Связанный с каждой записью перевод в Polylang или WPML на выбранных языках. |
| Справочный центр Zendesk | Ручная синхронизация | В языковые версии выбранных категорий, разделов и статей. |
Настройки сервиса определяют, к каким данным будет доступ. Для GitHub выберите репозитории и шаблоны исходных файлов. Для Payload — коллекции и глобальные объекты с локализованными полями. Для WordPress — типы записей. Для Zendesk выбирайте категории, разделы и статьи отдельно: при выборе категории вложенные элементы не выбираются.
Порядок публикации также зависит от платформы. В режиме «Публикация» Payload не записывает данные в опубликованный документ, если в нём есть неопубликованные изменения. Сначала их нужно опубликовать или отменить, иначе вместе с переводом опубликуются и они. В Zendesk запись черновика может сделать уже опубликованную версию для локали недоступной до повторной публикации. Перед первой записью прочитайте раздел о публикации для нужной платформы, особенно если переводы уже есть.
Запускайте перевод в своём пайплайне #
GitHub Actions, GitLab CI, Bitbucket Pipelines и Buildkite запускают CLI на вашем раннере. Готовые конфигурации сначала используют скачиваемые артефакты или одну доверенную ветку — так вы можете проверить результат, прежде чем расширять права на запись в репозиторий. После коммита с .lingo/lock.json команда lingo check завершает проверку запроса на включение изменений или слияние с ошибкой, если исходный текст изменился с момента последнего перевода или целевой файл отсутствует. Ключ API не нужен.
Ваш пайплайн отвечает за расписание, секреты, хранение результатов и создание коммитов или пул-реквестов. Ключ API Lingo.dev даёт доступ к переводу, а учётные данные сервиса — к записи в репозиторий. В статье Как автоматизировать перевод в CI объясняется, как связать версии исходного контента, готовые результаты и проверки приложения.
Оценивайте переводы или разбирайте отзывы #
Crowdin передаёт в Radar данные о поддерживаемых действиях со строками. Так вы можете оценивать переводы из Crowdin, не перенося рабочий процесс их создания или проверки. Настройте измерение под вопрос, на который хотите получить ответ, затем изучите собранный текст и результат измерения. Это подключение не отправляет исправленные переводы обратно в Crowdin.
Работа с Jira начинается с сообщения о проблеме. Добавление метки lingo запускает рабочий процесс разбора: он изучает задачу и предлагает изменения в глоссарии, правилах или тональности бренда. Люди применяют или отклоняют каждое предложение, а затем решают, нужно ли повторно переводить затронутый контент из подключённых систем. При разборе задачи Jira её содержимое не переводится как проект локализации.
Завершите первый запуск, прежде чем расширять охват #
На странице каждого сервиса есть инструкция для пробного запуска с небольшим объёмом контента: авторизация, настройка, проверка результатов и восстановление. Этот запуск поможет понять, что подключение читает и меняет. Доступность подключения может зависеть от разрешений в организации и доступа к функциям. Одних учётных данных сервиса недостаточно для доступа к движку локализации.
Когда подключение больше не нужно, остановите новые запуски по триггерам и отдельно решите, что делать с учётными данными сервиса. Отключение не отменяет уже отправленный контент, опубликованные комментарии или записанные измерения. В разделе о восстановлении для выбранного сервиса объясняется, какое состояние сохранится и что произойдёт при повторном подключении.
Если рабочим процессом управляет ваше приложение, перейдите в раздел DevTools: там описаны API, CLI и интерфейсы JavaScript.