Convertir QCH a QHCP

Entendiendo los formatos de archivo QCH y QHCP

QCH archivos son archivos de Qt Compressed Help, utilizados por el marco Qt para almacenar documentación compilada en un formato comprimido. Estos archivos generalmente se generan a partir de proyectos de ayuda fuente y se usan para sistemas de ayuda sin conexión en aplicaciones Qt.

Los archivos QHCP son archivos de Qt Help Collection Project. Son archivos de proyecto basados en XML que definen la estructura y el contenido de una colección de ayuda Qt, incluyendo referencias a archivos QCH y otros recursos. Los archivos QHCP se utilizan como entrada para el Qt Help Collection Generator (qhelpgenerator) para producir un archivo .qhc (Qt Help Collection).

Cómo convertir QCH a QHCP

La conversión directa de un archivo QCH a un archivo QHCP generalmente no es compatible, ya que QCH es un formato compilado y QHCP es una definición de proyecto. Sin embargo, puedes crear un archivo QHCP que haga referencia a tu archivo QCH existente, integrándolo efectivamente en un proyecto de colección de ayuda.

Pasos para crear un archivo QHCP a partir de un archivo QCH

1. Crea un nuevo archivo XML con la extensión .qhcp.
2. Define la estructura, haciendo referencia a tu archivo .qch en la sección <docFiles>.
3. Ejemplo de contenido QHCP:

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

Sustituye tu_ayuda.qch por el nombre de tu archivo QCH.

Mejor software para trabajar con archivos QCH y QHCP

• Qt Assistant: Para ver archivos QCH.
• Qt Creator: Para gestionar proyectos de ayuda y editar archivos QHCP.
• Qt Help Collection Generator (qhelpgenerator): Para compilar archivos QHCP en archivos QHC. Usa el comando:
  qhelpgenerator tu_proyecto.qhcp -o salida.qhc

Resumen

Mientras que no puedes convertir directamente un archivo QCH en un archivo QHCP, puedes crear un proyecto QHCP que haga referencia a tu archivo QCH, permitiéndote construir una colección de ayuda. Qt Creator y qhelpgenerator son las herramientas recomendadas para este proceso.