在制作了sphinx_rtd_theme的自定义名称的分叉后,SphinxRtdTheme未定义

时间:2019-04-09 22:12:45

标签: python-sphinx read-the-docs

我正在研究一个主题,它是sphinx_rtd_theme的分支。我重命名了主题,以使使用主题的人不必担心会覆盖他们通常的sphinx_rtd_theme

但是,在使用自定义主题构建文档时,不考虑collapse_navigation主题选项。但是,请注意html_theme_options中的其他元素。如果我使用collapse_navigation而不是自定义主题,则会尊重sphinx_rtd_theme

在网络控制台中,我看到

jQuery.Deferred exception: SphinxRtdTheme is not defined @http://localhost:1919/:522:11
j@http://localhost:1919/_static/jquery.js:2:29997
g/</k<@http://localhost:1919/_static/jquery.js:2:30313
 undefined

ReferenceError: SphinxRtdTheme is not defined[Learn More] localhost:1919:522:11
<anonymous> http://localhost:1919/:522
    jQuery 2

这很有道理-我确实重命名了主题,并且我相信现在这些引用应该是SphinxCustomRtdTheme。除了...

核心主题(https://github.com/rtfd/sphinx_rtd_theme/search?q=SphinxRtdTheme&unscoped_q=SphinxRtdTheme)中对SphinxRtdTheme的仅有2个(人类可读的)引用已被更改为使用我的自定义名称,因此我不清楚{{1}在哪里}目前已存在于我的主题中。

我已经清理了SphinxRtdTheme文件夹,以强制重建任何Javascript,但无济于事。

我还尝试将我的/my_custom_theme/static/项重命名回SphinxCustomRtdTheme,但是错误没有改变。

理想情况下,此错误将不存在,然后(理想情况下)SphinxRtdTheme将被视为我的主题。

1 个答案:

答案 0 :(得分:0)

事实证明,我的主题已构建到比我预期的单独的版本(dev0)中,因此该主题永久停留在以前的版本上。将所有内容更新到当前版本可以消除错误。