|
Documentação
Marcar uma demonstraçãoPlataforma
PlataformaMCPCLI
APIWorkflows
GuiasChangelog

Visão geral

  • @lingo.dev/cli

Primeiros passos

  • Início rápido
  • Configuração

Referência

  • lingo push
  • lingo pull
  • Outros comandos
  • lingo purge

Configuração

  • Controlos de chaves
  • Formatos
  • Idiomas

Guias

  • Adicionar um idioma
  • Traduções existentes
  • Retradução
  • Notas de tradução
  • Execuções, estado e recuperação
  • CI/CD
  • Monorepos
  • Projetos de grande escala

Está à procura da CLI anterior (v0)? Consulte a documentação da CLI anterior

CI/CD

lingo ci executa o pipeline de localização dentro de um job de CI e devolve os resultados ao seu repositório — quer fazendo commit para a branch, quer abrindo um pull request. Deteta automaticamente a plataforma (GitHub Actions, GitLab CI, Bitbucket Pipelines) e configura por si a identidade do git, o remoto e a branch.

Utilização básica#

bash
lingo ci

Por predefinição, executa a etapa de tradução e depois faz commit diretamente de todas as novas traduções para a branch atual.

Escolher a etapa#

--step escolhe o comando a executar como etapa de tradução (por predefinição, localize). Para o workflow de ficheiros push/pull, use push:

bash
lingo ci --step push

Etapas permitidas: localize, ship, push, extract.

Commit vs. pull request#

Faça commit para a branch (predefinição) ou abra/atualize um PR a partir de uma branch dedicada lingo.dev/*:

bash
lingo ci --step push --pull-request

Opções úteis:

OpçãoEfeito
--pull-requestAbre/atualiza um PR em vez de fazer commit para a branch base.
--commit-message <msg>Mensagem de commit. Predefinição: feat: update translations via @lingodotdev.
--pull-request-title <title>Título do PR.
--commit-author-name / --commit-author-emailAutor do git. Por predefinição: Lingo.dev / support@lingo.dev.
--working-directory <dir>Faz cd primeiro numa subdiretoria — para monorepos.
--gpg-signAssina o commit com a chave GPG configurada.
--process-own-commitsNão ignore a execução quando o último commit já tiver sido criado por Lingo.dev.

Exemplo com GitHub Actions#

Autentique-se com uma chave de API (lingo login --api-key ou defina-a como secret) e execute em cada merge para a branch predefinida:

yaml
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 }}

Isto traduz conteúdo de origem novo e alterado em cada push para main e abre um PR com os resultados para revisão.

Esta página foi útil?

Max PrilutskiyMax Prilutskiy·Atualizado há 4 dias·1 min de leitura