docs icon indicating copy to clipboard operation
docs copied to clipboard

Qt Assistant: Cannot open qhc file

Open probonopd opened this issue 5 years ago • 8 comments

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

probonopd avatar Nov 30 '20 22:11 probonopd

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

TheAssassin avatar Nov 30 '20 22:11 TheAssassin

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

probonopd avatar Nov 30 '20 22:11 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%  

probonopd avatar Nov 30 '20 22:11 probonopd

It's obviously an SQLite database.

TheAssassin avatar Nov 30 '20 23:11 TheAssassin

...with not much in it!

probonopd avatar Dec 01 '20 07:12 probonopd

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

TheAssassin avatar Dec 04 '20 20:12 TheAssassin

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

probonopd avatar Dec 05 '20 09:12 probonopd

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.

antony-jr avatar Dec 05 '20 13:12 antony-jr