狮身人面像 - 自定义主题不起作用

Question

我设置了我的sphinx文档，并希望使用自定义主题。我已经阅读了sphinx网站上的主题说明：http://www.sphinx-doc.org/en/stable/theming.html，但它不起作用。

我的主题名称与conf.py文件中的主题名称相同，并且位于同一目录中的zip文件夹中，但我不断收到以下错误：

Theme error:
no theme named 'tera' found (missing theme.conf?)
make: *** [html] Error 2

我的conf.py代码是：

html_theme = "tera"

html_theme_options = {

}

html_theme_path = ['.']

根据说明，我在theme.conf文件中有一个.zip文件以及我需要的其他内容。不知道如何解决。

在我的theme.conf文件中，我有：

[theme] 
inherit = basic 
stylesheet = css/Terra.css 
pygments_style = default 

文件结构如下：Documents＆gt;文档＆gt; _themes。在主题内部，我有一个'tera'文件夹和'tera.zip'文件。

我也尝试过将tera.zip文件直接放在我的文档文件夹中，因此它与conf.py文件位于同一目录中但仍然没有运气

Answer 1

我目前遇到了同样的问题。我的问题是zip默认创建了zip文件中的目录，因此theme.conf不在其根目录中。

否则

$ zip -r tera.zip tera/*

给出以下内容：

$ less tera.zip
... Name
... ----
... tera/theme.conf

我截断了不感兴趣的输出（...）。但是，如果你这样做

$ cd tera
$ zip -r tera.zip *

配置文件将位于root用户并且sphinx正常工作。