python-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 = ['.']

按照说明,我在.zip文件中有一个theme.conf文件以及其他所需的文件.不知道如何解决.

在我的theme.conf文件中,我有:

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

文件结构如下:文档>文档> _主题.在主题内部,我有一个“ tera”文件夹和一个“ tera.zip”文件.

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

解决方法:

我目前有同样的问题.我的问题是zip默认在zip文件中创建一个目录,因此theme.conf不在其根目录中.

$zip -r tera.zip tera/*

给出以下内容:

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

在这里我截断了无趣的输出(…).如果你这样做

$cd tera
$zip -r tera.zip *

配置文件将位于根目录,并且sphinx有效.

上一篇:如何在Python 2中使用reStructuredText记录多个返回值?


下一篇:如何用Java文档记录我的Java方法?