GitHub Actions

La GitHub Action officielle de Lingo.dev exécute le pipeline de localisation à chaque push, en validant directement les traductions ou en ouvrant une pull request selon votre workflow.

Vous préférez une solution gérée ?

L’application GitHub est le moyen le plus simple de mettre en place une localisation continue sur GitHub : installez-la une seule fois, et elle réagit aux pushs et aux pull requests sans runner, sans secret de clé API et sans lockfile. Utilisez la GitHub Action (ci-dessous) si vous souhaitez exécuter la traduction dans votre propre pipeline, aux côtés des autres étapes CI.

Prérequis

Commencez par terminer la configuration CI/CD. Vous avez besoin d’un i18n.json fonctionnel et d’un LINGODOTDEV_API_KEY enregistré comme secret du dépôt.

Configuration minimale#

Créez .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 }}

Les traductions sont alors validées directement sur main à chaque push.

Exemples de workflow#

Commit vers 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 depuis 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 }}

Activez Settings > Actions > General > Allow GitHub Actions to create and approve pull requests pour les workflows basés sur des PR.

Commit vers une branche de fonctionnalité#

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 depuis une branche de fonctionnalité#

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

Entrées disponibles#

Entrée	Par défaut	Description
`api-key`	Obligatoire	Clé API Lingo.dev
`pull-request`	`false`	Créer une pull request au lieu de valider directement
`commit-message`	`feat: update translations via @LingoDotDev`	Message de commit personnalisé
`pull-request-title`	`feat: update translations via @LingoDotDev`	Titre de PR personnalisé
`commit-author-name`	`Lingo.dev`	Nom de l’auteur du commit Git
`commit-author-email`	`support@lingo.dev`	E-mail de l’auteur du commit Git
`working-directory`	`.`	Répertoire de travail pour les monorepos
`process-own-commits`	`false`	Traiter les commits effectués par cette action
`parallel`	`false`	Exécuter en parallèle
`version`	`latest`	Version de la CLI Lingo.dev

Étapes suivantes#

Application GitHub

Alternative gérée : sans runner, secret ni lockfile

Modèles avancés

Vérifications des traductions, conflits de fusion, sélection du workflow

GitLab CI/CD

Configurez l’intégration GitLab CI/CD

Bitbucket Pipelines

Configurez l’intégration Bitbucket Pipelines

La GitHub Action officielle de Lingo.dev exécute le pipeline de localisation à chaque push, en validant directement les traductions ou en ouvrant une pull request selon votre workflow.

Vous préférez une solution gérée ?

Prérequis

Commencez par terminer la configuration CI/CD. Vous avez besoin d’un i18n.json fonctionnel et d’un LINGODOTDEV_API_KEY enregistré comme secret du dépôt.

Configuration minimale#

Créez .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 }}

Les traductions sont alors validées directement sur main à chaque push.

Exemples de workflow#

Commit vers 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 depuis 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 }}

Activez Settings > Actions > General > Allow GitHub Actions to create and approve pull requests pour les workflows basés sur des PR.

Commit vers une branche de fonctionnalité#

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 depuis une branche de fonctionnalité#

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

Entrées disponibles#

Entrée	Par défaut	Description
`api-key`	Obligatoire	Clé API Lingo.dev
`pull-request`	`false`	Créer une pull request au lieu de valider directement
`commit-message`	`feat: update translations via @LingoDotDev`	Message de commit personnalisé
`pull-request-title`	`feat: update translations via @LingoDotDev`	Titre de PR personnalisé
`commit-author-name`	`Lingo.dev`	Nom de l’auteur du commit Git
`commit-author-email`	`support@lingo.dev`	E-mail de l’auteur du commit Git
`working-directory`	`.`	Répertoire de travail pour les monorepos
`process-own-commits`	`false`	Traiter les commits effectués par cette action
`parallel`	`false`	Exécuter en parallèle
`version`	`latest`	Version de la CLI Lingo.dev

Étapes suivantes#

Application GitHub

Alternative gérée : sans runner, secret ni lockfile

Modèles avancés

Vérifications des traductions, conflits de fusion, sélection du workflow

GitLab CI/CD

Configurez l’intégration GitLab CI/CD

Bitbucket Pipelines

Configurez l’intégration Bitbucket Pipelines