python - sphinx - 如何更改文档样式表

标签 python qt qt4 python-sphinx qt-assistant

我使用 sphinx 生成了 Python 文档,以便在 Qt Assistant 上查看它,但是 Python 开发人员为其文档使用的主题在 Qt Assistant 上似乎存在一些问题,有没有办法在生成之前覆盖/更改主题文档?

enter image description here

谢谢!

P.S.:我遵循了这里的一些指示http://docs.python.org/devguide/documenting.html#using-make-make-bat但我没有执行 make html ,而是执行了 sphinx-build -b qthelp 。 build/qthelp 和更高版本的 qcollectiongenerator-qt4 build/qthelp/Python.qhcp。我使用的是 sphinx 1.1.3。

最佳答案

Sphinx 中的主题很容易完成。只需在 Sphinx 包目录中找到您想要修改的主题,或者从 Internet 上的各种主题中选择一些主题即可。您需要做的是将主题放入某个文件夹(例如_themes)并将该文件夹添加到您的conf.py中。默认情况下,您的 conf.py 中应该有一行主题路径。现在,在 html_theme 下的 conf.py 中使用您的主题名称。

应该可以解决问题。

大多数标准主题都基于basic主题并继承其大部分类。您可以考虑使用此主题作为沙箱,因为它明确包含大多数内容,而没有继承困惑。

我也忍不住注意到你的自定义构建器。自定义构建器也可能是这里的问题。 Sphinx 中的 HTML 主题最适合与现有的 HTML 生成器配合使用。然而,基本主题可能会更适合您的工作流程,因为它去掉了视觉效果。

关于python - sphinx - 如何更改文档样式表,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/22539198/

相关文章:

python - 为什么 Python 的 Hog 输出 (scikit-image) 与 MATLAB 的 Hog (vlfeat) 不同?

jQuery 自动完成和 Flask

qt - 使用 Qt 的 QProcess 作为 popen(使用 ffmpeg rawvideo)

python - 如何防止 Qt 按钮出现在单独的框架中?

c++ - 使用 QtGStreamer 检索视频大小返回零

python - Selenium 随机超时异常没有任何消息

python - 通过脚本在结构中设置 IDA 函数指针

c++ - 将 Objective-C 代码转换为 C++ 以检测 OS X 上的用户空闲时间

qt - 在 Qt5 测试版中使用 QtWebKit

qt - Qt4中QTextDocument单页表格和图片