Pour créer automatiquement un fichier de configuration, procédez comme suit :
-
Ouvrez l'invite de commande et tapez
phrase init
pour créer un fichier .phrase.yml.Le processus de configuration se lance dans l’interface CLI.
-
Renseignez les informations suivantes :
-
Jeton d’accès
-
Identifiant de projet Phrase
-
Format de fichiers de paramètres régionaux
-
Emplacement des fichiers de paramètres régionaux dans la base de code du projet
-
Un fichier de configuration de base est créé.
Si vous utilisez un fichier de configuration créé manuellement ou copié, placez-le dans l'un des emplacements suivants :
-
le répertoire dans lequel le client CLI est appelé.
-
le répertoire personnel de l'utilisateur actuel (
$HOME
sous Unix,$HomePath
sous Windows). -
le chemin spécifié dans la variable d'environnement
PHRASEAPP_CONFIG
. -
le chemin vers le fichier de configuration via le drapeau
--config
(par exemple/some/path/to/phrase.yml
).
Exemple de fichier de configuration.
GitLab
-
Le fichier de configuration
.phrase.yml
doit être présent dans le référentiel. Le fichier définit les fichiers à importer (pull) ou exporter (push) depuis le référentiel. -
Les droits de lecture et d'écriture sur le référentiel sont requis.
-
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
. -
Utilisez GitLab 9.5 ou plus récent pour garantir la compatibilité API.
GitHub
-
Le fichier de configuration
.phrase.yml
doit être présent dans le référentiel. Le fichier définit les fichiers à importer (pull) ou exporter (push) depuis le référentiel. -
Les droits de lecture et d'écriture sur le référentiel sont requis.
-
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
. -
Un jeton d’accès GitHub pour la portée du référentiel (
public_repo
en cas de synchronisation avec un référentiel public). -
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.
-
Assurez-vous que les paramètres du référentiel ne nécessitent pas de validations signées.
BitBucket
Le fichier de configuration .phrase.yml
doit être présent dans le référentiel. Le fichier définit les fichiers à importer (pull) ou exporter (push) depuis le référentiel.
Les droits de lecture et d'écriture sur le référentiel sont requis.
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
.