lingo ci запускает пайплайн локализации прямо в CI-задаче и возвращает результаты в ваш репозиторий — либо коммитом в ветку, либо через открытие pull request. Он автоматически определяет платформу (GitHub Actions, GitLab CI, Bitbucket Pipelines) и сам настраивает git identity, remote и branch.
Базовое использование#
lingo ciПо умолчанию запускается шаг перевода, после чего все новые переводы сразу коммитятся в текущую ветку.
Выбор шага#
--step сам определяет, какую команду запускать на шаге перевода (по умолчанию localize). Для Процесса с файлами push/pull используйте push:
lingo ci --step pushДопустимые шаги: localize, ship, push, extract.
Коммит или pull request#
Сделайте коммит в ветку (по умолчанию) или откройте/обновите PR из отдельной ветки lingo.dev/*:
lingo ci --step push --pull-requestПолезные флаги:
| Флаг | Что делает |
|---|---|
--pull-request | Открывает или обновляет PR вместо коммита в основную ветку. |
--commit-message <msg> | Сообщение коммита. По умолчанию: feat: update translations via @lingodotdev. |
--pull-request-title <title> | Заголовок PR. |
--commit-author-name / --commit-author-email | Автор Git. По умолчанию: Lingo.dev / support@lingo.dev. |
--working-directory <dir> | Сначала выполните cd в подкаталог — для monorepos. |
--gpg-sign | Подписывает коммит настроенным GPG-ключом. |
--process-own-commits | Не пропускает запуск, если последний коммит уже был создан Lingo.dev. |
Пример для GitHub Actions#
Пройдите аутентификацию с API-ключом (lingo login --api-key или сохраните его как secret) и запускайте на каждом merge в ветку по умолчанию:
name: Translate
on:
push:
branches: [main]
jobs:
localize:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npx @lingo.dev/cli@latest ci --step push --pull-request
env:
LINGO_API_KEY: ${{ secrets.LINGO_API_KEY }}При каждом push в main будут переводиться новые и изменённые исходные тексты, а затем откроется PR с результатами для проверки.
