Převod souboru QCH do QHCP

Pochopení formátů souborů QCH a QHCP

QCH soubory jsou Qt Compressed Help soubory, které používá Qt framework k ukládání zkompilované dokumentace ve stlačeném formátu. Tyto soubory jsou obvykle generovány z zdrojových projektů nápovědy a jsou určeny pro offline nápovědné systémy v aplikacích Qt.

QHCP soubory jsou Qt Help Collection Project soubory. Jedná se o XML-based projektové soubory, které definují strukturu a obsah sbírky nápovědy Qt, včetně odkazů na QCH soubory a další zdroje. QHCP soubory se používají jako vstup do Qt Help Collection Generator (qhelpgenerator) pro vytvoření souboru .qhc (Qt Help Collection).

Jak převést QCH na QHCP

Přímá konverze z QCH souboru na QHCP soubor obvykle není podporována, protože QCH je kompilovaný formát a QHCP je definice projektu. Nicméně, můžete vytvořit QHCP soubor, který odkazuje na váš existující QCH soubor, čímž ho efektivně začleníte do projektu sbírky nápovědy.

Kroky pro vytvoření souboru QHCP z QCH souboru

1. Vytvořte nový XML soubor s příponou .qhcp.
2. Definujte strukturu s odkazem na váš .qch soubor v sekci <docFiles>.
3. Příklad obsahu QHCP:

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

Nahraďte your_help.qch názvem vašeho QCH souboru.

Nejlepší software pro práci se soubory QCH a QHCP

• Qt Assistant: pro prohlížení QCH souborů.
• Qt Creator: pro správu projektů nápovědy a úpravu QHCP souborů.
• Qt Help Collection Generator (qhelpgenerator): pro kompilaci QHCP souborů do QHC souborů. Použijte příkaz:
  qhelpgenerator your_project.qhcp -o output.qhc

Souhrn

I když neumíte přímo převést QCH soubor na QHCP soubor, můžete vytvořit projekt QHCP, který odkazuje na váš QCH soubor, což vám umožní sestavit sbírku nápovědy. Qt Creator a qhelpgenerator jsou doporučené nástroje pro tento proces.