Convertir QCH a QHP

Entendiendo los formatos de archivo QCH y QHP

QCH files son archivos de ayuda compilados utilizados por el Qt Help Framework. Contienen documentación comprimida, incluyendo páginas HTML, imágenes y metadatos, y generalmente se generan a partir de archivos QHP. QHP files, o archivos Qt Help Project, son archivos de proyecto basados en XML que describen la estructura, contenido y metadatos de una colección de ayuda antes de ser compilados en un archivo QCH.

¿Por qué convertir QCH a QHP?

Convertir un QCH file de nuevo a un QHP file no es un proceso estándar ni sencillo, ya que QCH es un formato compilado y QHP es su fuente. Sin embargo, puede que necesite extraer la estructura original del proyecto o documentación para fines de edición o actualización.

Cómo convertir QCH a QHP

No existe una herramienta oficial y directa para convertir archivos QCH de regreso a QHP, pero puede extraer el contenido de un archivo QCH y reconstruir manualmente un proyecto QHP. El proceso implica:

1. Usar la herramienta qhelpgenerator (parte del Qt SDK) para extraer el contenido del archivo QCH.
2. Reconstruir el archivo QHP creando un nuevo archivo de proyecto XML y haciendo referencia a los archivos HTML y de recursos extraídos.

Software recomendado para la extracción de QCH

La mejor herramienta para este proceso es el Qt Help Framework en sí, específicamente las utilidades qhelpgenerator y qcollectiongenerator. Para extraer el contenido:

• Use qhelpgenerator --unpack <yourfile.qch> <output_directory> para extraer los archivos de documentación.
• Crear manualmente un nuevo archivo QHP haciendo referencia a los archivos extraídos y siguiendo la esquema XML del proyecto Qt Help.

Resumen

Aunque no hay una forma automatizada de convertir QCH a QHP, puede extraer el contenido de un archivo QCH usando las herramientas de Qt y reconstruir manualmente un proyecto QHP. Este proceso es más adecuado para usuarios familiarizados con el sistema de documentación de Qt.