Utilisation de ltext2id

L'outil en ligne de commande ltext2id convertit un projet utilisant des traductions basées sur du texte en un projet utilisant des traductions basées sur des identifiants. Il analyse l'arborescence du projet, met à jour le code source pour qu'il appelle les API de traduction basées sur des identifiants, et ajuste en conséquence les fichiers d'TS s associés. En cas d'échec de la conversion, le code source sera annoté avec la mention « //ltext2id error: » aux emplacements concernés.

Pour obtenir les meilleurs résultats, incluez à la fois les fichiers sources et les fichiers « TS » dans le répertoire 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 ltext2id.
• project-root est le répertoire à traiter de manière récursive.

Pour consulter l'aide la plus récente, saisissez :

ltext2id -help

ltext2id options

Exemples

Convertir un projet en traductions basées sur des identifiants

Lancez l'outil à la racine du projet. Le code source et les fichiers d'TS s présents dans ce répertoire sont mis à jour sur place.

ltext2id path/to/project

Générer uniquement des suggestions d’ID (sans modification du code)

Utilisez l'-only-meta-id pour insérer des suggestions d'ID sous forme de méta-chaînes sans réécrire les appels à l'API basée sur les ID. Ainsi, les appels de traduction sont annotés par la méta-chaîne « //~ meta-id <id> » (cpp) spécifiant les ID suggérés (méta-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 souhaitez pas que les contextes soient reproduits sous forme d’étiquettes dans Qt Linguist:

ltext2id -no-labels path/to/project

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

Ignorez la génération automatique pour les appels ne comportant pas d’ID méta, c’est-à-dire les ID déjà spécifiés à l’aide de la chaîne méta « //~ meta-id <id> » (cpp) :

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

Utiliser des fichiers source au format UTF-16

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

ltext2id -source-utf16 path/to/project

Code de sortie

ltext2id renvoie un code de sortie différent de zéro en cas d'échec (par exemple, lorsqu'une erreur irrémédiable survient lors de la transformation des fichiers). Vérifiez les annotations de source intégrées marquées d'//ltext2id error: pour corriger les problèmes restants.