如何在默认 sphinx 主题上使用自定义 CSS？

Question

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

我想使用topic 指令在重要信息周围放置一个框，但agogo 的CSS 在其默认CSS 中没有边框。我有 CSS 来创建创建的边框，但是如何包含/覆盖 agogo 的旧版本 topic 以使用我的版本。

我希望能够在不每次手动更改 CSS 的情况下生成文档。我研究了一些关于在 Sphinx 中使用自定义 CSS，但似乎没有提到覆盖现有类。

Answer 1

我们（以前）在这里：

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

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

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