Cette documentation explique comment utiliser la localisation verbeuse pour trouver les clés de traduction pour le texte personnalisé dans Discourse.
Niveau d’utilisateur requis : Administrateur
Trouver une clé de traduction à l’aide de la localisation verbeuse
La localisation verbeuse est un outil puissant dans Discourse qui aide les administrateurs à trouver plus efficacement les clés de traduction pour le texte personnalisé. Ceci est particulièrement utile lorsque vous avez besoin de traduire du texte apparaissant à plusieurs endroits dans l’interface utilisateur de Discourse.
Sommaire
Ce guide couvre :
- Activation de la localisation verbeuse.
- Utilisation de la localisation verbeuse pour identifier les clés de traduction.
- Applications pratiques et cas d’utilisation courants.
Activation de la localisation verbeuse
Il existe plusieurs façons d’activer la localisation verbeuse, selon votre configuration.
Utilisation de la barre d’outils des développeurs (recommandé)
La Barre d’outils des développeurs Discourse inclut un commutateur intégré pour la localisation verbeuse. C’est la méthode la plus simple et fonctionne sur les sites auto-hébergés et hébergés.
- Ouvrez la console du développeur de votre navigateur sur votre site Discourse.
- Exécutez :
enableDevTools() - La page se rechargera et une barre d’outils de développeur apparaîtra sur le côté gauche de l’écran.
- Cliquez sur l’icône
(défilement) dans la barre d’outils pour activer la localisation verbeuse. - La page se rechargera avec la localisation verbeuse activée.
L’état de la barre d’outils des développeurs est stocké dans le stockage local de votre navigateur, et l’état de la localisation verbeuse est stocké dans le stockage de session. Les autres utilisateurs ne seront pas affectés.
Utilisation de la console du navigateur directement
- Ouvrez l’inspecteur web de votre navigateur sur votre site Discourse.
- Allez à l’onglet console.
- Entrez la commande JavaScript suivante à l’invite :
I18n.enableVerboseLocalizationSession() - Vous devriez voir une réponse similaire à :
Utilisation de la console rails (auto-hébergé uniquement)
Le paramètre de site verbose_localization existe mais est un paramètre de site masqué. Il ne peut pas être trouvé dans l’interface d’administration sous « Tous les paramètres du site ». Pour l’activer globalement pour tous les utilisateurs sur une instance auto-hébergée :
- Accédez à la console rails.
- Exécutez :
SiteSetting.verbose_localization = true
Cela active la localisation verbeuse pour tous les utilisateurs du site. Préférez les méthodes basées sur la session ci-dessus pour éviter d’encombrer l’interface utilisateur pour les autres utilisateurs.
Utilisation de la localisation verbeuse pour trouver une clé de traduction
Lorsque la localisation verbeuse est activée, vous verrez des nombres affichés après tout le texte personnalisable de votre site.
Étapes pour identifier une clé de traduction
- Accédez à la zone contenant le texte que vous souhaitez modifier. Par exemple, si vous cherchez à changer le mot « Name » (Nom) :
- Recherchez le numéro de traduction associé dans la console de votre navigateur :
- Notez la clé de traduction identifiée, telle que
user.name.title. - Allez dans la barre latérale Admin et entrez
site textsdans la barre de recherche - Entrez la clé de traduction dans la boîte de recherche :
- Cliquez sur le bouton Modifier du texte et mettez à jour le texte selon vos besoins.
Meilleures pratiques
- Utilisez la localisation verbeuse spécifique à la session pour éviter d’encombrer l’interface utilisateur pour les autres utilisateurs lors des tâches de traduction.
- Documentez les clés de traduction fréquemment utilisées pour référence future.
- Vérifiez régulièrement les mises à jour dans la documentation Discourse pour vous tenir informé des nouvelles fonctionnalités de localisation.
Problèmes courants et solutions
Problème : Marqueurs de traduction visibles pour tous les utilisateurs
Solution : Assurez-vous d’activer la localisation verbeuse exclusivement pour votre session si les autres utilisateurs ne doivent pas la voir. Utilisez la barre d’outils des développeurs ou la méthode de console I18n.enableVerboseLocalizationSession() au lieu du paramètre de site global.
Problème : Difficulté à trouver la bonne clé de traduction
Solution : Utilisez avec précision la console et les marqueurs de localisation verbeuse, et recoupez avec la page Personnaliser les textes du site.
FAQ
Q : La localisation verbeuse peut-elle être restreinte aux administrateurs ou au personnel ?
R : Les numéros de localisation verbeuse peuvent être masqués des utilisateurs non techniques en l’activant dans des sessions individuelles via la barre d’outils des développeurs ou la console du navigateur.
Q : Comment les traductions de chaînes peuvent-elles être vérifiées ?
R : Après avoir identifié et mis à jour la clé de traduction, examinez les modifications de l’interface utilisateur dans une nouvelle session ou un nouvel onglet de navigateur.