GitHub Actions

La GitHub Action oficial de Lingo.dev ejecuta el proceso de localización en cada push, haciendo commit directamente con las traducciones o abriendo una pull request según tu flujo de trabajo.

¿Prefieres una configuración gestionada?

La GitHub App es la forma más fácil de poner en marcha la localización continua en GitHub: la instalas una vez y responde a los pushes y las pull requests sin runner, sin secreto de clave API y sin lockfile. Usa la GitHub Action (abajo) cuando quieras que la traducción se ejecute dentro de tu propio proceso, junto con otros pasos de CI.

Requisitos previos

Completa primero la configuración de CI/CD. Necesitas un i18n.json y un LINGODOTDEV_API_KEY operativos guardados como secreto del repositorio.

Configuración mínima#

Crea .github/workflows/translate.yml:

yaml

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

Esto hace commit directamente de las traducciones en main con cada push.

Ejemplos de flujo de trabajo#

Commit en main#

yaml

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

Pull request desde main#

yaml

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
  pull-requests: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
          pull-request: true
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Activa Settings > Actions > General > Allow GitHub Actions to create and approve pull requests para los flujos de trabajo basados en PR.

Commit en una rama de funcionalidad#

yaml

name: Translate
on:
  push:
    branches-ignore: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

Pull request desde una rama de funcionalidad#

yaml

name: Translate
on:
  push:
    branches-ignore: [main]
permissions:
  contents: write
  pull-requests: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
          pull-request: true
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Entradas disponibles#

Entrada	Por defecto	Descripción
`api-key`	Obligatorio	Clave API de Lingo.dev
`pull-request`	`false`	Crear una pull request en lugar de hacer commit directamente
`commit-message`	`feat: update translations via @LingoDotDev`	Mensaje de commit personalizado
`pull-request-title`	`feat: update translations via @LingoDotDev`	Título de PR personalizado
`commit-author-name`	`Lingo.dev`	Nombre del autor del commit en Git
`commit-author-email`	`support@lingo.dev`	Correo electrónico del autor del commit en Git
`working-directory`	`.`	Directorio de trabajo para monorepos
`process-own-commits`	`false`	Procesar los commits realizados por esta acción
`parallel`	`false`	Ejecutar en modo paralelo
`version`	`latest`	Versión de la CLI de Lingo.dev

Siguientes pasos#

GitHub App

Alternativa gestionada: sin runner, secretos ni lockfile

Patrones avanzados

Comprobaciones de traducción, conflictos de merge y selección de flujo de trabajo

GitLab CI/CD

Configura la integración con GitLab CI/CD

Bitbucket Pipelines

Configura la integración con Bitbucket Pipelines

La GitHub Action oficial de Lingo.dev ejecuta el proceso de localización en cada push, haciendo commit directamente con las traducciones o abriendo una pull request según tu flujo de trabajo.

¿Prefieres una configuración gestionada?

Requisitos previos

Completa primero la configuración de CI/CD. Necesitas un i18n.json y un LINGODOTDEV_API_KEY operativos guardados como secreto del repositorio.

Configuración mínima#

Crea .github/workflows/translate.yml:

yaml

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

Esto hace commit directamente de las traducciones en main con cada push.

Ejemplos de flujo de trabajo#

Commit en main#

yaml

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

Pull request desde main#

yaml

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
  pull-requests: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
          pull-request: true
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Activa Settings > Actions > General > Allow GitHub Actions to create and approve pull requests para los flujos de trabajo basados en PR.

Commit en una rama de funcionalidad#

yaml

name: Translate
on:
  push:
    branches-ignore: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

Pull request desde una rama de funcionalidad#

yaml

name: Translate
on:
  push:
    branches-ignore: [main]
permissions:
  contents: write
  pull-requests: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
          pull-request: true
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Entradas disponibles#

Entrada	Por defecto	Descripción
`api-key`	Obligatorio	Clave API de Lingo.dev
`pull-request`	`false`	Crear una pull request en lugar de hacer commit directamente
`commit-message`	`feat: update translations via @LingoDotDev`	Mensaje de commit personalizado
`pull-request-title`	`feat: update translations via @LingoDotDev`	Título de PR personalizado
`commit-author-name`	`Lingo.dev`	Nombre del autor del commit en Git
`commit-author-email`	`support@lingo.dev`	Correo electrónico del autor del commit en Git
`working-directory`	`.`	Directorio de trabajo para monorepos
`process-own-commits`	`false`	Procesar los commits realizados por esta acción
`parallel`	`false`	Ejecutar en modo paralelo
`version`	`latest`	Versión de la CLI de Lingo.dev

Siguientes pasos#

GitHub App

Alternativa gestionada: sin runner, secretos ni lockfile

Patrones avanzados

Comprobaciones de traducción, conflictos de merge y selección de flujo de trabajo

GitLab CI/CD

Configura la integración con GitLab CI/CD

Bitbucket Pipelines

Configura la integración con Bitbucket Pipelines