I intend to create a customized Qt Assistant for providing help in my own application.
I followed the Qt documentation on that topic. The table of contents and all keywords are available when I launch the assistant, but my content is not shown.
Can anyone spot what I am doing wrong in this stripped down version?
test.qhp:
<?xml version="1.0" encoding="UTF-8"?>
<QtHelpProject version="1.0">
<namespace>test</namespace>
<virtualFolder>doc</virtualFolder>
<filterSection>
<toc>
<section title="test" ref="index.html">
</section>
</toc>
<keywords>
<keyword name="Test" ref="index.html"/>
</keywords>
<files>
<file>index.html</file>
</files>
</filterSection>
</QtHelpProject>
<?xml version="1.0" encoding="UTF-8"?>
<QtHelpProject version="1.0">
<namespace>test</namespace>
<virtualFolder>doc</virtualFolder>
<filterSection>
<toc>
<section title="test" ref="index.html">
</section>
</toc>
<keywords>
<keyword name="Test" ref="index.html"/>
</keywords>
<files>
<file>index.html</file>
</files>
</filterSection>
</QtHelpProject>
To copy to clipboard, switch view to plain text mode
test.qhcp
<?xml version="1.0" encoding="UTF-8"?>
<QHelpCollectionProject version="1.0">
<assistant>
<title>test</title>
<
!-- <applicationIcon>images
/handbook.
png<
/applicationIcon>
-->
<cacheDirectory>test/doc</cacheDirectory>
<startPage>qthelp://test/doc/index.html</startPage>
<aboutMenuText>
<text>About test</text>
</aboutMenuText>
<enableDocumentationManager>false</enableDocumentationManager>
<enableAddressBar>false</enableAddressBar>
<enableFilterFunctionality>false</enableFilterFunctionality>
</assistant>
<docFiles>
<generate>
<file>
<input>test.qhp</input>
<output>test.qch</output>
</file>
</generate>
<register>
<file>test.qch</file>
</register>
</docFiles>
</QHelpCollectionProject>
<?xml version="1.0" encoding="UTF-8"?>
<QHelpCollectionProject version="1.0">
<assistant>
<title>test</title>
<!-- <applicationIcon>images/handbook.png</applicationIcon> -->
<cacheDirectory>test/doc</cacheDirectory>
<startPage>qthelp://test/doc/index.html</startPage>
<aboutMenuText>
<text>About test</text>
</aboutMenuText>
<enableDocumentationManager>false</enableDocumentationManager>
<enableAddressBar>false</enableAddressBar>
<enableFilterFunctionality>false</enableFilterFunctionality>
</assistant>
<docFiles>
<generate>
<file>
<input>test.qhp</input>
<output>test.qch</output>
</file>
</generate>
<register>
<file>test.qch</file>
</register>
</docFiles>
</QHelpCollectionProject>
To copy to clipboard, switch view to plain text mode
index.html:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
<html>
<head>
<title>Test title</title>
</head>
<body>
<h1>index</h1>
This is the index page
</body>
</html>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
<html>
<head>
<title>Test title</title>
</head>
<body>
<h1>index</h1>
This is the index page
</body>
</html>
To copy to clipboard, switch view to plain text mode
I create the qhc file using
qcollectiongenerator test.qhcp -o test.qhc
qcollectiongenerator test.qhcp -o test.qhc
To copy to clipboard, switch view to plain text mode
When I open the assistant using
assistant -collectionFile test.qhc
assistant -collectionFile test.qhc
To copy to clipboard, switch view to plain text mode
I only see a blank page, instead of index.html's content.
Thanks a lot for any help in advance
Edit:
Ok, I resolved the problem myself.
It is caused by a bug in Qt Assistant, which causes small html pages (<512 bytes) not to be rendered
Re: [resolved] Content in customized Qt Assistant not shown
Reply With Quote
Bookmarks