Skip to main content
 首页 » 编程设计

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

2024年11月01日9jillzhang

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

谢谢!

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 构建器一起使用。然而,基本主题可能更适合您的工作流程,因为它已经去掉了花哨的东西。