lingo ci führt die Lokalisierungs-Pipeline in einem CI-Job aus und bringt die Ergebnisse zurück in dein Repo — entweder per Commit in den Branch oder als Pull Request. Die Plattform (GitHub Actions, GitLab CI, Bitbucket Pipelines) wird automatisch erkannt, und Git-Identität, Remote und Branch werden für dich eingerichtet.
Grundlegende Verwendung#
lingo ciStandardmäßig wird der Übersetzungsschritt ausgeführt und anschließend werden alle neuen Übersetzungen direkt in den aktuellen Branch committet.
Den Schritt auswählen#
--step legt fest, welcher Befehl als Übersetzungsschritt ausgeführt wird (standardmäßig localize). Für den Push/Pull-Datei-Workflow verwende push:
lingo ci --step pushZulässige Schritte: localize, ship, push, extract.
Commit oder Pull Request#
Committe in den Branch (Standard) oder öffne bzw. aktualisiere einen PR aus einem dedizierten lingo.dev/*-Branch:
lingo ci --step push --pull-requestNützliche Flags:
| Flag | Wirkung |
|---|---|
--pull-request | Öffnet bzw. aktualisiert einen PR, statt in den Basis-Branch zu committen. |
--commit-message <msg> | Commit-Nachricht. Standard: feat: update translations via @lingodotdev. |
--pull-request-title <title> | PR-Titel. |
--commit-author-name / --commit-author-email | Git-Autor. Standardmäßig Lingo.dev / support@lingo.dev. |
--working-directory <dir> | Führe cd zuerst in einem Unterverzeichnis aus — für Monorepos. |
--gpg-sign | Signiert den Commit mit dem konfigurierten GPG-Schlüssel. |
--process-own-commits | Überspringt den Lauf nicht, wenn der letzte Commit bereits von Lingo.dev erstellt wurde. |
GitHub Actions Beispiel#
Authentifiziere dich mit einem API-Schlüssel (lingo login --api-key oder als Secret gesetzt) und führe den Vorgang bei jedem Merge in den Standard-Branch aus:
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 }}Das übersetzt bei jedem Push auf main neue und geänderte Quelltexte und öffnet einen PR mit den Ergebnissen zur Prüfung.
