请求配置：特定分支提交时自动触发Read the Docs文档构建

1. 检查Read the Docs的Webhook配置 #

• 登录Read the Docs进入项目设置，找到Integrations或Webhooks选项
• 确认已正确添加Codeberg仓库的Webhook，且触发事件包含push操作
• 若未配置Webhook，手动添加：在Codeberg仓库的设置->Webhooks中，填入Read the Docs提供的Webhook URL，勾选Push events

2. 验证Read the Docs的分支触发规则 #

• 进入Read the Docs项目的Versions设置页面
• 确认develop分支处于Active状态，且自动构建规则包含该分支
• 检查分支过滤规则，确保develop分支在允许触发构建的列表内

3. 检查自定义构建配置的兼容性 #

• 确认.readthedocs.yaml（或旧版readthedocs.yml）配置语法正确，尤其是build.command的设置
• 示例参考配置：

version: 2
build:
  command: pydoctor --make-html --html-output-dir=_build/html
formats:
  - htmlzip

• 无需Sphinx配置时，直接删除或注释相关配置项，避免格式错误中断构建流程

4. 查看Webhook触发日志 #

• 在Codeberg仓库的Webhooks页面，查看最近推送事件是否成功发送请求到Read the Docs
• 若有失败记录，根据错误提示排查问题（如网络异常、密钥不匹配）
• 在Read the Docs的Builds页面，检查是否存在被忽略的构建请求或错误日志

5. 确认Read the Docs的仓库访问权限 #

• 私有仓库需配置OAuth令牌，确保Read the Docs有权限访问仓库
• 公有仓库确认可见性设置未限制Read the Docs的访问

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