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

Descripción general

  • @lingo.dev/cli

Primeros pasos

  • Guía rápida
  • Configuración

Referencia

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

Configuración

  • Controles de claves
  • Formatos
  • Idiomas

Guías

  • Añadir un idioma
  • Traducciones existentes
  • Retraducción
  • Notas de traducción
  • Ejecuciones, estado y recuperación
  • CI/CD
  • Monorepos
  • Proyectos grandes

¿Buscas la versión anterior de la CLI (v0)? Consulta la documentación de la CLI antigua

CI/CD

lingo ci ejecuta el pipeline de localización dentro de un trabajo 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

Por defecto, ejecuta el paso de traducción y después 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 (por defecto, 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 por defecto) o abre/actualiza una PR desde una rama lingo.dev/* específica:

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

Flags útiles:

FlagEfecto
--pull-requestAbre/actualiza una PR en lugar de hacer commit en la rama base.
--commit-message <msg>Mensaje de commit. Por defecto: feat: update translations via @lingodotdev.
--pull-request-title <title>Título de la PR.
--commit-author-name / --commit-author-emailAutor de Git. Por defecto: Lingo.dev / support@lingo.dev.
--working-directory <dir>Ejecuta cd primero en un subdirectorio; pensado para monorepos.
--gpg-signFirma el commit con la clave GPG configurada.
--process-own-commitsNo omitas la ejecución cuando el último commit ya lo haya hecho Lingo.dev.

Ejemplo de GitHub Actions#

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

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 una PR con los resultados para revisión.

¿Te ha resultado útil esta página?

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