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:
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: $
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.
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.