Konwertuj QCH na QHP

Zrozumienie formatów plików QCH i QHP

Pliki QCH to skompilowane pliki pomocy używane przez Qt Help Framework. Zawierają skompresowaną dokumentację, w tym strony HTML, obrazy i metadane, i są zazwyczaj generowane z plików QHP. Pliki QHP, czyli Qt Help Project, to oparte na XML pliki projektowe, które opisują strukturę, zawartość i metadane kolekcji pomocy przed jej skompilowaniem do pliku QCH.

Dlaczego konwertować QCH na QHP?

Konwersja pliku QCH z powrotem na QHP nie jest standardowym ani prostym procesem, ponieważ QCH to format skompilowany, a QHP to jego źródło. Jednakże może zajść potrzeba wyodrębnienia oryginalnej struktury projektu lub dokumentacji w celu edycji lub aktualizacji.

Jak konwertować QCH na QHP

Nie istnieje bezpośrednie, oficjalne narzędzie do konwersji plików QCH z powrotem na QHP, ale można wyodrębnić zawartość pliku QCH i ręcznie odtworzyć projekt QHP. Proces obejmuje:

1. Użycie narzędzia qhelpgenerator (część Qt SDK) do wyodrębnienia zawartości pliku QCH.
2. Odtworzenie pliku QHP poprzez utworzenie nowego pliku XML projektu i odwołanie się do wyodrębnionych plików HTML oraz zasobów.

Rekomendowane oprogramowanie do ekstrakcji QCH

Najlepszym narzędziem do tego procesu jest sam Qt Help Framework, a konkretnie narzędzia qhelpgenerator i qcollectiongenerator. Aby wyodrębnić zawartość:

• Użyj qhelpgenerator --unpack <yourfile.qch> <output_directory>, aby wyodrębnić pliki dokumentacji.
• Ręcznie utwórz nowy plik QHP, odwołując się do wyodrębnionych plików i stosując się do schematu XML Qt Help Project.

Podsumowanie

Chociaż nie ma zautomatyzowanego sposobu na konwersję QCH do QHP, można wyodrębnić zawartość pliku QCH za pomocą narzędzi Qt i ręcznie odtworzyć projekt QHP. Proces ten jest najlepiej dostosowany do użytkowników zaznajomionych z systemem dokumentacji Qt.