Converter QCH para QHP

Entendendo os formatos de arquivo QCH e QHP

QCH arquivos são arquivos de ajuda compilados usados pelo Qt Help Framework. Eles contêm documentação compactada, incluindo páginas HTML, imagens e metadados, e são geralmente gerados a partir de arquivos QHP. Arquivos QHP, ou Qt Help Project, são arquivos de projeto baseados em XML que descrevem a estrutura, o conteúdo e os metadados de uma coleção de ajuda antes de serem compilados em um arquivo QCH.

Por que converter QCH para QHP?

Converter um arquivo QCH de volta para um arquivo QHP não é um processo padrão ou direto, pois o QCH é um formato compilado e o QHP é sua origem. No entanto, você pode precisar extrair a estrutura original do projeto ou a documentação para fins de edição ou atualização.

Como converter QCH para QHP

Não existe uma ferramenta oficial direta para converter arquivos QCH de volta para QHP, mas você pode extrair o conteúdo de um arquivo QCH e reconstruir manualmente um projeto QHP. O processo envolve:

1. Usar a ferramenta qhelpgenerator (parte do Qt SDK) para extrair o conteúdo do arquivo QCH.
2. Reconstruir o arquivo QHP criando um novo arquivo de projeto XML e referenciando os arquivos HTML e de recursos extraídos.

Software recomendado para extração de QCH

A melhor ferramenta para esse processo é o próprio Qt Help Framework, especificamente as utilidades qhelpgenerator e qcollectiongenerator. Para extrair o conteúdo:

• Usar qhelpgenerator --unpack <seuarquivo.qch> <diretório_de_saida> para extrair os arquivos de documentação.
• Criar manualmente um novo arquivo QHP referenciando os arquivos extraídos e seguindo o schema XML do Qt Help Project.

Resumo

Embora não exista uma maneira automatizada de converter QCH para QHP, você pode extrair o conteúdo de um arquivo QCH usando as ferramentas do Qt e reconstruir manualmente um projeto QHP. Esse processo é mais indicado para usuários familiarizados com o sistema de documentação Qt.