Integrazione GitHub

Integration with GitHub makes source and translation files synchronized with GitHub repository and Crowdin translation project. Tutti i file approvati e tradotti saranno prelevati automaticamente come richiesta di prelievo al ramo l10n nella repository di GitHub.

Connettendo GitHub con Crowdin

Prima, apri Impostazioni del Progetto, scheda Integrazioni in Crowdin. Quindi hai due opzioni. You can either use your GitHub Account or GitHub Enterprise Account integration.

Per integrare tramite il tuo Profilo GitHub puoi cliccare Configura Integrazione e poi autorizzare la connessione con Crowdin dalla parte di GitHub:

Nel caso in cui la repository che ti serve sia privata, e tu abbia accesso limitato o nessun accesso ad esso, sei pregato di chiedere al proprietario della repository di fornirti il Token di Accesso. Dopodiché, inserisci il token nel campo Token e clicca Configurazione Integrazione.

Per integrare tramite Profilo Impresa di GitHub dovresti creare un token d’accesso. Make sure to select all the required scopes:

  • Access to your public repositories or full control of private repositories(depending on the type of repository you wish to translate)
  • Full control of repository hooks(so you could get some new files or changes in the old ones translated as well)
  • Update all user data

Then insert your access token and Base URL into corresponding fields. Click Set Up Integration to proceed.

After successful integration, a pop-up dialogue would appear on your Project Settings, Integrations tab in Crowdin. Nel pop-up appena apparso, continua il processo di configurazione di integrazione selezionando la repository ed i rami necessari che dovrebbero essere tradotti.

Si raccomanda di passare il duplicato di manipolazione delle stringhe all’impostazione Mostra (Raccomandato per versioni), quindi le stringhe uguali saranno nascoste tra i rami.

Rami Servizio

Quando le traduzioni sono finite e le tue lingue sono pronte ad andare in live, Crowdin invia la richiesta di prelievo con le traduzioni al tuo sistema di controllo della versione. Per ogni ramo sotto la localizzazione, Crowdin crea un ramo di servizio aggiuntivo con le traduzioni. Non ci impegnamo direttamente al ramo maestro così che tu possa prima verificare le traduzioni.

By default, l10n_ is added to the created service branch name. If necessary it can be easily changed.

Rami da Sincronizzare Automaticamente

Quando configuri l’integrazione selezioni i rami di repository esistente che dovrebbero essere aggiunti al progetto Crowdin. Per aggiungere rami futuri da GitHub a Crowdin automaticamente, crea un modello per i nomi del ramo. Se un ramo nome segue un certo modello, sarà aggiunto automaticamente a Crowdin.

For example, you add a pattern *feature in the GitHub integration settings. In this case, the future branches that contain this word at the end of the title will be added to the project.

Per aggiungere un modello per il ramo nomi, segui questi passi:

  1. Clicca Modifica nella sezione di integrazione di GitHub.
  2. Nel dialogo pop-up clicca Mostra Impostazioni Avanzata nell’angolo in basso a sinistra.
  3. Nel campo Rami da Sincronizzare Automsticamente, usa i selettori wildcard come ‘*’, ‘?’, ‘[set]’, ‘' ed altri per identificare i rami necessari.
  4. Clicca Salva.

Selezionare Contenuto per la Sincronizzazione

Per fare funzionare l’integrazione, devi specificare quale file risorsa dovrebbe essere tradotto e come Crowdin dovrebbe strutturare i file tradotti nella tua repository. Nel caso che tu veda un’icona rossa con un punto esclamativo vicino al nome del ramo di servizio, questo significa che tu non hai scelto il contenuto per la sincronizzazione.

There are two ways to do that: configuring online or manually by creating a configuration file.

Configurare Online

Questa procedura è uguale per tutte le integrazioni con il sistema di controllo versione (VCS). Controlla Integrazioni VCS: Configurare Online per sapere come selezionare contenuto per la sincronizzazione online.

Creare File Configurazione

Il file di configurazione crowdin.yaml dovrebbe essere archiviata nella repository di GitHub insieme ad ogni ramo separato che vuoi tradurre, così che Crowdin sappia esattamente quali file dovrebbero essere inviati per la traduzione.

Dovrebbe avere la stessa struttura come richiesto per lo Strumento di Sincronizzazione, ma le tue credenziali del progetto non dovrebbero essere archiviate nell’intestazione del file per ragioni di sicurezza. Leggi di più su creare un file configurazione.

Programma Sincronizzazione

Per configurare il programma di sincronizzazione - clicca Modifica e scegli l’intervallo di aggiornamento.

tempo sincronizzazione github

Controllare lo Stato di Sincronizzazione

Once the integration is set up, all the related information is stored in the same place – Project Settings, Integrations tab, GitHub section. Per impostazione predefinita, la sincronizzazione è elaborata ogni 10 minuti automaticamente. Se c’è bisogno di lanciarlo istantaneamente - clicca Sincronizza Ora.

sincronizza ora github

Vedi Anche

Questo articolo è stato utile?