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
Lors du chargement via API ou CLI, pour les formats de fichier incluant plusieurs paramètres linguistiques dans un seul fichier (par ex. Phrase Strings .JSON, .YAML, .XLSX/.CSV multilingue, .XLIFF, .TMX, Genesys JSON), l'identifiant de paramètre linguistique de chaque traduction dans le fichier est mis en correspondance avec un paramètre linguistique de projet par nom de langue, exactement comme configuré sur l'onglet du projet. Les codes de paramètre linguistique (par ex. « en-US ») ne sont pas utilisés pour cette correspondance à moins que cette chaîne exacte ne soit également le nom configuré du paramètre linguistique. Si l'identifiant de paramètre linguistique d'une traduction ne correspond à aucun nom de paramètre linguistique dans le projet, ses traductions ne seront pas importées, sans message d'erreur.
-
Par défaut, seul le nouveau contenu est extrait et les clés existantes dans un projet de localisation ne sont ni supprimées ni mises à jour ; aucune donnée ne peut être perdue en chargeant des fichiers. Si le remplacement des données existantes est requis, remplacez 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 ex. 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é sont mises en correspondance avec celles existantes pour éviter les collisions entre différents projet ou fichiers.
Cette option est également disponible dans l'API et l'interface CLI.
-
Ajouter de nouvelles clé et écraser celles existantes avec 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électionner cette option si la mise à jour de toutes les descriptions des clé à partir du fichier chargé est requise. Les descriptions vide écraseront les descriptions existantes. Les descriptions peuvent contenir toute information supplémentaire pour les traducteurs et aider à identifier les clé individuelles dans l'éditeur.
-
Pour garder les traductions organisées, ajouter plusieurs balise aux clé avec des étiquettes significatives. Sélectionner cette option pour empêcher que les nouvelles clé ne soient automatiquement marquées avec une balise de chargement.
-
Sélectionner cette option pour balise automatiquement les nouvelles clé et les clé avec des traductions mises à jour lors du chargement. Cela aidera à distinguer les Strings de traduction nouvelles, mises à jour et anciennes, en garantissant que seules les clé 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 laissez-le être sélectionné automatiquement (un encodage sélectionné automatiquement peut entraîner un encodage incorrect et peut être annulé en annulant le chargement).
-
-
é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é. 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 formaté en fonction du type.
-
Depuis un projet, Sélectionner Charger fichier dans le menu .
La page s'ouvre.
-
Cliquez sur Choisir un fichier, sélectionner un fichier dans un répertoire.
Le fichier sélectionné est ajouté au champ .
-
Sélectionner un format 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 tags à attribuer 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 Suivant. Cliquez sur la balise charger pour ouvrir le fichier dans l'éditeur.
-
Retrait de clés
Pour éviter la suppression accidentelle de clés lors du retrait de clés d'un fichier de localisation et de son nouveau chargement, 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 supprimer 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 de revenir sur un chargement.
Pour retirer des clés qui ont été (par erreur) introduites par un fichier chargé, suivez ces étapes :
-
Depuis le résumé de chargement 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 pour 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 filtre les chargements par statut (, et/ou ). Pour localiser un chargement spécifique, utiliser la zone de recherche en haut pour effectuer une recherche par nom.
Accéder aux résumés détaillés de chargement des ressources affectées en cliquant sur un chargement répertorié. Tous les chargements réussis sont également présentés dans le flux d'activité d'un projet.
Les fichiers de langue peuvent être exporter depuis un projet à tout moment et vers tout format de fichier pris en charge format de fichier.
Les fichiers peuvent être exporter depuis l'application, via API, ou CLI.
Les fichiers peuvent être effectuer un téléchargement depuis l'onglet de tout projet en les Sélectionner et en cliquant sur le bouton Télécharger (fichiers multiples) ou 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 Téléchargement avec des onglets pour Général, Avancé et Encodage.
La sélection de différents formats de fichier présente des options différentes. Pour plus de détails, reportez-vous à l'article pertinent concernant le format de fichier spécifique.
Optionnellement, utiliser le champ Nom de fichier dans l'onglet Général pour spécifier un nom de fichier d'exportation 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électionner cette option dans l'onglet Avancé pour retirer le préfixe des noms des clés de traduction exportées :
-
Entrez le préfixe pour effectuer le téléchargement de toutes les clés, et retirer le préfixe spécifié lorsque cela est possible.
Important
Cela peut Créer des noms de clé en Dupliquer si d'autres clés partagent le même nom après que la clé a été retirée.
-
Si nécessaire, Sélectionner pour effectuer le téléchargement uniquement des clés de traduction contenant le préfixe spécifié, et retirer le préfixe du fichier en téléchargement.
Cette option est également disponible dans l'API et l'interface CLI.
-
Définir l'ordre de traduction lors de l'exportation
Le paramètre définit le classement utilisé pour trier les clé de traduction par ordre alphabétique lorsqu'un projet est exporter. Deux options sont disponibles :
-
Par défaut trier les clé en utilisant l'ordre alphabétique standard basé sur les caractère.
-
Naturel trier les clé en utilisant l'ordre de tri naturel, de sorte que les nombres dans les noms de clé sont trier numériquement plutôt que caractère par caractère (par exemple,
clé2avantclé10).
Pour modifier ce paramètre, ouvrez depuis le menu sur une page de projet. Dans l'onglet , Sélectionner ou dans la liste déroulante , puis cliquez sur Enregistrer.
Par défaut, les ressources traduisible sont stockées sous forme de clé et de valeurs au lieu de conserver la structure de fichier d'origine. Cela permet des format de fichier interchangeables sans être verrouillé dans un seul format, ainsi qu'un regroupement flexible en utilisant des balise.
Certains frameworks ou configurations nécessitent plusieurs fichiers source, ce qui requiert é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 projet, il n'est donc pas nécessaire d'avoir des fichiers séparés.
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é lors du charger et en utilisant les balise comme référence lors du téléchargement des clé traduites dans les fichiers d'origine. Les clé peuvent porter plusieurs balise et être incluses dans plusieurs fichiers, garantissant ainsi la réutilisation et la cohérence. Un flux de travaux basé sur les balise est flexible et permet la réorganisation des ressources de traduction sans avoir à être charger dans des projet.
Donnez aux clé des noms uniques dans tous les fichiers pour garantir un flux de travaux fluide. Dans une approche basée sur les clé-valeur, une clé doit avoir les mêmes valeurs qui lui sont assignées dans chaque contexte. Certains frameworks permettent l'utiliser de clé 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 au sein du fichier.
Exemple de configuration CLI
Si vous travaillez avec CLI ou connectez un projet à un référentiel (par exemple GitHub, GitLab ou Bitbucket), configurez un fichier de configuration pour gérer les téléchargements et les envois.
Pour l'exemple, un projet possède plusieurs fichiers de traduction nommés de manière sémantique 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\"
project_id: \"23485c9c5dfb15d85b32d9c5f3d2hl54\"
file_format: yml
push:
sources:
- file: ./path/to/locales/<balise>.en.yml
params:
locale_id: \"abcd1234cdef1234abcd1234cdef1234\"
pull:
targets:
# accounts
- file: ./path/to/locales/accounts.<paramètre linguistique_name>.yml
params:
tags: accounts
# emails
- file: ./path/to/locales/emails.<paramètre linguistique_name>.yml
params:
tags: emails
Important
Bien que pris en charge, pour des raisons de sécurité, il n'est pas recommandé de stocker les jetons d'accès dans le fichier.
Définir une variable d'environnement PHRASE_ACCESS_TOKEN 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é <tag>.
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'exporter 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 les régions où la même langue est parlée.
-
Un produit est utilisé par différents clients qui souhaitent utiliser une solution étiquette 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, travailler exclusivement sur cette branche pendant 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 l'invitation et le travail avec des clients au sein de la même organisation en leur donnant uniquement accès à leur(s) projet(s), tout en laissant les autres projets masqué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 conformes à la norme ISO (par ex. en-US) ne doivent pas nécessairement être uniques, de sorte que plusieurs versions d'une même langue peuvent être créées au sein d'un projet. Faites la distinction entre les régions, les clients ou les publics en utilisant un nom de langue unique.
Lors de la configuration, toute clé nouvellement introduite dans le paramètre linguistique par défaut apparaîtra comme non traduit dans les autres langues et sera localisée en conséquence. Si vous travaillez avec un client et son ou ses traducteur(s), assignez-les spécifiquement afin qu'ils puissent uniquement Modifier leurs versions linguistiques en mettant à jour l'accès à la langue dans leur profil utilisateur ou dans la gestion des utilisateurs du projet.
Configurez 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 à l'importation de fichiers de langue ou aux processus automatisés via API.