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).

Phrase Strings si integra con gli archivi GitHub per sincronizzare i file di localizzazione tra Phrase e GitHub.

Per impostazione predefinita, gli archivi vengono collegati utilizzando una GitHub OAuth App. Sono supportati anche i token di accedere personali, destinati principalmente a istanze self-hosted o ambienti in cui l'installazione di un'OAuth App non è possibile.

Prerequisiti

Il file di configurazione .phrase.yml 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.
GitHub OAuth App:
- La GitHub OAuth App deve essere installata nell'organizzazione o nell'account GitHub che possiede l'archivio.
- L'archivio deve essere incluso nell'installazione dell'OAuth App.
- Sono richieste 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. Selezionare quale organizzazione GitHub viene sincronizzata nella configurazione dell'integrazione. Non esiste un limite rigido al numero di organizzazioni che possono essere collegate.
Token di accedere GitHub:
- Token classici
  
  Richiede l'ambito repo (public_repo se si esegue la sincronizzazione con un archivio pubblico)
- Token granulari
  
  Richiede le seguenti autorizzazioni:
  - Contenuti: Lettura e scrittura
  - Pull request: 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.

Connetti archivi

Una volta inserito il file di configurazione, per connettere un archivio, seguire questi passaggi:

Nella navigazione principale, fare clic su Automations, quindi su Repo Syncs.

In alternativa, dalla pagina Integrations, scorrere verso il basso fino a Repo Sync e fare clic su Configure.

Si apre la pagina Repo Syncs. L'elenco Repo Syncs visualizza solo i progetti a cui l'utente che sta visualizzando ha accesso.
Fare clic su Add Sync/GitHub.

Si apre la finestra delle impostazioni GitHub sync.
Selezionare un progetto dall'elenco a discesa.
Selezionare il metodo di autenticazione:
- GitHub App (consigliata)
  
  Se la GitHub App non è ancora installata, fare clic su Autenticazione. L'autenticazione viene eseguita una volta e può essere riutilizzata per più sincronizzazioni di archivio.
  
  Se la GitHub App è già installata, fare clic su Gestisci installazione per Completa l'installazione dell'app per l'organizzazione o l'account di destinazione. L'accesso all'archivio è gestito a livello di organizzazione o account e non è legato a un singolo utente GitHub.
- Token di accesso personale
  
  Fornire un token di accesso all'archivio personale con un ambito API.
  
  Quando si utilizza un token di accesso personale, l'accesso all'archivio dipende dall'utente GitHub che ha creato il token.
- Istanza self-hosted
  
  Fornire l'endpoint API self-hosted di GitHub e un token di accesso all'archivio personale con un ambito API.
Se l'archivio di destinazione richiede commit verificato (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: "L'archivio richiede commit verificati (firmati)."
Se viene utilizzata l'app GitHub, seleziona organizzazione GitHub connessa dall'elenco a discesa. L'elenco archivio si carica in base a tale selezione.
Seleziona un archivio GitHub dall'elenco a discesa.
Seleziona un branch di archivio dall'elenco a discesa da cui importare (push) ed esportare (pull). Di solito questo è il branch master.
Facoltativamente, fornisci un nome di branch per la pull request. Se lasciato vuoto, verrà creato un branch con il valore predefinito phrase-translations.
Fai clic su Convalida 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 e aggiunto all'elenco.
(Facoltativo) Fai clic sull'icona a forma di matita per rinominare l'integrazione.

Importare file

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

Per importare file:

Dalla pagina Sincronizzazioni archivio, seleziona un progetto e fai clic su Importare .

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

Deve essere presente una impostazioni locali predefinita.

Nota

In caso di problemi durante l'importazione, usa 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 assistenza.

Esporta file

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

Per esportare file:

Dalla pagina Repo Syncs, Seleziona un progetto e fai clic su Export .

Viene visualizzata la finestra Export.
Fornisci il branch di destinazione nel campo PR branch.

I file più recenti nell'archivio verranno esportati come una nuova pull request verso il 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, usare 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 assistenza.

Cronologia

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

Per visualizzare la cronologia:

Dalla pagina Repo Syncs, Seleziona un progetto e fai clic su History .

Viene presentata la cronologia di importazione ed esportazione per il progetto. Le voci di Esporta nella cronologia includono un link alla corrispondente merge request.