Astuce
Pour des informations sur l'intégration de GitHub dans Phrase TMS, référez-vous à GitHub (TMS).
Phrase Strings s'intègre aux référentiels GitHub pour synchroniser les fichiers de localisation entre Phrase et GitHub.
Par défaut, les référentiels sont connectés à l'aide d'une application OAuth GitHub. Les jetons d'accès personnels sont également pris en charge et sont principalement destinés aux instances auto-hébergées ou aux environnements où l'installation de l'application OAuth n'est pas possible.
Prérequis
-
Le fichier
.phrase.ymlconfiguration doit être présent à la racine de la branche à surveiller. Le fichier définit quels fichiers importer (pull) ou exporter (push) depuis le référentiel. -
Des droits de lecture et d'écriture sont requis pour le référentiel.
-
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. -
-
L'application OAuth GitHub doit être installée dans l'organisation ou le compte GitHub qui possède le référentiel.
-
Le référentiel doit être inclus dans l'installation de l'application OAuth.
-
Des autorisations pour installer ou autoriser les applications GitHub sont requises dans l'organisation ou le compte cible.
-
-
-
Jetons classiques
Nécessite la portée repo (
public_reposi synchronisation avec un référentiel public) -
Jetons à granularité fine
Nécessite les autorisations suivantes :
-
Contenus : Lire et écrire
-
Demandes de tirage : Lire et écrire
-
-
Assurez-vous que les paramètres du référentiel ne nécessitent pas de validations signées.
-
-
Si SSO est activé dans GitHub, il doit également l’être pour le jeton d'accès.
-
La branche phrase_translations ne peut pas être protégée.
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.
Une fois le fichier de configuration en place, pour connecter un référentiel, suivez ces étapes :
-
Depuis la page , faites défiler vers le bas jusqu'à et cliquez sur Configurer.
La page s'ouvre.
-
Cliquez sur Ajouter Synchronisation/GitHub.
La fenêtre des paramètres de s'ouvre.
-
Sélectionnez un projet dans la liste déroulante.
-
Sélectionnez la méthode d'authentification :
-
Si l'application GitHub n'est pas encore installée, cliquez sur Authentifier. L'authentification est effectuée une fois et peut être réutilisée pour plusieurs synchronisations de référentiels.
Si l'application GitHub est déjà installée, cliquez sur Gérer l'installation pour compléter l'installation de l'application pour l'organisation ou le compte cible. L'accès au référentiel est géré au niveau de l'organisation ou du compte et n'est pas lié à un utilisateur GitHub individuel.
-
Fournissez un personnel avec un champ d'API.
Lorsque vous utilisez un jeton d'accès personnel, l'accès au référentiel dépend de l'utilisateur GitHub qui a créé le jeton.
-
Fournissez le auto-hébergé de GitHub et un personnel avec un champ d'API.
-
-
Sélectionnez un dans la liste déroulante.
-
Sélectionnez une dans la liste déroulante à importer (pousser) et à exporter (tirer). C'est généralement la branche principale.
-
Optionnellement, fournissez un nom de branche pour la demande de tirage. Si laissé vide, une branche sera créée avec la valeur par défaut .
-
Cliquez sur Valider la configuration pour vous assurer que les paramètres d'authentification et le fichier de configuration sont corrects.
-
Optionnellement, sélectionnez une option de pour déterminer quand de nouveaux fichiers ou des fichiers mis à jour sont automatiquement importés dans le projet.
-
Cliquez sur Enregistrer.
Le projet est maintenant connecté au référentiel GitHub sélectionné et ajouté à la liste.
Assurez-vous que les commandes de poussée sont correctement configurées dans le fichier .phrase.yml configuration. Les options de poussée sont les mêmes que pour le téléversements point de terminaison API.
Pour importer des fichiers :
-
Depuis la page , sélectionnez un projet et cliquez sur Importer
.
Les fichiers de langue (définis comme des entrées de source push dans le fichier de configuration) sont importés dans le projet.
Un paramètre linguistique par défaut doit être présent.
Remarque
En cas de problèmes lors de l'importation, utilisez le client CLI pour tester le fichier de configuration
.phrase.ymllocalement et vérifier les messages d'erreur.Si nécessaire, contactez le support technique de Phrase et joignez le fichier de configuration
.phrase.ymlà la demande de support.
Assurez-vous que les commandes de pull sont correctement configurées dans le fichier de configuration .phrase.yml configuration. Les options de pull (par exemple, le paramètre include_empty_translations) sont les mêmes que pour le point de terminaison API locales download.
Pour exporter des fichiers :
-
Depuis la page , sélectionnez un projet et cliquez sur Exporter
.
La fenêtre s'affiche.
-
Fournissez la branche cible dans le champ .
Les fichiers les plus récents du référentiel seront exportés en tant que nouvelle demande de tirage vers la branche souhaitée.
-
Une fois les fichiers exportés, la demande de tirage peut être fusionnée ou fermée dans le référentiel et la branche peut être supprimée.
Note
En cas de problèmes lors de l'exportation, utilisez le client CLI pour tester le fichier de configuration .phrase.yml localement et vérifier les messages d'erreur.
Si nécessaire, contactez le support technique de Phrase et joignez le fichier de configuration .phrase.yml à la demande de support.
Les synchronisations de référentiel conservent un historique des dernières importations et exportations pour chaque projet de chaînes Phrase.
Pour voir l'historique :