lingo ci exécute le pipeline de localisation dans un job CI et réintègre les résultats dans votre dépôt — soit en les commitant sur la branche, soit en ouvrant une pull request. Il détecte automatiquement la plateforme (GitHub Actions, GitLab CI, Bitbucket Pipelines) et configure pour vous l'identité git, le remote et la branche.
Utilisation de base#
lingo ciPar défaut, il exécute l'étape de traduction, puis committe directement les nouvelles traductions sur la branche en cours.
Choisir l'étape#
--step détermine quelle commande exécuter comme étape de traduction (par défaut localize). Pour le workflow de fichiers push/pull, utilisez push :
lingo ci --step pushÉtapes autorisées : localize, ship, push, extract.
Commit ou pull request#
Commitez sur la branche (par défaut), ou ouvrez/mettez à jour une PR depuis une branche lingo.dev/* dédiée :
lingo ci --step push --pull-requestOptions utiles :
| Option | Effet |
|---|---|
--pull-request | Ouvre/met à jour une PR au lieu de committer sur la branche de base. |
--commit-message <msg> | Message de commit. Par défaut : feat: update translations via @lingodotdev. |
--pull-request-title <title> | Titre de la PR. |
--commit-author-name / --commit-author-email | Auteur Git. Par défaut : Lingo.dev / support@lingo.dev. |
--working-directory <dir> | Exécutez d'abord cd dans un sous-répertoire — pour les monorepos. |
--gpg-sign | Signe le commit avec la clé GPG configurée. |
--process-own-commits | N'ignore pas l'exécution lorsque le dernier commit a déjà été créé par Lingo.dev. |
Exemple GitHub Actions#
Authentifiez-vous avec une clé API (lingo login --api-key, ou définissez-la comme secret) et lancez l'exécution à chaque fusion vers la branche par défaut :
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 }}Traduit les sources nouvelles et modifiées à chaque push vers main, puis ouvre une PR avec les résultats pour relecture.
