readthedocs 关闭版本显示

自定义主题(高级)

若你使用自定义 Sphinx 主题,可通过 CSS 隐藏版本选择器:

在 docs/source/_static/custom.css 中添加:

.rst-versions {
    display: none !important;
}

并在 conf.py 中引入该 CSS:

html_static_path = ['_static']
html_css_files = ['custom.css']
此方法仅影响前端显示,版本仍存在于后台‌。

补充说明

  • 隐藏 ≠ 删除‌:隐藏版本后,文档仍可通过直接 URL 访问,且不会触发构建;若需彻底移除,需点击 ‌“Delete”‌(不可逆)‌。

  • ‌商业版支持更多控制‌:Read the Docs for Business 提供更细粒度的权限与版本控制,可参考 Pricing 页面。

如需进一步自动化管理版本,可使用 .readthedocs.yaml 配置文件定义构建规则