GitHub (Strings)

Le contenu est traduit de l’anglais par Phrase Language AI.

Conseil

Pour plus d’informations sur l’intégration GitHub dans Phrase TMS, reportez-vous à GitHub (TMS).

Prérequis

Le fichier de configuration .phrase.yml doit être présent à la racine de la branche à surveiller. Le fichier définit les fichiers à importer (pull) ou exporter (push) depuis le référentiel.
Le référentiel doit accéder en lecture et en écriture.
Des fichiers de configuration mal définis peuvent entraîner des erreurs. Assurez-vous que le fichier contient au moins une cible push et une cible pull, des formats de fichiers corrects et le bon réglage du paramètre update_translations .
Authentifiant d’accès GitHub :
- Authentifiants classiques
  
  Nécessite la portée du référentiel (public_repo si synchronisation avec un référentiel public)
- Authentifiants à grain fin
  
  Requiert les autorisations suivantes :
  - Contenu : Lecture et écriture
  - Demandes d’pull : Lecture et écriture
Si SSO est activé dans GitHub, l’authentifiant d’accès doit également l’être.
La branche phrase_translations ne peut pas être protégée.
Assurez-vous que les paramètres référentiels ne nécessitent pas de validations signées.

Note

En raison des améliorations continues, l'interface utilisateur peut ne pas être exactement la même que celle présentée dans la vidéo.

Connecter les référentiels

Une fois le fichier de configuration en place, pour connecter un référentiel, procédez comme suit:

À partir de la page des intégrations, faites défiler vers le connecteur Sychronisation GitHub et cliquez sur Configurer.

La page Synchronisations du référentiel s'ouvre.
Ajouter synchronisation/GitHub

La fenêtre des paramètres de synchronisation GitHub s'ouvre.
Sélectionner un projet dans la liste déroulante.
Sélectionnez éventuellement l’instance auto-hébergée et fournissez le point de terminaison API auto-hébergé GitHub.
Fournir un authentifiant d’accès personnel au référentiel avec une portée API.
Sélectionner un référentiel GitHub dans la liste déroulante.
Sélectionner une branche Référentielle dans la liste déroulante où importer (push) et exporter (pull). Il s'agit généralement de la branche maître.
Cliquez sur Valider la configuration pour vous assurer que l’authentifiant d’accès et le fichier de configuration sont corrects.
Sélectionnez éventuellement l’importation automatique pour importer des fichiers à chaque validation vers la branche GitHub sélectionnée.
Cliquez sur Enregistrer.

Le projet est maintenant connecté au référentiel GitHub sélectionné et ajouté à la liste.

Importer fichiers

Assurez-vous que les commandes push sont correctement configurées dans le fichier de configuration .phrase.yml . Les options push sont les mêmes que pour le point de terminaison de l'API uploads .

Pour importer fichiers :

Dans la page Synchronisations du référentiel, sélectionnez un projet et cliquez sur Importer .

Les fichiers langue (définis comme des entrées source push dans le fichier de configuration) sont importés dans le projet.

Les paramètres régionaux par défaut doivent être présents.

Note

En cas de problème lors de l'importation, utilisez le client CLI pour tester localement le fichier de configuration .phrase.yml et vérifier les éventuels messages d'erreur.

Si nécessaire, contactez le support technique Phrase et joignez le fichier de configuration .phrase.yml à la demande de support.

Exporter fichiers

Assurez-vous que les commandes pull sont correctement configurées dans le fichier de configuration .phrase.yml . Les options pull (par exemple le paramètre include_empty_translations) sont les mêmes que pour le point de terminaison de l'API locales download .

Pour exporter fichiers :

Dans la page Synchronisations du référentiel, sélectionnez un projet et cliquez sur Exporter .

Les fichiers de langue les plus récents du référentiel sont exportés sous forme de nouvelle pull request.
Une fois les fichiers exportés, la pull request peut être fusionnée ou fermée dans le référentiel et la branche peut être supprimée.

Note

En cas de problème lors de l'exportation, utilisez le client CLI pour tester localement le fichier de configuration .phrase.yml et vérifier tout message d'erreur.

Si nécessaire, contactez le support technique Phrase et joignez le fichier de configuration .phrase.yml à la demande de support.

Histoire

Les synchronisations des référentiels gardent un historique des dernières importations et exportations pour chaque projet Phrase Strings.

Pour afficher l'historique :

Depuis la page Synchronisations du référentiel, sélectionnez un projet et cliquez sur History .

L'historique importer et exporter pour le projet est présenté. Exporter les entrées de l'historique incluent un lien vers la demande fusionnée correspondante.