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

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

Per impostazione predefinita, gli archivi vengono connessi 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 una 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 della OAuth App.
- Sono richieste le autorizzazioni per installare o autorizzare le GitHub App nell'organizzazione o nell'account di destinazione.
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 che il file di configurazione è a posto, per connettere un archivio, seguire questi passaggi:

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

Si apre la pagina Repo Syncs.
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 (consigliato)
  
  Se la GitHub App non è ancora installata, fare clic su Authenticate. L'autenticazione viene eseguita una volta e può essere riutilizzata per più sincronizzazioni di archivio.
  
  Se la GitHub App è già installata, fare clic su Manage installation 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.
Selezionare un archivio GitHub dall'elenco a discesa.
Selezionare un branch dell'archivio dall'elenco a discesa da cui importare (push) ed esportare (pull). Di solito questo è il branch master.
Facoltativamente, fornire un nome di branch per la pull request. Se lasciato vuoto, verrà creato un branch con il valore predefinito phrase-translations.
Fare clic su Validate Configuration per assicurarsi che le autenticazione impostazioni e il file di configurazione siano corretti.
Facoltativamente Seleziona un'opzione Import behavior 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) Fare clic sull'pencil icon per rinominare l'integrazione.

Importare 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, Seleziona un progetto e fai clic su Import .

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

Deve essere presente un impostazioni locali predefinito.

Nota

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

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

Esporta file

Assicurarsi che i comandi pull siano configurati correttamente all'interno del file di configurazione .phrase.yml. Le opzioni pull (ad es. 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.
Fornire il branch di destinazione nel campo PR branch.

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, usare il cliente CLI per testare il file di configurazione .phrase.yml localmente e controllare eventuali messaggi di errore.

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

Cronologia

Le sincronizzazioni dell'archivio mantengono una cronologia degli ultimi importare ed esportare 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 importare ed esportare per il progetto. Le voci di esportare nella cronologia includono un link alla corrispondente merge request.