sphinx - 如何更改文档样式表

Question

我使用sphinx生成Python文档以在Qt助手上查看它，但是Python开发人员用于他们的文档的主题似乎在Qt助手上有一些问题，有没有办法在生成之前覆盖/更改主题文档？

谢谢！

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。

Answer 1

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

应该这样做。

大多数标准主题都基于basic主题，并继承了大部分类。您可以考虑将此主题用作沙箱，因为它明确包含大多数内容，而不会遗传。

此外，我无法注意到您的自定义构建器。自定义构建器也可能是这里的问题。 Sphinx中的HTML主题最适合库存HTML构建器。然而，基本主题可能会更好地适用于您的工作流程，因为它被剥离了眼睛糖果。

Answer 2

这是Python文档中的一个错误，现已修复:)请参阅http://hg.python.org/cpython/rev/2a6c33592e40和http://hg.python.org/cpython/rev/d6831d94dd1e