主题更改、弃用和警告

一般来说，有关主题更改的最佳信息来源是发行变更日志。我们尽量避免在主题代码中引发警告，这意味着主题有时会发生变化（可能很大），而不会出现弃用警告或其他警报。尽管如此，我们偶尔会警告一些事情，例如（即将）更改主题的默认配置值。如果您希望不收到此类警告，有一个配置值可以抑制它们

conf.py

html_theme_options = {
    "surface_warnings": False
}