Convertir QCH en QHP

Comprendre les formats de fichiers QCH et QHP

QCH files sont des fichiers d'aide compilés utilisés par le Qt Help Framework. Ils contiennent une documentation compressée, y compris des pages HTML, des images et des métadonnées, et sont généralement générés à partir de fichiers QHP. Les fichiers QHP, ou Qt Help Project, sont des fichiers de projet basés sur XML qui décrivent la structure, le contenu et les métadonnées d'une collection d'aide avant qu'elle ne soit compilée en un fichier QCH.

Pourquoi convertir QCH en QHP ?

Convertir un fichier QCH en un fichier QHP n'est pas un processus standard ou simple, car QCH est un format compilé et QHP en est la source. Cependant, vous pouvez avoir besoin d'extraire la structure de projet ou la documentation d'origine pour modifier ou mettre à jour le contenu.

Comment convertir QCH en QHP

Il n'existe pas d'outil officiel et direct pour convertir les fichiers QCH en QHP, mais vous pouvez extraire le contenu d'un fichier QCH et reconstruire manuellement un projet QHP. Le processus consiste à :

1. Utiliser l'outil qhelpgenerator (faisant partie du Qt SDK) pour extraire le contenu du fichier QCH.
2. Reconstruire le fichier QHP en créant un nouveau fichier de projet XML et en faisant référence aux fichiers HTML et ressources extraits.

Logiciel recommandé pour l'extraction QCH

Le meilleur outil pour ce processus est le Qt Help Framework lui-même, en particulier les utilitaires qhelpgenerator et qcollectiongenerator. Pour extraire le contenu :

• Utilisez qhelpgenerator --unpack <yourfile.qch> <output_directory> pour extraire les fichiers de documentation.
• Créez manuellement un nouveau fichier QHP en faisant référence aux fichiers extraits et en suivant le schéma XML du Qt Help Project.

Résumé

Bien qu'il n'existe pas de méthode automatisée pour convertir QCH en QHP, vous pouvez extraire le contenu d'un fichier QCH en utilisant les outils Qt et reconstruire manuellement un projet QHP. Ce processus est particulièrement adapté aux utilisateurs familiers avec le système de documentation Qt.