如何在默认的 Sphinx 主题上使用自定义 CSS?

How to use custom CSS on a default Sphinx theme?

我正在使用 Sphinx 默认主题 agogo 在 Python 中创建文档。

我想使用 topic 指令在重要信息周围放置一个方框,但 agogo 的 CSS 默认没有边框 CSS。我有 CSS 来创建边框,但是我如何 include/override 旧版本的 agogo topic 来使用我的版本。

我希望能够生成文档而无需每次都手动更改 CSS。我研究了一些关于使用自定义 CSS 和 Sphinx 但似乎没有提到覆盖现有的 class.

我们(之前)开始:

  1. 在 Sphinx 项目的 _static 子目录中创建一个名为 custom.css 的文件。

  2. 在 custom.css 中,添加 @import 'agogo.css'; 和您自己的自定义 CSS 代码。

  3. html_style = 'custom.css' 添加到 conf.py (documentation)。