GitHub Actions

Oficiální GitHub Action od Lingo.dev spouští lokalizační pipeline při každém pushi a podle vašeho workflow překlady buď rovnou commitne, nebo otevře pull request.

Dáváte přednost spravovanému řešení?

GitHub App je nejjednodušší způsob, jak na GitHubu provozovat průběžnou lokalizaci – nainstalujete ji jednou a pak automaticky reaguje na pushy i pull requesty, bez runneru, bez API secretu a bez lockfilu. GitHub Action (níže) použijte ve chvíli, kdy chcete překlady spouštět ve vlastní pipeline společně s dalšími CI kroky.

Požadavky

Nejprve dokončete nastavení CI/CD. Potřebujete funkční i18n.json a LINGODOTDEV_API_KEY uložené jako repository secret.

Minimální nastavení#

Vytvořte .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 }}

Při každém pushi se překlady commitnou přímo do main.

Příklady workflow#

Commit do mainu#

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 z mainu#

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

Pro workflow založené na PR povolte Settings > Actions > General > Allow GitHub Actions to create and approve pull requests.

Commit do feature branche#

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 z feature branche#

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

Dostupné vstupy#

Vstup	Výchozí	Popis
`api-key`	povinné	API klíč Lingo.dev
`pull-request`	`false`	Vytvořit pull request místo přímého commitu
`commit-message`	`feat: update translations via @LingoDotDev`	Vlastní commit message
`pull-request-title`	`feat: update translations via @LingoDotDev`	Vlastní název PR
`commit-author-name`	`Lingo.dev`	Jméno autora Git commitu
`commit-author-email`	`support@lingo.dev`	E-mail autora Git commitu
`working-directory`	`.`	Pracovní adresář pro monorepo
`process-own-commits`	`false`	Zpracovávat commity vytvořené touto action
`parallel`	`false`	Spustit v paralelním režimu
`version`	`latest`	Verze Lingo.dev CLI

Další kroky#

GitHub App

Spravovaná alternativa – bez runneru, secretu i lockfilu

Pokročilé scénáře

Kontroly překladů, konflikty při mergi, výběr workflow

GitLab CI/CD

Nastavte integraci s GitLab CI/CD

Bitbucket Pipelines

Nastavte integraci s Bitbucket Pipelines

Oficiální GitHub Action od Lingo.dev spouští lokalizační pipeline při každém pushi a podle vašeho workflow překlady buď rovnou commitne, nebo otevře pull request.

Dáváte přednost spravovanému řešení?

Požadavky

Nejprve dokončete nastavení CI/CD. Potřebujete funkční i18n.json a LINGODOTDEV_API_KEY uložené jako repository secret.

Minimální nastavení#

Vytvořte .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 }}

Při každém pushi se překlady commitnou přímo do main.

Příklady workflow#

Commit do mainu#

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 z mainu#

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

Pro workflow založené na PR povolte Settings > Actions > General > Allow GitHub Actions to create and approve pull requests.

Commit do feature branche#

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 z feature branche#

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

Dostupné vstupy#

Vstup	Výchozí	Popis
`api-key`	povinné	API klíč Lingo.dev
`pull-request`	`false`	Vytvořit pull request místo přímého commitu
`commit-message`	`feat: update translations via @LingoDotDev`	Vlastní commit message
`pull-request-title`	`feat: update translations via @LingoDotDev`	Vlastní název PR
`commit-author-name`	`Lingo.dev`	Jméno autora Git commitu
`commit-author-email`	`support@lingo.dev`	E-mail autora Git commitu
`working-directory`	`.`	Pracovní adresář pro monorepo
`process-own-commits`	`false`	Zpracovávat commity vytvořené touto action
`parallel`	`false`	Spustit v paralelním režimu
`version`	`latest`	Verze Lingo.dev CLI

Další kroky#

GitHub App

Spravovaná alternativa – bez runneru, secretu i lockfilu

Pokročilé scénáře

Kontroly překladů, konflikty při mergi, výběr workflow

GitLab CI/CD

Nastavte integraci s GitLab CI/CD

Bitbucket Pipelines

Nastavte integraci s Bitbucket Pipelines