lingo ci executa o pipeline de localização dentro de um job de CI e devolve os resultados ao seu repositório — seja com commit na branch ou abrindo um pull request. Ele detecta automaticamente a plataforma (GitHub Actions, GitLab CI, Bitbucket Pipelines) e configura para você a identidade do git, o remote e a branch.
consumo básico#
lingo ciPor padrão, ele executa a etapa de tradução e depois faz commit de qualquer nova tradução diretamente na branch atual.
Escolha da etapa#
--step define qual comando será executado como etapa de tradução (o padrão é localize). Para o workflow de arquivos push/pull, use push:
lingo ci --step pushEtapas permitidas: localize, ship, push, extract.
Commit vs. pull request#
Faça commit na branch (padrão) ou abra/atualize um PR a partir de uma branch dedicada lingo.dev/*:
lingo ci --step push --pull-requestFlags úteis:
| Flag | Efeito |
|---|---|
--pull-request | Abre/atualiza um PR em vez de fazer commit na branch base. |
--commit-message <msg> | Mensagem de commit. Padrão: feat: update translations via @lingodotdev. |
--pull-request-title <title> | Título do PR. |
--commit-author-name / --commit-author-email | Autor do git. O padrão é Lingo.dev / support@lingo.dev. |
--working-directory <dir> | Execute cd primeiro em um subdiretório — para monorepos. |
--gpg-sign | Assina o commit com a chave GPG configurada. |
--process-own-commits | Não ignore a execução quando o último commit já tiver sido criado por Lingo.dev. |
Exemplo com GitHub Actions#
Autentique com uma chave de API (lingo login --api-key ou defina-a como secret) e execute a cada merge na branch padrão:
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 }}Isso traduz o conteúdo-fonte novo e alterado a cada push para main e abre um PR com os resultados para revisão.
