Convertir QCH en TS

Comprendre les formats de fichier QCH et TS

QCH files sont des fichiers Qt Compressed Help, couramment utilisés pour stocker la documentation sous un format compressé pour le framework Qt. Ces fichiers sont généralement générés à partir de fichiers QHP (Qt Help Project) et sont utilisés par Qt Assistant et d'autres applications basées sur Qt pour fournir un contenu d'aide structuré et recherché.

TS files sont des fichiers Qt Linguist Translation Source. Ils sont basés sur XML et utilisés pour stocker les traductions du texte de l'interface utilisateur dans les applications Qt. Les développeurs et traducteurs utilisent les fichiers TS pour gérer et localiser les chaînes de caractères de l'application.

Pourquoi convertir QCH en TS ?

Convertir un fichier QCH en fichier TS n'est pas une procédure standard, car ces formats ont des usages différents. Cependant, vous pourriez vouloir extraire du texte traduisible de la documentation (QCH) afin de créer ou de mettre à jour des fichiers de traduction (TS) pour la localisation.

Comment convertir QCH en TS

Il n'existe pas d'outil automatique direct pour convertir les fichiers QCH en fichiers TS, mais vous pouvez suivre ces étapes :

1. Extraire le contenu du QCH : Utilisez l'outil qhelpgenerator (faisant partie du SDK Qt) pour extraire le contenu HTML du fichier QCH. Alternativement, utilisez qch-extract (outil open-source) pour décompresser le fichier QCH.
2. Identifier le texte à traduire : Examinez les fichiers HTML extraits et repérez le texte à traduire.
3. Créer ou mettre à jour les fichiers TS : Utilisez Qt Linguist ou les outils en ligne de commande Linguist pour créer un nouveau fichier TS. Vous pouvez ajouter manuellement les chaînes extraites ou utiliser des scripts pour automatiser le processus.

Logiciels recommandés pour la conversion QCH en TS

• qch-extract : Outil open-source pour extraire le HTML des fichiers QCH. Disponible sur GitHub.
• Qt Linguist : Outil officiel de Qt pour éditer et gérer les fichiers TS.
• Outils SDK Qt : Inclut qhelpgenerator et d'autres utilitaires pour travailler avec les fichiers QCH.

Exemple étape par étape avec qch-extract et Qt Linguist

1. Téléchargez et installez qch-extract depuis GitHub.
2. Exécutez qch-extract yourfile.qch -o output_folder pour extraire les fichiers HTML.
3. Ouvrez les fichiers HTML et copiez le texte à traduire.
4. Ouvrez Qt Linguist et créez un nouveau fichier TS via Fichier → Nouveau.
5. Collez le texte extrait en tant que nouvelles entrées de traduction.
6. Enregistrez le fichier TS pour l'utiliser dans votre projet Qt.

Conclusion

Bien qu'il n'existe pas de convertisseur direct de QCH en TS, vous pouvez extraire le contenu de la documentation depuis les fichiers QCH et l'ajouter manuellement ou semi-automatiquement dans des fichiers TS en utilisant les outils recommandés. Ce processus vous permet de localiser la documentation ou d'intégrer des traductions de contenu d'aide dans vos applications Qt.