Read the Docs平台cookie查询处理及GDPR合规cookie横幅实现咨询

Read the Docs平台cookie查询处理逻辑 #

Read the Docs平台默认仅加载维持站点基础运行的必要功能性cookie，用于支撑访问会话保持、登录状态校验、文档版本切换这类核心功能，这类必要cookie符合合规要求不需要用户授权即可启用。如果站点维护者自行接入Google Analytics这类非必要统计工具，平台不会主动拦截对应cookie的加载，也不会默认提供cookie同意校验逻辑，所有非必要cookie的触发规则、用户授权校验逻辑都需要站点维护者自行实现，平台仅提供自定义代码注入的基础能力支持。

Sphinx+reST构建的RTD站点是否支持合规cookie横幅 #

完全支持。Sphinx本身支持自定义模板注入、静态资源引入、第三方扩展加载，和reST语法编写的文档内容完全不冲突，你可以在不修改原有文档内容的前提下，单独配置cookie横幅相关逻辑，完全可以满足GDPR/DSVGO的合规要求。

可使用的部署方案 #

• 直接使用Sphinx专用扩展：可以选用sphinxcontrib-cookiebanner扩展，支持直接在项目的conf.py配置文件中自定义横幅文案、同意/拒绝按钮触发逻辑、非必要脚本的加载规则，会自动匹配用户的授权选择后再加载GA这类统计脚本，适配绝大多数主流Sphinx主题。
• 自定义代码注入：如果现有扩展不符合你的个性化需求，可以直接在Sphinx的conf.py中通过html_js_files参数引入自行编写的cookie同意逻辑脚本，同时通过html_css_files参数引入横幅样式，也可以直接修改所用Sphinx主题的base.html模板，嵌入自定义的横幅代码和GA的条件加载逻辑。

注意所有非必要统计类脚本都需要设置为默认不加载，只有用户主动同意后才触发加载，避免出现合规风险。 #

内容的提问来源于stack exchange，提问作者Brockoli472