Python sphinx 如何修复旧版本上的读取文档生成失败

Python sphinx 如何修复旧版本上的读取文档生成失败,python-sphinx,read-the-docs,Python Sphinx,Read The Docs,我在GitHub上有一个项目,有一个主分支和多个标记版本。文档托管在Read Docs上。六个月前,我发布了版本0.7.0,文档构建成功。今天发布了0.8.0版之后,我意识到,对于那些还没有准备好升级的用户,公开0.7.0版的文档是个好主意。然而,当我试图从管理页面构建旧文档时,它们不再编译。旧conf.py包含mathjax sphinx扩展,这会导致构建失败。为6个月前的版本生成文档的正确方法是什么?是否要维护多个版本?我们这样做是为了金字塔,每个版本一个分支。至于构建失败,您需要提供更多信

我在GitHub上有一个项目,有一个主分支和多个标记版本。文档托管在Read Docs上。六个月前,我发布了版本0.7.0,文档构建成功。今天发布了0.8.0版之后,我意识到,对于那些还没有准备好升级的用户,公开0.7.0版的文档是个好主意。然而,当我试图从管理页面构建旧文档时,它们不再编译。旧conf.py包含mathjax sphinx扩展,这会导致构建失败。为6个月前的版本生成文档的正确方法是什么?

是否要维护多个版本?我们这样做是为了金字塔,每个版本一个分支。至于构建失败,您需要提供更多信息。链接到构建的错误日志和文档源文件的公共repo将是一个良好的开端。@Steve Piercy,RTD如何知道它应该为金字塔发布分支生成文档?看起来金字塔既有带标签的发布,也有发布分支。RTD将在何处查找与每个版本相关的文档文件尚不清楚。RTD将扫描您的回购协议中的分支,您可以将其用作版本。看看这个如何映射到这个。然后在项目的RTD
Admin>Versions
中,您可以使特定的分支处于“活动”状态。哦,RTD上的文档记录得不好(如果有的话):(