Konwertuj QCH na QHCP

Zrozumienie formatów plików QCH i QHCP

Pliki QCH to Qt Compressed Help, używane przez framework Qt do przechowywania skompilowanej dokumentacji w formacie skompresowanym. Pliki te są zazwyczaj generowane z projektów pomocy źródłowej i służą do systemów pomocy offline w aplikacjach Qt.

Pliki QHCP to Qt Help Collection Project. Są to pliki projektowe oparte na XML, które definiują strukturę i zawartość kolekcji pomocy Qt, w tym odwołania do plików QCH i innych zasobów. Pliki QHCP są używane jako dane wejściowe do Qt Help Collection Generator (qhelpgenerator) w celu wygenerowania pliku .qhc (Qt Help Collection).

Jak przekonwertować QCH na QHCP

Bezpośrednia konwersja z pliku QCH do pliku QHCP zazwyczaj nie jest wspierana, ponieważ QCH to format skompilowany, a QHCP to definicja projektu. Możesz jednak utworzyć plik QHCP, który odwołuje się do istniejącego pliku QCH, efektywnie integrując go w projekcie kolekcji pomocy.

Kroki tworzenia pliku QHCP z pliku QCH

1. Utwórz nowy plik XML z rozszerzeniem .qhcp.
2. Zdefiniuj strukturę, odwołując się do swojego pliku .qch w sekcji <docFiles>.
3. Przykładowa zawartość pliku QHCP:

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

Zamień your_help.qch na nazwę swojego pliku QCH.

Najlepsze oprogramowanie do pracy z plikami QCH i QHCP

• Qt Assistant: Do przeglądania plików QCH.
• Qt Creator: Do zarządzania projektami pomocy i edycji plików QHCP.
• Qt Help Collection Generator (qhelpgenerator): Do kompilacji plików QHCP do plików QHC. Użyj polecenia:
  qhelpgenerator your_project.qhcp -o output.qhc

Podsumowanie

Chociaż nie można bezpośrednio przekonwertować pliku QCH na plik QHCP, można utworzyć projekt QHCP, który odwołuje się do pliku QCH, co pozwala na zbudowanie kolekcji pomocy. Qt Creator i qhelpgenerator to zalecane narzędzia do tego procesu.