Consiglio
Per informazioni sull'integrazione di GitHub in Phrase TMS, fare riferimento a GitHub (TMS).
Phrase Strings si integra con i repository GitHub per sincronizzare i file di localizzazione tra Phrase e GitHub.
Per impostazione predefinita, i repository sono collegati utilizzando una GitHub OAuth App. Sono supportati anche i token di accesso personale, destinati principalmente a istanze self-hosted o ambienti in cui l'installazione di un'OAuth App non è possibile.
Prerequisiti
-
Il file
.phrase.ymlconfigurazione deve essere presente nella root del branch da monitorare. Il file definisce quali file importare (pull) o esportare (push) dall'archivio. -
Per l’archivio è necessaria l’autorizzazione alla lettura e alla scrittura.
-
I file di configurazione definiti in maniera errata potrebbero provocare degli errori. Assicurati che il file contenga almeno una destinazione push e una pull, formati di file corretti e l’impostazione corretta del parametro
update_translations. -
-
La GitHub OAuth App deve essere installata nell'organizzazione o nell'account GitHub che possiede il repository.
-
Il repository deve essere incluso nell'installazione dell'OAuth App.
-
Sono necessarie le autorizzazioni per installare o autorizzare le GitHub App nell'organizzazione o nell'account di destinazione.
-
Supporta la connessione di un account Strings a più organizzazioni GitHub. Seleziona quale organizzazione GitHub sincronizzare nella configurazione dell'integrazione. Non esiste un limite rigido al numero di organizzazioni che possono essere collegate.
-
-
-
Token classici
Richiede l'ambito repo (
public_repose si esegue la sincronizzazione con un repository pubblico) -
Token granulari
Richiede le seguenti autorizzazioni:
-
Contenuti: Leggi e scrivi
-
Pull request: Leggi e scrivi
-
-
Assicurati che le impostazioni dell’archivio non richiedano commit firmati.
-
-
Se SSO è abilitato in GitHub, deve essere abilitato anche per il token di accesso.
-
Il branch phrase_translations non può essere protetto.
Nota
A causa dei miglioramenti che vengono apportati regolarmente, l'interfaccia utente potrebbe apparire leggermente diversa da quella mostrata nel video.
Una volta inserito il file di configurazione, per connettere un repository, segui questi passaggi:
-
Nella navigazione principale, fai clic su Automazioni, quindi su Sincronizzazioni repository.
In alternativa, dalla pagina , scorri verso il basso fino a e fai clic su Configura.
Si apre la pagina . L'elenco visualizza solo i progetti a cui l'utente ha accesso.
-
Fai clic su Aggiungi sincronizzazione/GitHub.
Si apre la finestra delle impostazioni .
-
Seleziona un progetto dall'elenco a discesa.
-
Seleziona il metodo di autenticazione:
-
Se la GitHub App non è ancora installata, fai clic su Autentica. L'autenticazione viene eseguita una volta e può essere riutilizzata per più sincronizzazioni di repository.
Se la GitHub App è già installata, fai clic su Gestisci installazione per completare l'installazione dell'app per l'organizzazione o l'account di destinazione. L'accesso al repository viene gestito a livello di organizzazione o account e non è legato a un singolo utente GitHub.
-
Fornisci un personale con un ambito API.
Quando si utilizza un token di accesso personale, l'accesso al repository dipende dall'utente GitHub che ha creato il token.
-
Fornisci l' self-hosted di GitHub e un personale con un ambito API.
Se il repository di destinazione richiede commit verificati (firmati), è necessario utilizzare il metodo di autenticazione GitHub App. I commit inviati utilizzando un token di accesso personale non sono firmati, pertanto la sincronizzazione non riesce con il seguente errore: "Il repository richiede commit verificati (firmati)."
-
-
Se viene utilizzata l'app GitHub, seleziona dall'elenco a discesa. L'elenco dei repository viene caricato in base a tale selezione.
-
Seleziona un dall'elenco a discesa.
-
Seleziona un dall'elenco a discesa da cui importare (push) ed esportare (pull). Di solito si tratta del ramo master.
-
Facoltativamente, fornisci un nome di branch per la pull request. Se lasciato vuoto, verrà creato un branch con il valore predefinito .
-
Facoltativamente, fornisci un personalizzato per la pull request, fino a 72 caratteri.
Lasciando il campo vuoto si mantiene il messaggio predefinito, Updated translations from Phrase. Una volta impostato, il titolo personalizzato sostituisce il messaggio di commit e il titolo della pull request predefiniti ad ogni esportazione.
-
Fai clic su Convalida configurazione per verificare che le impostazioni di autenticazione e il file di configurazione siano corretti.
-
Facoltativamente, seleziona un'opzione per determinare quando i file nuovi o aggiornati vengono importati automaticamente nel progetto.
-
Fai clic su Salva.
Il progetto è ora connesso al repository GitHub selezionato e aggiunto all'elenco.
-
(Facoltativo) Fai clic sull'icona matita per rinominare l'integrazione.
L'app GitHub di Phrase attualmente non supporta la lista di IP consentiti. Se un'organizzazione GitHub ha una lista di IP consentiti abilitata con l'impostazione "Abilita configurazione lista IP consentiti per le app GitHub installate" attivata, GitHub blocca l'app GitHub di Phrase, il che comporta un menu a discesa dei repository vuoto e esportazioni non riuscite. Come soluzione alternativa, aggiungi gli indirizzi IP in uscita di Phrase alla lista di IP consentiti dell'organizzazione. Consulta l'articolo Indirizzi IP dei server Phrase per l'elenco corrente degli indirizzi da inserire nella lista di IP consentiti.
Assicurati che i comandi push siano configurati correttamente all'interno del file .phrase.yml configurazione. Le opzioni di push sono le stesse dell'endpoint dell'API uploads.
Per importare file:
-
Dalla pagina , seleziona un progetto e fai clic su Importa
.
I file di lingua (definiti come voci di origine push nel file di configurazione) vengono importati nel progetto.
Deve essere presente un'impostazione locale predefinita.
Nota
In caso di problemi durante l'importazione, utilizza il client CLI per testare localmente il file di configurazione
.phrase.ymle verificare la presenza di eventuali messaggi di errore.Se necessario, contatta il supporto tecnico di Phrase e allega il file di configurazione
.phrase.ymlalla richiesta di supporto.
Assicurati che i comandi di pull siano configurati correttamente all'interno del file .phrase.yml configurazione. Le opzioni di pull (ad es. il parametro include_empty_translations) sono le stesse dell'endpoint API locales download.
Per esportare i file:
-
Dalla pagina , seleziona un progetto e fai clic su Export
.
Viene visualizzata la finestra .
-
Fornisci il branch di destinazione nel campo .
I file più recenti nell'archivio verranno esportati come nuova pull request nel branch desiderato.
-
Una volta esportati i file, la pull request può essere unita o chiusa nell'archivio e il branch può essere eliminato.
Nota
In caso di problemi durante l'esportazione, utilizza il cliente CLI per testare localmente il file di configurazione .phrase.yml e verificare la presenza di eventuali messaggi di errore.
Se necessario, contatta il supporto tecnico di Phrase e allega il file di configurazione .phrase.yml alla richiesta di supporto.
Le Repo Syncs mantengono una cronologia delle ultime importazioni ed esportazioni per ogni progetto Phrase Strings.
Per visualizzare la cronologia: