html - 为什么我的 html 渲染在 Qt 助手中搞砸了？

Question

我使用 Sphinx 编写了一个文档，并且由于该软件是用 Qt 编写的，因此我尝试了 qthelp Sphinx 输出引擎。Sphinx 安装是全新的，没有进行任何定制，我尝试使用文档“First Steps with Sphinx”中的简单 Sphinx 项目。

生成的 html 在 Firefox 中很好地显示，并带有默认的 Sphinx 皮肤。

然后我使用 qcollectiongenerator.exe（在 Windows 下）将其编译为 .qhc 并使用 Qt Assistant 加载它。

文档内容在那里，但渲染很难看。例如，整个文档具有深蓝色背景，而 Firefox 仅将此颜色应用于标题栏。

Qt HTML 渲染器是否完全不兼容？有没有办法告诉 Sphinx 生成 Qt 友好的 HTML 样式？

谢谢！

Answer 1

我和你有同样的问题，我对产生的输出非常不满意。

经过一番调查，我发现我们的 Qt-5.5 助手工作正常，而 Qt-5.10.0 助手坏了。

打开 About-Dialog 揭示了这两个版本之间的重要区别。

编译 Qt 5.10.0 助手是QTextBrowser为了显示帮助文件的内容。看起来，它QTextBrowser缺乏显示 CSS 内容的能力，这破坏了帮助文件的布局。