GitHub (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Consiglio

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

Le stringhe di Phrase si integrano con i repository di GitHub per sincronizzare i file di localizzazione tra Phrase e GitHub.

Per impostazione predefinita, i repository sono connessi utilizzando un'app OAuth di GitHub. I token di accesso personale sono supportati e sono principalmente destinati a istanze auto-ospitate o ambienti in cui l'installazione dell'app OAuth non è possibile.

Requisiti preliminari

Il file .phrase.yml configurazione deve essere presente nella radice 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.
App OAuth di GitHub:
- L'app OAuth di GitHub deve essere installata nell'organizzazione o nell'account GitHub che possiede il repository.
- Il repository deve essere incluso nell'installazione dell'app OAuth.
- Sono necessarie autorizzazioni per installare o autorizzare le app di GitHub nell'organizzazione o nell'account di destinazione.
token di accesso GitHub:
- Token classici
  
  Richiede l'ambito repo (public_repo se si sincronizza con un repository pubblico)
- Token a granularità fine
  
  Richiede le seguenti autorizzazioni:
  - Contenuti: Lettura e scrittura
  - Richieste di pull: Lettura e scrittura
- 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.

Collegare i repository

Una volta che il file di configurazione è in posizione, per collegare un repository, seguire questi passaggi:

Dalla pagina Integrazioni, scorri verso il basso fino a Repo Sync e fai clic su Configura.

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

Si apre la finestra delle impostazioni sync di GitHub.
Seleziona un progetto dall'elenco a discesa.
Seleziona il metodo di autenticazione:
- App GitHub (consigliata)
  
  Se l'App GitHub non è ancora installata, fai clic su Autenticati. L'autenticazione viene eseguita una sola volta e può essere riutilizzata per più sincronizzazioni di repository.
  
  Se l'App GitHub è 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 è gestito a livello di organizzazione o account e non è legato a un singolo utente GitHub.
- Token di accesso personale
  
  Fornisci un token di accesso al repo personale con uno scope API.
  
  Quando si utilizza un token di accesso personale, l'accesso al repository dipende dall'utente GitHub che ha creato il token.
- Istanza self-hosted
  
  Fornisci l'endpoint API auto-ospitato di GitHub e un token di accesso al repo personale con uno scope API.
Seleziona un repository GitHub dall'elenco a discesa.
Seleziona un branch del repository dall'elenco a discesa da importare (push) ed esportare (pull). Di solito, questo è il branch master.
Facoltativamente, fornisci un nome di branch per la richiesta di pull. Se lasciato vuoto, verrà creato un branch con il valore predefinito phrase-translations.
Fai clic su Valida Configurazione per assicurarti che le impostazioni di autenticazione e il file di configurazione siano corretti.
Facoltativamente seleziona un'opzione di comportamento di importazione per determinare quando i file nuovi o aggiornati vengono importati automaticamente nel progetto.
Fai clic su Salva.

Il progetto è ora connesso all'archivio GitHub selezionato ed è stato aggiunto all'elenco.

Importa file

Assicurati che i comandi di push siano configurati correttamente all'interno del file .phrase.yml configurazione. Le opzioni di push sono le stesse per l'endpoint API upload.

Per importare file:

Dalla pagina Repo Syncs, seleziona un progetto e fai clic su Importa .

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

Deve essere presente una locale predefinita.

Nota

In caso di problemi durante l'importazione, utilizza il client CLI per testare il file di configurazione .phrase.yml localmente e controlla eventuali messaggi di errore.

Se necessario, contatta il supporto tecnico di Phrase e allega il file di configurazione .phrase.yml alla richiesta di supporto.

Esporta file

Assicurati che i comandi di pull siano configurati correttamente all'interno del file .phrase.yml configurazione. Le opzioni di pull (ad es. parametro include_empty_translations) sono le stesse per l'endpoint API download delle locale.

Per esportare file:

Dalla pagina Repo Syncs, seleziona un progetto e fai clic su Esporta .

La finestra Esporta viene visualizzata.
Fornisci il ramo di destinazione nel campo ramo PR.

I file più recenti nell'archivio saranno esportati come una nuova richiesta di pull nel ramo desiderato.
Una volta esportati i file, la richiesta di pull può essere unita o chiusa nell'archivio e il ramo può essere eliminato.

Nota

In caso di problemi durante l'esportazione, usa il CLI cliente per testare il file di configurazione .phrase.yml localmente e controllare eventuali messaggi di errore.

Se necessario, contatta il supporto tecnico di Phrase e allega il file di configurazione .phrase.yml alla richiesta di supporto.

Storia

Le sincronizzazioni del repository mantengono una storia degli ultimi import e export per ogni progetto di Strings Phrase.

Per visualizzare la storia:

Dalla pagina Repo Syncs, seleziona un progetto e fai clic su Storia .

La storia degli import e export per il progetto è presentata. Le voci di esportazione nella storia includono un link alla corrispondente richiesta di unione.