Convertir QCH en QHCP

Comprendre les formats de fichiers QCH et QHCP

QCH fichiers sont des fichiers Qt Compressed Help, utilisés par le framework Qt pour stocker une documentation compilée dans un format compressé. Ces fichiers sont généralement générés à partir de projets d'aide sources et sont utilisés pour des systèmes d'aide hors ligne dans les applications Qt.

Les fichiers QHCP sont des fichiers Qt Help Collection Project. Ce sont des fichiers de projet basés sur XML qui définissent la structure et le contenu d'une collection d'aide Qt, y compris les références aux fichiers QCH et autres ressources. Les fichiers QHCP sont utilisés en entrée du Qt Help Collection Generator (qhelpgenerator) pour produire un fichier .qhc (Qt Help Collection).

Comment convertir QCH en QHCP

Une conversion directe d’un fichier QCH vers un fichier QHCP n’est généralement pas supportée, car QCH est un format compilé et QHCP est une définition de projet. Cependant, vous pouvez créer un fichier QHCP qui référence votre fichier QCH existant, l’intégrant ainsi dans un projet de collection d’aide.

Étapes pour créer un fichier QHCP à partir d’un fichier QCH

1. Créer un nouveau fichier XML avec l’extension .qhcp.
2. Définir la structure, en référant votre fichier .qch dans la section <docFiles>.
3. Contenu d’un exemple de QHCP :

<?xml version="1.0" encoding="utf-8"?>
<QtHelpCollectionProject version="1.0">
  <docFiles>
    <file>your_help.qch</file>
  </docFiles>
</QtHelpCollectionProject>

Remplacez your_help.qch par le nom de votre fichier QCH.

Meilleur logiciel pour travailler avec les fichiers QCH et QHCP

• Qt Assistant : Pour visualiser les fichiers QCH.
• Qt Creator : Pour gérer les projets d’aide et éditer les fichiers QHCP.
• Qt Help Collection Generator (qhelpgenerator) : Pour compiler les fichiers QHCP en fichiers QHC. Utilisez la commande :
  qhelpgenerator your_project.qhcp -o output.qhc

Résumé

Bien que vous ne puissiez pas convertir directement un fichier QCH en fichier QHCP, vous pouvez créer un projet QHCP qui référence votre fichier QCH, vous permettant ainsi de construire une collection d’aide. Qt Creator et qhelpgenerator sont les outils recommandés pour ce processus.