sphinx - 如何更改文档样式表

Posted 2023-02-14

【中文标题】sphinx - 如何更改文档样式表

【英文标题】：sphinx - how to change documentation style sheet

【发布时间】：2014-03-20 16:25:36

【问题描述】：

我用 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。我使用狮身人面像 1.1.3。

【问题讨论】：

你看过狮身人面像html theming support吗？

err...不，我没有。

【参考方案1】：

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

它应该可以解决问题。

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

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

【参考方案2】：

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