Převod souboru QCH do QHP

Porozumění formátům souborů QCH a QHP

QCH soubory jsou kompilované help soubory používané Qt Help Framework. Obsahují komprimovanou dokumentaci, včetně HTML stránek, obrázků a metadat, a jsou obvykle generovány ze souborů QHP. QHP soubory, nebo Qt Help Project soubory, jsou XML základy projektu, které popisují strukturu, obsah a metadata help kolekce před jejím zkompilováním do souboru QCH.

Proč převést QCH na QHP?

Převod QCH souboru zpět na QHP soubor není standardní nebo přímočarý proces, protože QCH je zkompilovaný formát a QHP je jeho zdroj. Nicméně může být potřeba extrahovat původní strukturu projektu nebo dokumentaci pro úpravy nebo aktualizace.

Jak převést QCH na QHP

Neexistuje přímý, oficiální nástroj pro převod QCH souborů zpět na QHP, ale můžete extrahovat obsah souboru QCH a ručně rekonstruovat projekt QHP. Proces zahrnuje:

1. Použití nástroje qhelpgenerator (součást Qt SDK) k extrahování obsahu souboru QCH.
2. Rekonstrukce souboru QHP vytvořením nového XML projektového souboru a odkazováním na extrahované HTML a resource soubory.

Doporučený software pro extrakci QCH

Nejlepší nástroj pro tento proces je sám Qt Help Framework, konkrétně utility qhelpgenerator a qcollectiongenerator. Pro extrakci obsahu:

• Použijte qhelpgenerator --unpack <yourfile.qch> <output_directory> pro extrahování dokumentačních souborů.
• Ručně vytvořte nový QHP soubor odkazováním na extrahované soubory a dle Qt Help Project XML schéma.

Shrnutí

Koexistuje možnost ručně extrahovat obsah souboru QCH pomocí nástrojů Qt a rekonstruovat projekt QHP. Tento proces je nejvhodnější pro uživatele obeznámené s dokumentačním systémem Qt.