Read the Docs主题2.1.0版本中版本选择器的兼容性调整

Read the Docs作为主流的文档托管平台，其默认主题sphinx_rtd_theme在2.1.0版本迭代中引入了一项重要变更：对版本选择器显示逻辑的调整。这项变更与平台正在推进的"Addons"功能迁移计划密切相关。

在技术实现层面，2.1.0rc1版本的主题默认移除了传统的底部左侧版本选择器，这是平台向新交互模式过渡的阶段性设计。开发团队在后续的2.1.0rc2版本中通过引入flyout_display配置项提供了更灵活的显示控制方案。

对于使用者而言，需要注意以下关键点：

1. 当使用2.1.0rc1版本主题时，必须启用平台的Addons功能才能恢复版本选择器的显示。这是因为新版将版本控制功能逐步迁移至Addons体系。

2. 2.1.0rc2版本通过新增的flyout_display配置参数解决了双重显示问题。该参数支持以下模式：

   • hidden：默认值，隐藏主题内置的版本选择器
   • visible：显示主题内置版本选择器
   • addons-only：仅显示Addons提供的版本选择器

3. 对于需要保持原有交互体验的项目，建议采用2.0.0稳定版主题，或升级至2.1.0rc2版本后明确配置显示偏好。

这项变更反映了Read the Docs平台架构演进的趋势，将核心功能逐步模块化为可插拔的Addons组件。开发者在版本升级时应当注意测试版本选择功能的兼容性，特别是对于需要多版本维护的技术文档项目。平台方推荐用户及时升级到包含完整配置选项的2.1.0rc2版本，以获得最佳的可控性和兼容性保障。