Azione di Crowdin di GitHub

L’Azione di Crowdin di GitHub ti consente di integrare facilmente la localizzazione del tuo progetto di Crowdin Impresa nel flusso di lavoro che hai configurato sulla tua repository con l’aiuto delle Azioni di GitHub. Usando l’Azione di Crowdin di GitHub, puoi automatizzare la sincronizzazione delle risorse di localizzazione con il tuo progetto di Crowdin Impresa.

Con quest’azione puoi fare le seguenti cose:

  • Caricare le risorse su Crowdin Impresa.
  • Caricare le traduzioni su Crowdin Impresa.
  • Scaricare le traduzioni da Crowdin Impresa.

Uso

Configura un flusso di lavoro in .github/workflows/crowdin.yml (o aggiungi un lavoro ai tuoi flussi di lavoro esistenti).

Leggi l’articolo di Configurazione di un flusso di lavoro per ulteriori dettagli su come creare e configurare i flussi di lavoro personalizzati.

nome: Azione di Crowdin

il:
  push:
    rami: [ principale ]

lavori:
  synchronize-with-crowdin:
    runs-on: ubuntu-latest

    passaggi:

    - nome: Checkout
      usi: actions/checkout@v2

    - nome: azione di crowdin
      usi: crowdin/github-action@1.0.4
      con:
        upload_translations: true
        download_translations: true
      env:
        GITHUB_TOKEN: $
        CROWDIN_PROJECT_ID: $
        CROWDIN_PERSONAL_TOKEN: $

Opzioni Supportate

L’azione predefinita è caricare le sorgenti. Tuttavia, puoi impostare diverse azioni tramite le opzioni con. Se non vuoi caricare le tue risorse su Crowdin Impresa, basta impostare l’opzione upload_sources a false.

Di default le sorgenti e le traduzioni sono caricate al root del tuo progetto di Crowdin Impresa. Tuttavia, se usi dei rami, puoi impostare il ramo sorgente preferito.

Puoi anche specificare in quale ramo di GitHub vorresti scaricare le tue traduzioni (il ramo di traduzione predefinito è l10n_crowdin_action).

Nel caso in cui tu non voglia scaricare le traduzioni da Crowdin Impresa (download_translations: false), le opzioni localization_branch_name e create_pull_request non sono necessarie.

- nome: azione di Crowdin
  con:
    # opzioni di caricamento
    upload_sources: true
    upload_translations: true

    # opzioni di download
    download_translations: true
    lingua: 'uk'
    push_translations: true

    # Questo è il nome del ramo di git che Crowdin Impresa creerà aprendo una richiesta di prelievo. 
    # Questo ramo NON necessita di esser creato manualmente. Sarà creato automaticamente dall'azione.
    localization_branch_name: l10n_crowdin_action
    create_pull_request: true

    # opzioni globali

    # Questo è il nome della cartella di livello superiore che Crowdin Impresa userà per i file.
    # Nota che questo non è un "ramo" nel senso di git, ma più una cartella di livello superiore nel tuo progetto di Crowdin Impresa.
    # Questo ramo NON necessita di esser creato manualmente. Sarà creato automaticamente dall'azione.
    crowdin_branch_name: l10n_branch
    identità: '/path/to/your/credentials/file'
    configurazione: '/path/to/your/crowdin.yml'
    dryrun_action: true

    # opzioni di configurazione

    # Questo è un id numerico del progetto
    # Apri un progetto e vedi "API di Crowdin" in Risorse > Integrazioni e API
    project_id: $ 

    # Questo è un token d'accesso personale
    # Apri un progetto e vedi "API di Crowdin" in Risorse > Integrazioni e API > Crea Token
    token: $
    sorgente: '/path/to/your/file'
    traduzione: 'file/export/pattern'
    base_url: 'https://crowdin.com'
    base_path: '/project-base-path'

Per descrizioni più dettagliate di queste opzioni, vedi action.yml.

File di Configurazione di Crowdin Impresa

Se il file del tuo flusso di lavoro contiene la proprietà config, dovrai aggiungere quanto segue al tuo file di configurazione di Crowdin Impresa (es. crowdin.yml):

project_id_env: CROWDIN_PROJECT_ID
api_token_env: CROWDIN_PERSONAL_TOKEN

Quando il flusso di lavoro viene eseguito, i valori reali del tuo token e l’ID del progetto sarà iniettato nella configurazione usando i segreti nell’ambiente.

Questo articolo è stato utile?