Les placeholders stockent des valeurs dynamiques dans les logiciels, comme les noms et les dates. Découvrez comment PTC détecte les formats de placeholder courants pendant la traduction et vous permet d’en ajouter des personnalisés.
PTC détecte les placeholders dans les chaînes et les conserve inchangés pendant la traduction. Étant donné que différents formats de fichiers de ressources ont leur propre syntaxe de placeholder, PTC :
- Reconnaît les formats de placeholder courants à l’aide de modèles regex prédéfinis
- Applique des règles spécifiques au format pour identifier et gérer correctement les placeholders
Voici des exemples de formats de placeholder pris en charge couramment utilisés, ainsi que les expressions régulières (regex) utilisées pour les détecter :
Exemple de placeholder
%service%
%{service}
:service:
${service}
$service$
''service''
[service]
@[service]
{{service}}, {{service_name}}
{service}, {service_name}
Expression régulière (Regex)
\%\w+\%
\%\{\w+\}
\:\w+\:
\$\{\w+\}
\$\w+\$
''\w+''
\[\w+\]
\@\[\w+\]
\{\{[\w_-]+\}\}
\{[\w_-]+\}
Ajout de placeholders personnalisés
Vos fichiers de ressources peuvent contenir des placeholders non standard ou que PTC ne reconnaît pas. Vous pouvez ajouter des placeholders personnalisés pour vous assurer que PTC les détecte et les conserve pendant la traduction.
Sur la page Paramètres → Placeholders de chaîne, PTC répertorie les placeholders prédéfinis en fonction de la structure du projet détectée et des types de fichiers de ressources dans votre projet.
Ici, vous pouvez :
- Modifier ou supprimer les placeholders existants pour l’ensemble du projet ou pour un type de fichier de ressources spécifique.
- Ajouter de nouveaux formats de placeholder si votre projet ou vos fichiers de ressources utilisent une structure unique qui n’est pas reconnue par défaut
Après avoir effectué des modifications, enregistrez vos paramètres pour appliquer les mises à jour.
Meilleures pratiques pour les placeholders personnalisés
Lorsque vous ajoutez des placeholders personnalisés, suivez ces meilleures pratiques pour éviter les problèmes de traduction :
Conservez des placeholders simples
Les formats de placeholder trop complexes sont plus difficiles à reconnaître et à interpréter correctement pour les systèmes. Par exemple :
- Préféré :
<name> - Trop complexe :
<user-name&role-123>
Utilisez des formats uniques
Lorsque deux placeholders partagent des parties de leur structure, les outils de traduction ne peuvent souvent pas les distinguer. Par exemple, jetez un coup d’œil à ce placeholder complexe et simple qui se chevauchent involontairement :
- Placeholder complexe :
{user_details} - Placeholder simple :
{user}
Dans cet exemple, {user_details} peut être détecté par erreur comme {user} parce que {user} fait partie du placeholder complexe.
Utilisez des mots entre les placeholders pour le contexte
Les mots environnants fournissent un contexte qui aide PTC à comprendre comment les placeholders s’intègrent dans une phrase. Ne vous fiez pas aux notes humaines pour clarifier les placeholders, car PTC ne les traite pas. Au lieu de cela, rendez les placeholders clairs à partir de la chaîne.
- Préféré :
"Hello, <name>! Your order number is <order_number>." - Non recommandé :
"<name> <order_number>"
Que se passe-t-il si PTC rencontre des problèmes avec vos placeholders ?
PTC signale les chaînes qui ne sont pas claires pour différentes raisons, telles que :
- Avoir trop de placeholders avec pas assez de contexte
- Contenir du texte ambigu
- Être des chaînes d’un seul mot
Si cela se produit, vous verrez une action recommandée dans votre tableau de bord PTC vous invitant à examiner les chaînes peu claires. Pour traiter les chaînes avec des placeholders peu clairs, vous pouvez :
- Mettre à jour la chaîne directement dans votre projet, par exemple, en simplifiant ou en réorganisant les formats de placeholder.
- Suivre les invites de PTC pour fournir plus d’informations sur l’objectif des placeholders.
