Convert QCH to QHP

Understanding QCH and QHP file formats

QCH files are compiled help files used by the Qt Help Framework. They contain compressed documentation, including HTML pages, images, and metadata, and are typically generated from QHP files. QHP files, or Qt Help Project files, are XML-based project files that describe the structure, content, and metadata of a help collection before it is compiled into a QCH file.

Why convert QCH to QHP?

Converting a QCH file back to a QHP file is not a standard or straightforward process, as QCH is a compiled format and QHP is its source. However, you may need to extract the original project structure or documentation for editing or updating purposes.

How to convert QCH to QHP

There is no direct, official tool to convert QCH files back to QHP, but you can extract the contents of a QCH file and reconstruct a QHP project manually. The process involves:

1. Using the qhelpgenerator tool (part of the Qt SDK) to extract the contents of the QCH file.
2. Rebuilding the QHP file by creating a new XML project file and referencing the extracted HTML and resource files.

Recommended software for QCH extraction

The best tool for this process is the Qt Help Framework itself, specifically the qhelpgenerator and qcollectiongenerator utilities. To extract content:

• Use qhelpgenerator --unpack <yourfile.qch> <output_directory> to extract the documentation files.
• Manually create a new QHP file by referencing the extracted files and following the Qt Help Project XML schema.

Summary

While there is no automated way to convert QCH to QHP, you can extract the contents of a QCH file using Qt's tools and manually reconstruct a QHP project. This process is best suited for users familiar with the Qt documentation system.