在 Sphinx 上实现自定义主题

Implementing a custom theme on Sphinx

我正在尝试在本地为 sphinx 实现我自己的自定义主题。我将 运行 保留在这个错误中: no theme named 'custom_theme' found (missing theme.conf?)。 我的 custom_theme/ 目录中有一个 theme.conf。看起来像:

[theme]
inherit = basic
stylesheet = styles/site.min.css

在我的 conf.py 中,我有以下相关设置:

html_theme = 'custom_theme'
html_theme_path = ["."]

作为参考,我一直在尝试在这个主题的回购 https://github.com/snide/sphinx_rtd_theme 上复制设置。使用 grunt 来构建我的样式等。但仍然出现该错误。我希望有人找到了一些关于如何创建自己的 sphinx 主题和模板的详细文档。谢谢。

我最终只是覆盖了所有内容并将我的主题放入 source/

我相信你想在 /usr/share/sphinx/themes 中删除主题。