Lors du chargement d'un fichier dans un projet, toutes les nouvelles ressources sont extraites de ce fichier et stockées dans un projet. Le format du fichier chargé ne doit pas nécessairement être le format initial configuré pour le projet. Si des balises sont fournies pour regrouper les ressources, les nouvelles clés se verront appliquer ces balises.
Certains formats, tels que Gettext, fournissent des méta-informations précieuses supplémentaires telles que des commentaires, des descriptions ou des informations sur les formes plurielles. Ces informations sont extraites quand et partout où cela est possible et sont stockées avec les ressources assignées, permettant à toutes les informations précieuses fournies dans les fichiers de localisation d'être enregistrées pour une utilisation ultérieure.
Il existe plusieurs méthodes pour charger des fichiers :
-
Dans l'application, lors de la création d'un nouveau projet ou en sélectionnant Charger un fichier sur une page de projet
-
via API
-
via CLI
-
Par défaut, seul le nouveau contenu est extrait et aucune clé existante dans un projet de localisation n'est supprimée ou mise à jour ; aucune donnée ne peut être perdue en chargeant des fichiers. Si le remplacement des données existantes est requis, Remplacer les ressources du projet par le contenu du fichier de localisation en sélectionnant l'option . Les traductions existantes seront remplacées par le contenu du fichier de localisation chargé.
Cette option est également disponible dans l'API.
Remarque
Pour éviter toute perte de données, assurez-vous que les dernières modifications sont téléchargées depuis Phrase vers le fichier de localisation avant de le modifier et de le charger à nouveau avec l'option .
-
Saisissez un identifiant unique (par exemple, le chemin du fichier) à ajouter au début des noms de clé de traduction chargés. Utiliser un préfixe significatif lié au projet ou au fichier pour garder les noms de clé organisés.
Par exemple, une clé importée
hello_worldavec le préfixeproject_donnera la cléproject_hello_world.Le préfixe de clé de traduction garantit que les clés correspondent aux clés existantes afin d'éviter les collisions entre différents projets ou fichiers.
Cette option est également disponible dans l'API et l'interface CLI.
-
Ajouter de nouvelles clés et remplacer les existantes par le contenu du fichier chargé.
-
Mettre à jour les traductions cible uniquement si le texte source existant dans la langue par défaut du projet correspond au texte source dans le fichier multilingue chargé.
-
Sélectionnez cette option si la mise à jour de toutes les descriptions des clés à partir du fichier chargé est requise. Les descriptions vide remplaceront les existantes. Les descriptions peuvent contenir toute information supplémentaire pour les traducteurs et aider à identifier les clés individuelles dans l'éditeur.
-
Pour garder les traductions organisées, ajoutez plusieurs balises aux clés avec des étiquettes significatives. Sélectionnez cette option pour empêcher que les nouvelles clés ne soient automatiquement marquées avec une balise de charger.
-
Sélectionnez cette option pour marquer automatiquement les nouvelles clés et les clés dont les traductions ont été mises à jour lors du charger. Cela aidera à distinguer les Strings de traduction nouvelles, mises à jour et anciennes, en garantissant que seules les clés pertinentes sont traitées ultérieurement.
Cette option est également disponible dans l'API.
-
Spécifiez l'encodage (par ex. UTF-8) du fichier ou faites-le sélectionner automatiquement (un encodage sélectionné automatiquement peut entraîner un encodage incorrect et peut être annulé en annulant le charger).
-
-
évite d'avoir à vérifier à nouveau les traductions dans une langue autre que la langue principale lors de la mise à jour des traductions.
-
traite toutes les traductions chargées comme révisées. Cette option est disponible lorsque le flux de travaux de révision avancé a été activé. Cela indique que les clés sont prêtes à être envoyées en production.
-
traite toutes les traductions chargées comme vérifiées.
-
Pour charger des fichiers dans Strings, suivez ces étapes :
-
Avant le charger, assurez-vous que le fichier est correctement mis en format selon type.
-
Depuis un projet, Sélectionner Charger fichier dans le menu .
La page s'ouvre.
-
Cliquez sur Choisir un fichier, sélectionner un fichier depuis un répertoire.
Le fichier sélectionné est ajouté au champ .
-
Sélectionner un pour le fichier.
Les formats suggérés sont présentés en premier en fonction du type de fichier.
-
Sélectionner une langue pour le contenu du fichier dans la liste déroulante.
Si ces informations ne figurent pas dans le fichier lui-même, Créer une nouvelle langue pour le contenu ou utiliser une langue existante.
-
Fournissez éventuellement des balises à assigner aux nouvelles clés ainsi que toute autre option.
-
Cliquez sur Enregistrer.
Le contenu est importé et converti en clés.
-
Échec du charger
Si un fichier n'a pas pu être traité correctement, des détails sur l'erreur sont fournis pour aider à résoudre le problème.
-
Charger réussi
Après le traitement réussi d'un fichier de traduction, une page de résumé est présentée, donnant un aperçu du charger avec des boutons renvoyant aux étapes suivantes. Cliquez sur la balise de charger pour ouvrir le fichier dans l'éditeur.
-
Suppression de clés
Pour éviter la suppression accidentelle de clés lors de la suppression de clés d'un fichier de localisation et de son nouveau charger, ces clés ne sont pas automatiquement supprimées.
Pour retirer ces clés, suivez ces étapes :
Les clés non mentionnées sont des clés qui ne sont pas incluses dans le chargement actuel mais qui existent toujours dans le projet. En les supprimant, toutes les clés et les traductions associées qui n'étaient pas incluses dans le fichier chargé sont retirées du projet.
La limite pour la suppression des clés non mentionnées est de 100 000 clés. Dans les projets qui dépassent cette limite, l'option n'est pas disponible.
-
Annuler un chargement
Chaque chargement déclenche de multiples actions et peut modifier une grande quantité de données au sein des projets, et il n'est pas possible d'annuler un chargement.
Pour retirer des clés qui ont été (par erreur) introduites par un fichier chargé, suivez ces étapes :
-
Depuis le résumé du chargement concerné, cliquez sur Supprimer et sélectionnez .
-
Confirmer la sélection.
Toutes les clés et les traductions associées créées par ce chargement sont retirées. Les traductions des clés qui existaient avant le chargement ne seront pas retirées. Pour retirer des traductions individuelles, utilisez l'historique des versions de chaque traduction.
-
Depuis n'importe quelle page de projet, sélectionnez dans le menu pour accéder à l'archive de chargement.
L'archive de chargement répertorie tous les chargements historiques dans tous les statuts possibles. Cliquez sur le menu déroulant pour filtrer les chargements par statut (, et/ou ). Pour localiser un chargement spécifique, utilisez la zone de recherche en haut pour effectuer une recherche par nom.
Accédez aux résumés détaillés de chargement des ressources affectées en cliquant sur un chargement listé. Tous les chargements réussis sont également présentés dans le flux d'activité d'un projet.
Les fichiers de langue peuvent être exportés depuis un projet à tout moment et vers tout format de fichier pris en charge.
Les fichiers peuvent être exportés depuis l'application, via API, ou CLI.
Les fichiers peuvent être téléchargés depuis l'onglet de tout projet en les Sélectionner et en cliquant sur Télécharger (fichiers multiples) ou sur le bouton Plus d'options /Télécharger d'une langue.
Les options de téléchargement sont présentées lors du téléchargement d'un fichier dans la fenêtre de avec des onglets pour , et .
Sélectionner différents présente différentes options. Pour plus de détails, reportez-vous à l'article pertinent concernant le format de fichier spécifique.
Optionnellement, utilisez le champ dans l'onglet pour spécifier un nom de fichier d'export Personnalisé, ou laissez-le vide pour générer un nom défini par le système.
-
Si un préfixe de clé de traduction a été ajouté lors du chargement du fichier, sélectionnez cette option dans l'onglet pour retirer le préfixe des noms des clés de traduction exportées :
-
Entrez le préfixe pour télécharger toutes les clés, et retirer le préfixe spécifié si possible.
Important
Cela peut Créer des noms de clé en double si d'autres clés partagent le même nom après que le préfixe a été retiré.
-
Si nécessaire, sélectionnez pour effectuer un téléchargement uniquement des clés de traduction contenant le préfixe spécifié, et retirer le préfixe du fichier téléchargé.
Cette option est également disponible dans l'API et l'interface CLI.
-
Par défaut, les ressources traduisible sont stockées sous forme de clés et de valeurs au lieu de conserver la structure de fichier d'origine. Cela permet des format interchangeables sans être verrouillé dans un format, ainsi qu'un regroupement flexible à l'aide de tags.
Certains frameworks ou configurations nécessitent plusieurs fichiers source, ce qui nécessite également une configuration supplémentaire.
Conserver des fichiers séparés
En général, conservez toutes les traductions pour chaque langue dans un seul fichier. Cela rend les téléchargements de ressources plus rapides et plus robustes. Les traductions sont conservées de manière organisée dans des projets, donc des petits fichiers séparés ne sont pas nécessaires.
Si les fichiers de localisation doivent être conservés dans des fichiers séparés, un flux de travaux basé sur les fichiers peut être utilisé en balisant les clés lors du chargement et en utilisant les balises comme référence lors du téléchargement des clés traduites vers les fichiers d'origine. Les clés peuvent porter plusieurs balises et être incluses dans plusieurs fichiers, assurant ainsi la réutilisation et la cohérence. Un flux de travaux basé sur les balises est flexible et permet la réorganisation des ressources de traduction sans avoir à être chargé dans des projets.
Donnez aux clés des noms uniques dans tous les fichiers pour assurer un flux de travaux fluide. Dans une approche basée sur les clés-valeurs, une clé doit avoir les mêmes valeurs qui lui sont assignées dans chaque contexte. Certains frameworks permettent l'utilisation de clés non uniques sur plusieurs fichiers. Certains formats, tels que Symfony, prennent en charge les domaines de message. Ces domaines sont détectés par le nom de fichier. Les clés ne sont pas automatiquement délimitées par des domaines basés sur le nom de fichier, mais cela peut être résolu en utilisant un préfixe de domaine unique pour les clés dans le fichier.
Exemple de configuration CLI
Si vous travaillez avec CLI ou connectez un projet à un référentiel (par ex. GitHub, GitLab ou Bitbucket), configurez un fichier de configuration pour gérer les chargements et les téléchargements.
Pour l'exemple, un projet possède plusieurs fichiers de traduction nommés sémantiquement pour le paramètre linguistique source. Par exemple : accounts.en.yml, emails.en.yml etc. Ces noms sémantiques sont gérés par le biais de balises.
Configurez le .phrase.yml pour refléter l'organisation des fichiers dans le projet de localisation et liez-les aux balises dans le projet Strings en incluant l'espace réservé de balise dans le chemin du fichier :
phrase:
access_token: \"3d7e6598d955bfcab104c45c40af1b9459df5692ac4c28a17793\"
Identifiant_projet: "23485c9c5dfb15d85b32d9c5f3d2hl54"
file_format: yml
push:
sources:
- fichier : ./path/to/locales/<balise>.en.yml
params:
Identifiant_paramètre linguistique: "abcd1234cdef1234abcd1234cdef1234"
pull:
targets:
# comptes
- fichier : ./path/to/locales/accounts.<nom_paramètre_linguistique>.yml
params:
balises : comptes
# e-mails
- fichier : ./path/to/locales/emails.<nom_paramètre_linguistique>.yml
params:
balises : e-mails
Important
Bien que pris en charge, pour des raisons de sécurité, il n'est pas recommandé de stocker des jetons d'accès dans le fichier.
Définir une variable d'environnement PHRASE_JETON_ACCÈS est plus sécurisé.
Les balises de paramètre peuvent également être utilisées dans la section push au lieu d'utiliser l'espace réservé <balise>.
La configuration crée des clés avec des balises basées sur le fichier dont elles proviennent lors de l'exécution d'un push ou du déclenchement d'une synchronisation depuis un référentiel. Lors de l'exécution d'un pull ou du déclenchement de l'export vers le référentiel, cela regroupe les clés dans des fichiers en fonction de leurs balises.
Un produit, un site web ou une application est traduit dans un certain nombre de langues différentes, mais dans certains cas, la localisation ne concerne pas seulement la langue choisie, mais différentes versions au sein d'une même langue.
Une distinction supplémentaire est requise si :
-
Un produit a une image de marque différente dans des régions où la même langue est parlée.
-
Un produit est utilisé par différents clients qui souhaitent utiliser une solution en marque blanche.
-
Des variantes de langue telles que simple, formelle ou informelle sont requises.
Localisation d'un produit statique
Si un produit est entièrement développé et rarement mis à jour, une version distincte du produit peut exister au sein d'un projet.
-
S'il s'agit d'une sortie unique ou d'un projet à court terme :
Créer une branche, effectuer le travail exclusivement sur cette branche pour la durée du projet, et Supprimer la branche une fois Terminer.
-
S'il s'agit d'un projet à long terme :
Maintenir un Dupliquer du projet existant. Cela permet d'inviter et de travailler avec des clients au sein de la même organisation en leur donnant uniquement accès à leur(s) projet(s), laissant les autres projets cachés pour eux.
Localisation d'un projet avec des mises à jour continues
Si un produit est constamment mis à jour avec du nouveau contenu (clés), appliquer ces mises à jour à plusieurs projets et les maintenir synchronisés est difficile. Utiliser des langues dédiées au sein d'un projet pour les maintenir.
Les codes de langue suivant la norme ISO (par ex. en-US) n'ont pas besoin d'être uniques, ainsi plusieurs versions de la même langue peuvent être créées au sein d'un projet. Distinguer les régions, les clients ou les audiences en utilisant un nom de langue unique.
Lors de la configuration, toute nouvelle clé introduite dans le paramètre linguistique par défaut apparaîtrait comme non traduit dans les autres langues et serait localisée en conséquence. Si vous travaillez avec un client et son ou ses propres traducteur(s), assignez-les spécifiquement pour qu'ils puissent uniquement Modifier leurs versions linguistiques en mettant à jour l'accès à la langue dans leur profil utilisateur ou la gestion des utilisateurs du projet.
Configurer des processus de localisation parallèles avec des tâches et des flux de travail de révision au sein du même projet. Cette flexibilité s'étend également au téléchargement et au chargement de fichiers de langue ou à des processus automatisés via API.