制作 sphinx_rtd_theme 的自定义命名分支后 SphinxRtdTheme 未定义

Question

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

但是，当使用自定义主题构建文档时，collapse_navigation 主题选项不受尊重。但是，html_theme_options 中的其他元素受到尊重。如果我使用 sphinx_rtd_theme 而不是我的自定义主题， collapse_navigation 就会受到尊重。

在 Web 控制台中，我看到

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 个（人类可读的）引用已经更改为使用我的自定义名称，所以我不清楚 SphinxRtdTheme 此时存在于我的主题中。

我已经清理了 /my_custom_theme/static/ 文件夹以强制重建任何 Javascript，但无济于事。

我也尝试将我的 SphinxCustomRtdTheme 条目重命名回 SphinxRtdTheme，但错误没有任何变化。

理想情况下，此错误不会存在，然后（也是理想情况下）collapse_navigation 将在我的主题中得到适当尊重。

Answer 1

事实证明，我的主题被内置到一个单独的版本 (dev0) 中，而不是我的预期，因此它永远停留在以前的版本上。将所有内容更新到当前版本可消除错误。

制作 sphinx_rtd_theme 的自定义命名分支后 SphinxRtdTheme 未定义

SphinxRtdTheme undefined after making custom-named fork of sphinx_rtd_theme

python-sphinx

read-the-docs