Qt Assistant: Cannot open qhc file
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
Could it be that the issue is that the file extension is .qhcp or .qhp, but not .qch?
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:
https://github.com/helloSystem/docs/blob/56d42f09d67548e56d8d4a69891a26a9e60a001a/buildDocs.sh#L43
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%
It's obviously an SQLite database.
...with not much in it!
Indeed. But I have never worked with this Qt help stuff before. Perhaps you should ask @azubieta or @antony-jr?
Possibly (just taking a wild guess here) the broken TOC in the EPUB and the empty qrc are somehow related.
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.