Why is my html rendering messed up in Qt Assistant?

Question

I have written a documentation using Sphinx, and as the software is written in Qt, I have tried the qthelp Sphinx output engine. The Sphinx installation is brand new and nothing was customized, and I tried with the simple Sphinx project from the documentation "First Steps with Sphinx".

The resulting html displays nicely in firefox, with the default Sphinx skin.

Then I compile this to .qhc using qcollectiongenerator.exe (under windows) and load it with Qt Assistant.

The document contents are there, but the rendering is ugly. For instance, the whole document has a dark blue background, whereas firefox only applies this color to the title bars.

Is the Qt HTML renderer fully incompliant? Is there a way to tell Sphinx to generate Qt friendly HTML styling?

Thanks!

Answer 1

I'm having quite the same problems like you and I'm very unsatisfied with the produced output.

After some investigations I found out, that our Qt-5.5 Assistant works properly, whereas the Qt-5.10.0 Assistant was broken.

Opening the About-Dialog revealed the important difference between these two versions.

The Qt 5.10.0 Assistant was compiled with QTextBrowser in order to display the contents of the help file. It seems, that QTextBrowser lacks the ability to display CSS content, which destroys the layout of the help file.