Repo: Crowdin translations support

[marcuspollio]

Add support for translating via Crowding service

• https://support.crowdin.com/github-integration/
• https://crowdin.github.io/crowdin-cli/configuration
• https://github.com/crowdin/github-action

crowdin.yml (example):

project_id_env: CROWDIN_PROJECT_ID
api_token_env: CROWDIN_PERSONAL_TOKEN
base_path_env: CROWDIN_BASE_PATH
base_url_env: CROWDIN_BASE_URL

preserve_hierarchy: true

files:
  - source: /content/en/**/*.md
    translation: /content/%two_letters_code%/%original_path%

  - source: /themes/trigo/i18n/en.yaml
    translation: /themes/trigo/i18n/%two_letters_code%.yaml

.github/workflows/crowdin.yaml (example):

name: Crowdin

on:
  push:
    branches:
      - main

  workflow_dispatch:

permissions:
  contents: write
  pull-requests: write

jobs:
  crowdin:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v7
        with:
          fetch-depth: 0

      - name: Synchronize with Crowdin
        uses: crowdin/github-action@v2
        with:
          upload_sources: true
          upload_translations: true
          download_translations: true
          create_pull_request: true
          localization_branch_name: crowdin
          pull_request_title: "i18n: Update translations from Crowdin"
          pull_request_body: "Automated translation update by Crowdin GH Action."
          pull_request_base_branch_name: main
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          CROWDIN_PROJECT_ID: ${{ secrets.CROWDIN_PROJECT_ID }}
          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}

[marcuspollio]

FYI @chennes

I have not tested yet, but it should be doable 😃

[chennes]

Yes, this sort of integration with CrowdIn is simple, if it's something we want.

[marcuspollio]

Yeah, I guess adding support for it should not be much effort and may help for translation contributions.
I will open a post in the forum to ask for feedback from translators.

The upload_translations: true should allow for any other translation workflow to work as well without conflicts, e.g. CMS, classic git + IDE, GitHub web, etc.

FYI @kaktusus @FC-FBXL5