Converter QCH para QHCP

Entendendo os formatos de arquivo QCH e QHCP

QCH arquivos são arquivos Qt Compressed Help, utilizados pelo framework Qt para armazenar documentação compilada em um formato comprimido. Esses arquivos normalmente são gerados a partir de projetos de ajuda fonte e são usados para sistemas de ajuda offline em aplicações Qt.

QHCP arquivos são arquivos Qt Help Collection Project. São arquivos de projeto baseados em XML que definem a estrutura e o conteúdo de uma Collection de Ajuda Qt, incluindo referências a arquivos QCH e outros recursos. Os arquivos QHCP são usados como entrada para o Qt Help Collection Generator (qhelpgenerator) para produzir um arquivo .qhc (Qt Help Collection).

Como converter QCH para QHCP

A conversão direta de um arquivo QCH para um arquivo QHCP geralmente não é suportada, pois o QCH é um formato compilado e o QHCP é uma definição de projeto. No entanto, você pode criar um arquivo QHCP que referencie seu arquivo QCH existente, integrando-o efetivamente a um projeto de coleção de ajuda.

Passos para criar um arquivo QHCP a partir de um arquivo QCH

1. Crie um novo arquivo XML com a extensão .qhcp.
2. Defina a estrutura, referenciando seu arquivo .qch na seção <docFiles>.
3. Exemplo de conteúdo QHCP:

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

Substitua your_help.qch pelo nome do seu arquivo QCH.

Melhores softwares para trabalhar com arquivos QCH e QHCP

• Qt Assistant: Para visualização de arquivos QCH.
• Qt Creator: Para gerenciamento de projetos de ajuda e edição de arquivos QHCP.
• Qt Help Collection Generator (qhelpgenerator): Para compilar arquivos QHCP em arquivos QHC. Use o comando:
  qhelpgenerator your_project.qhcp -o output.qhc

Resumo

Embora você não possa converter diretamente um arquivo QCH em um arquivo QHCP, pode criar um projeto QHCP que referencie seu arquivo QCH, permitindo construir uma coleção de ajuda. Qt Creator e qhelpgenerator são as ferramentas recomendadas para esse processo.