2

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

在此处输入图像描述

谢谢!

PS:我从这里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。我使用狮身人面像 1.1.3。</p>

4

2 回答 2

1

这是 Python 文档中的一个错误,现已修复 :) 参见http://hg.python.org/cpython/rev/2a6c33592e40http://hg.python.org/cpython/rev/d6831d94dd1e

于 2014-03-31T19:09:38.690 回答
1

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

它应该可以解决问题。

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

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

于 2014-03-31T08:47:40.393 回答