Skip to main content
 首页 » 编程设计

python之在 Sphinx 上实现自定义主题

2025年05月04日9虾米姐

我正在尝试在本地为 sphinx 实现我自己的自定义主题。我一直遇到这个错误: 未找到名为“custom_theme”的主题(缺少 theme.conf?)。 我的 custom_theme/ 目录中有一个 theme.conf。看起来像:

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

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

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

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

请您参考如下方法:

我相信你想把主题放在/usr/share/sphinx/themes 中。