GitHub (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Consiglio

Per informazioni sull'integrazione GitHub in Phrase TMS, fare riferimento a GitHub (TMS).

Prerequisiti

Il file di configurazione .phrase.yml deve essere presente nella radice del branch da monitorare. Il file definisce quali file importare (pull) o esportare (push) dall'archivio.
Accedere in lettura e scrittura è obbligatorio per l’archivio.
File di configurazione definiti in modo non corretto possono causare errori. Assicurarsi che il file contenga almeno una destinazione push e una pull, formati di file corretti e l’impostazione corretta del parametro update_translations.
Token di accesso:
- Token classici
  
  Richiede l’ambito repo (public_repo se si sincronizza con un archivio pubblico)
- Token a grana fine
  
  Richiede le seguenti autorizzazioni:
  - Contenuto: Leggi e scrivi
  - Richieste pull: Leggi e scrivi
Se SSO è abilitato in GitHub, deve essere abilitato anche per il token di accesso.
Il branch phrase_translations non può essere protetto.
Assicurati che le impostazioni archivio non richiedano commit firmati.

Nota

A causa dei continui miglioramenti, l'interfaccia utente potrebbe non essere esattamente la stessa presentata nel video.

Connetti archivi

Una volta che il file di configurazione è a posto, per connettere un archivio, segui i passaggi riportati di seguito:

Dalla pagina Integrazioni, scorrere verso il basso fino al connettore GitHub Sync e fare clic su Configura.

Si apre la pagina Repo Syncs.
Fai clic su Aggiungi sincronizzazione/GitHub.

Si apre la finestra delle impostazioni della sincronizzazione GitHub.
Seleziona un progetto dall'elenco a discesa.
Facoltativamente selezionare un'istanza self-hosted e fornire l'endpoint API self-hosted GitHub.
Fornisci un token di accesso personale con un ambito API.
Seleziona un archivio GitHub dall'elenco a discesa.
Seleziona un branch archivio dall'elenco a discesa da cui importare (push) ed esportare (pull). Di solito questo è il branch master.
Fare clic su Convalida configurazione per assicurarsi che token di accesso e file di configurazione siano corretti.
Facoltativamente selezionare Importa automaticamente per importare file ad ogni commit nel branch GitHub selezionato.
Fai clic su Salva.

Il progetto è ora connesso all’archivio GitHub selezionato e aggiunto all’elenco.

Importa file

Assicurarsi che i comandi push siano configurati correttamente all'interno del file di configurazione .phrase.yml. Le opzioni push sono le stesse dell'endpoint API uploads.

Per importare file:

Dalla pagina Repo Syncs, selezionare un progetto e fare clic su Importa .

I file di lingua (definiti come voci di origine push nel file di configurazione) vengono importati nel progetto.

È necessario definire le impostazioni locali predefinite.

Nota

In caso di problemi al momento dell'importazione, usare il cliente CLI per testare localmente il file di configurazione .phrase.yml e verificare la presenza di messaggi di errore.

Se richiesto, contattare l'assistenza tecnica phrase e allegare il file di configurazione .phrase.yml alla richiesta di assistenza.

Esporta file

Assicurarsi che i comandi pull siano configurati correttamente all'interno del file di configurazione .phrase.yml. Le opzioni pull (ad esempio il parametro include_empty_translations) sono le stesse dell'endpoint API locales download.

Per esportare file:

Dalla pagina Repo Syncs, selezionare un progetto e fare clic su Esporta .

I file di lingua più recenti nell’archivio vengono esportati come nuova richiesta pull.
Una volta esportati i file, la richiesta pull può essere unita o chiusa nell’archivio e il branch può essere eliminato.

Nota

In caso di problemi durante l'esportazione, usare il cliente CLI per testare localmente il file di configurazione .phrase.yml e verificare la presenza di messaggi di errore.

Se richiesto, contattare l'assistenza tecnica phrase e allegare il file di configurazione .phrase.yml alla richiesta di assistenza.

Cronologia

Le sincronizzazioni repository mantengono una cronologia delle ultime importazioni ed esportazioni per ogni progetto Phrase Strings.

Per visualizzare la cronologia:

Dalla pagina Repo Syncs, selezionare un progetto e fare clic su History .

Viene presentata la cronologia per importare ed esportare il progetto. Le voci di esportare nella cronologia includono un link alla corrispondente richiesta di unire.