|
Documentación
Agenda una demoPlataforma
PlataformaMCPCLI
APIFlujos de trabajo
GuíasRegistro de cambios

Descripción general

  • @lingo.dev/cli

Primeros pasos

  • Inicio rápido
  • Configuración

Referencia

  • lingo push
  • lingo pull
  • Otros comandos
  • lingo purge

Configuración

  • Controles de claves
  • Formatos
  • Idiomas

Guías

  • Agregar un idioma
  • Traducciones existentes
  • Retraducción
  • Notas del traductor
  • Ejecuciones, estado y recuperación
  • CI/CD
  • Monorepos
  • Proyectos grandes

¿Buscas el CLI anterior (v0)? Consulta la documentación del CLI anterior

CI/CD

lingo ci ejecuta el pipeline de localización dentro de un job de CI y devuelve los resultados a tu repositorio, ya sea haciendo commit en la rama o abriendo una pull request. Detecta automáticamente la plataforma (GitHub Actions, GitLab CI, Bitbucket Pipelines) y configura por ti la identidad de git, el remoto y la rama.

Uso básico#

bash
lingo ci

De forma predeterminada, ejecuta el paso de traducción y luego hace commit de cualquier traducción nueva directamente en la rama actual.

Elegir el paso#

--step elige qué comando se ejecuta como paso de traducción (de forma predeterminada, localize). Para el flujo de trabajo de archivos push/pull, usa push:

bash
lingo ci --step push

Pasos permitidos: localize, ship, push, extract.

Commit vs. pull request#

Haz commit en la rama (opción predeterminada) o abre/actualiza un PR desde una rama lingo.dev/* dedicada:

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

Flags útiles:

FlagEfecto
--pull-requestAbre/actualiza un PR en lugar de hacer commit en la rama base.
--commit-message <msg>Mensaje de commit. Valor predeterminado: feat: update translations via @lingodotdev.
--pull-request-title <title>Título del PR.
--commit-author-name / --commit-author-emailAutor de git. Los valores predeterminados son Lingo.dev / support@lingo.dev.
--working-directory <dir>Haz cd primero en un subdirectorio; útil para monorepos.
--gpg-signFirma el commit con la clave GPG configurada.
--process-own-commitsNo omitas la ejecución cuando el último commit ya haya sido creado por Lingo.dev.

Ejemplo con GitHub Actions#

Autentícate con una API key (lingo login --api-key o configúrala como secret) y ejecútalo en cada merge a la rama predeterminada:

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

Esto traduce el contenido fuente nuevo y modificado en cada push a main y abre un PR con los resultados para revisión.

¿Te resultó útil esta página?

Max PrilutskiyMax Prilutskiy·Actualizado hace 4 días·1 min de lectura