Azione di Crowdin di GitHub

L’Azione di Crowdin di GitHub ti consente di integrare facilmente la localizzazione del tuo progetto di Crowdin 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.

Cosa fa quest’azione?

  • Caricare risorse in Crowdin.
  • Caricare traduzioni in Crowdin.
  • Scaricare traduzioni da Crowdin.

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 sorgenti su Crowdin, basta impostare l’opzione upload_sources a false.

Di default le sorgenti e le traduzioni sono caricate al root del tuo progetto di Crowdin. 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 tu non voglia scaricare le traduzioni da Crowdin (download_translations: false), non sono richieste nemmeno le opzionilocalization_branch_name e create_pull_request.

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

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

    # Questo è il nome del ramo git che Crowdin creerà aprendo una richiesta di pull. 
    # 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 massimo che Crowdin userà per i file.
    #Nota che questo non è un "ramo" nel senso di git, ma più come una cartella di massimo livello nel tuo progetto di Crowdin.
    # Questo ramo NON necessita di esser creato manualmente. Sarà creato automaticamente dall'azione.
    crowdin_branch_name: l10n_branch
    identità: '/path/to/your/credentials/file'
    config: '/path/to/your/crowdin.yml'
    dryrun_action: true

    # opzioni di configurazione

    # Questo è un id numerico, da non confondere con l'"identificativo del progetto" dell'API v1 di Crowdin.
    # Vedi "API v2" su https://crowdin.com/project/<your-project>/settings#api
    project_id: $ 

    # Un token d'accesso personale, da non confondere con la "chiave API" dell'API v1 di Crowdin
    # Vedi https://crowdin.com/settings#api-key per generare un 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

Se il file del tuo flusso di lavoro contiene la proprietà config, dovrai aggiungere quanto segue al tuo file di configurazione di Crowdin (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?