Les clés permettent d'identifier les chaînes textuelles traduisibles dans du code logiciel. Cela permet d'utiliser une clé (comme le nom de code d'une chaîne traduisible) référencée une seule fois par Phrase plutôt qu'à chaque fois qu'une traduction de la chaîne est requise.
Une clé peut être associée à plusieurs traductions, chacune correspondant à des paramètres linguistiques régionaux du projet. Cela fonctionne comme une clé primaire dans les bases de données relationnelles, les traductions étant un attribut de la clé. Les clés sont stockées dans des fichiers de ressources et permettent d'identifier les langues source et cible.
L'utilisation des clés permet aux plateformes de gestion de localisation de présenter du texte traduisible aux traducteurs sans avoir à présenter du code.
Les clés n ' ont normalement pas besoin d ' être ajoutées à un projet car elles sont idéalement créées lorsqu ' un fichier de ressources est chargé via l ' onglet de la page d ' un projet.
Pour empêcher le chargement ou la création de clés, utilisez des clés bloquées. Si une clé bloquée existe déjà, elle ne peut pas être traduite dans l'éditeur.
Pour exclure des clés de l ' exporter, utilisez la fonctionnalité < < exclure clés > > . Les clés exclues ne peuvent pas non plus être traduites dans l'éditeur.
Les clés d'un projet peuvent être dupliquées en sélectionnant Plus/Dupliquer clé dans la section de la page d'un projet ou en haut du volet de l'éditeur Strings.
Différentes clés de traduction ayant les mêmes valeurs dans un ou plusieurs projets peuvent être reliées pour automatiser les mises à jour de contenu. Les clés reliées sont utilisées pour assurer la cohérence entre les projets et éliminer le travail répétitif sur du contenu identique.
Les modifications apportées aux clés peuvent être annulées depuis la fenêtre d'activité de la barre latérale dans l'éditeur Strings.
Remarque
Lorsqu'on travaille avec des référentiels (GitHub, GitLab, etc.) et qu'on supprime des clés, il faut supprimer les clés à la fois de Phrase et du référentiel pour les supprimer définitivement. Cela évite la suppression accidentelle de clés en cas d'erreurs ou d'accidents dans Phrase ou dans le référentiel.
Les noms des clés doivent être uniques pour un projet donné.
Il existe différentes approches pour nommer les clés :
-
Approche descriptive
Le texte d'origine est identifié par sa fonction. Cela peut rendre plus difficile l'identification du texte lors de la lecture du code, mais permet de rester constant.
Exemple :
-
Chaînes source (non recommandé)
Le texte d'origine lui-même est utilisé comme clé ce qui permet d'identifier facilement comment est utilisé le texte. Cette approche est problématique, car si le texte d'origine change, cela rompt la relation avec les traductions.
Exemple :
Si les clés ne sont pas chargées, elles peuvent être créées manuellement.
Pour créer une clé, procédez comme suit :
-
Dans l'onglet , cliquez sur Ajouter une clé.
La fenêtre Ajouter une clé s'ouvre.
-
Dans l'onglet , fournissez un , , toutes disponibles et une .
-
Si nécessaire, activez les formes plurielles depuis l'onglet .
-
Si nécessaire, sélectionnez les langues exclues dans l'onglet .
-
Donnez des détails techniques dans l'onglet si nécessaire.
Par exemple, il est possible de définir une limite de caractères pour les traductions dans le champ . Si elle est définie, la limite de caractères est affichée par un indicateur dans l'éditeur Strings lors de la modification des traductions de la clé concernée.
-
Cliquez sur Enregistrer.
La clé est ajoutée au projet et peut être consultée dans l'onglet .
Supprimer une clé de l'éditeur ou de l'onglet supprimera toutes les traductions associées de cette clé. Cette action ne peut pas pas être annulée.
Dans les projets de plus de 10 000 clés, les clés non mentionnées ne seront plus prises en compte dans les chargements ultérieurs.
Le blocage empêche d'ajouter des clés entières à un projet ; si le nom d'une clé bloquée apparaît dans un fichier chargé, cette clé est omise et n'est pas ajoutée au projet.
Le blocage sert à omettre des clés d'un projet afin qu'elles ne soient pas gérées du tout.
Exemples de clés généralement bloquées :
-
Chaînes de format de date et d'heure.
-
Clés incluant des configurations.
-
Clés causant des problèmes lorsqu'elles sont gérées avec le gestionnaire d'environnement graphique Phrase.
Gérez les clés bloquées dans un fichier de langue séparé qui n'est pas traité ou maintenu.
Les clés suivantes peuvent poser des problèmes. Si elles sont utilisées, il convient de les bloquer lors de la création d'un projet.
-
activemodel.errors* -
number.format* -
number.currency* -
number.percentage* -
datetime.prompts*
Pour bloquer une clé, procédez comme suit :
-
Depuis la page d'un projet, sélectionnez l'onglet .
-
Cliquez sur Ajouter une clé à la liste des clés bloquées.
La fenêtre s'ouvre.
-
Donnez un nom à la clé ou une expression régulière (regexp) et cliquez sur Enregistrer.
La clé est ajoutée à la liste.
Astuce
Les chatbots utilisant l'IA peuvent être très efficaces pour générer et vérifier les expressions régulières.
Utilisez des outils comme Regex101 pour tester votre expression régulière avec différentes entrées.
Les clés peuvent être modifiées ultérieurement en cliquant sur ou sur
supprimé.
Pour exclure des clés pour certaines langues, il suffit de les marquer comme étant exclues. Ces clés sont chargées et existent au sein d'un projet, mais sont ignorées.
Les traductions exclues sont :
-
Exclues de l'export pour la langue concernée.
-
Exclues des rapports relatifs à la langue concernée.
Si le contenu est vide, il n'est pas compté comme non traduit.
-
Visibles, mais non modifiables dans l'éditeur de traduction.
Options d'exclusion :
-
Depuis l'éditeur de traduction, vous pouvez exclure une seule traduction dans une langue.
-
Depuis l'éditeur de traduction, vous pouvez exclure plusieurs traductions dans une langue donnée.
-
Vous pouvez exclure plusieurs traductions en sélectionnant les langues lors de la création ou de la modification de la clé.
Pour exclure une clé, procédez comme suit :
-
Dans la page des clés, cliquez sur
pour la clé à exclure.
La fenêtre s'ouvre.
-
Sélectionner l'onglet .
-
Sélectionnez les langues à exclure.
-
Cliquez sur Enregistrer.
La sélection est exclue dans la clé spécifiée.
Des clés peuvent également être exclues individuellement ou en masse de la liste clé éditeur en sélectionnant la ou les clés et en utilisant le menu statut .