Qt Assistant: Cannot open qhc file

[probonopd]

LANG=C assistant -collectionFile /home/user/Downloads/helloSystem.qhc

Error registering documentation file '/home/user/Downloads/helloSystem.qch': Cannot open documentation file /home/user/Downloads/helloSystem.qch.

cc @TheAssassin

[TheAssassin]

Could it be that the issue is that the file extension is .qhcp or .qhp, but not .qch?

[probonopd]

According to https://doc.qt.io/archives/qt-4.8/assistant-custom-help-viewer.html#creating-a-custom-help-collection-file,

The help collection file (.qhc) used by Qt Assistant is created when running the qcollectiongenerator tool on a help collection project file (.qhcp).

Which is what we are doing:

docs/buildDocs.sh

Line 43 in 56d42f0

qcollectiongenerator _build/qthelp/*.qhcp

[probonopd]

That file looks pretty empty/crippled:

cat /home/user/Downloads/helloSystem.qhc 
we''�e ftableSettingsTableSettingsTableCREATE TABLE SettingsTable (Key TEXT PRIMARY KEY, Value BLOB )9M'indexsqlite_autoindex_SettingsTable_1SettingsTabh##�tableFilterTableFilterTableCREATE TABLE FilterTable (NameId INTEGER, FilterAttributeId INTEGER )l++�tableFilterNameTableFilterNameTableCREATE TABLE FilterNameTable (Id INTEGER PRIMARY KEY, Name TEXT ){55�tableFilterAttributeTableFilterAttributeTableCREATE TABLE FilterAttributeTable (Id INTEGER PRIMARY KEY, Name TEXT )u##�1tableFolderTableFolderTableCREATE TABLE FolderTable (Id INTEGER PRIMARY KEY, NamespaceId INTEGER, Name TEXT )x))�+tableNamespaceTableNamespaceTableCREATE TABLE NamespaceTable (Id INTEGER PRIMARY KEY, Name TEXT, FilePath TE���helloSystem .hellosystemhelloSystem.qch
m��_�����m
          FullTextSearchFallback
%CreationTime_�r�       )       HideAddressBa-  EnableAddressBarA       EnableDocumentationManager▒;  HideFilterFunctionality?        EnableFilterFunctionality?)iLastShownPagesqthelp://org.sphinx.hellosystem/doc/index.html@+idefaultHomepageqthelp://org.sphinx.hellosystem/doc/index.html1#SWindowTitlehelloSystem pre-alpha documentation*-;LastRegisterTime2020-11-30T22:31:36.711

#G\4{����▒9FullTextSearchFallback
                                 %CreationTime
)HideAddressBar -EnableAddressBaAEnableDocumentationManagerHideFilterFunctionality?EnableFilterFunctionality)LastShownPages+defaultHomepage#WindowTitle-   LastRegisterTime%  

[TheAssassin]

It's obviously an SQLite database.

[probonopd]

...with not much in it!

[TheAssassin]

Indeed. But I have never worked with this Qt help stuff before. Perhaps you should ask @azubieta or @antony-jr?

[probonopd]

Possibly (just taking a wild guess here) the broken TOC in the EPUB and the empty qrc are somehow related.

[antony-jr]

Just for the info, I've never used Qt help since I never needed it in the first place. So I think I'm at the same level as a non-Qt programmer in this area.