Utilisation de ltext2id

L'outil de ligne de commande ltext2id convertit un projet qui utilise des traductions basées sur le texte en traductions basées sur l'identifiant. Il analyse l'arborescence du projet, met à jour le code source pour appeler les API de traduction basées sur l'ID et ajuste les fichiers TS en conséquence. En cas d'échec de la conversion, le code source sera annoté avec //ltext2id error: aux endroits où l'échec s'est produit.

Pour de meilleurs résultats, incluez à la fois les sources et les fichiers TS dans la racine du projet que vous transmettez à l'outil afin que les mises à jour restent cohérentes entre le code et les traductions.

Syntaxe de ltext2id

ltext2id [options] [project-root]

où :

• options désigne une ou plusieurs options de ltext2id.
• project-root est le répertoire à traiter récursivement.

Pour afficher l'aide la plus récente, entrez :

ltext2id -help

ltext2id options

Exemples d'application

Convertir un projet en traductions basées sur les ID

Exécutez l'outil à la racine du projet. Le code source et les fichiers TS qui se trouvent dans ce répertoire sont mis à jour sur place.

ltext2id path/to/project

Générer uniquement des suggestions d'identifiants (pas de modification du code)

Utilisez -only-meta-id pour injecter des suggestions de méta-chaînes d'identification sans réécrire les appels à l'API basée sur l'identification. En conséquence, les appels de traduction sont annotés par '//~ meta-id <id>' (cpp) méta-chaîne spécifiant les ID suggérés (meta ID).

ltext2id -only-meta-id path/to/project

Désactiver la génération d'étiquettes

Empêchez la génération d'étiquettes si vous ne voulez pas que les contextes soient reflétés en tant qu'étiquettes dans Qt Linguist:

ltext2id -no-labels path/to/project

Éviter les ID générés automatiquement

Sauter la génération automatique pour les appels sans méta ID, c'est-à-dire les ID déjà spécifiés en utilisant la chaîne méta '//~ meta-id <id>' (cpp) :

ltext2id -no-auto-id path/to/project

Travailler avec des fichiers sources UTF-16

Si vos sources sont encodées en UTF-16, activez l'option :

ltext2id -source-utf16 path/to/project

Quitter l'état

ltext2id renvoie un code de sortie non nul en cas d'échec (par exemple, lorsqu'il rencontre une erreur irrécupérable lors de la transformation des fichiers). Inspectez les annotations de source en place marquées par //ltext2id error: pour résoudre les problèmes restants.