ReadTheDocs刷新标签和版本

时间:2018-03-09 18:29:44

标签: github read-the-docs

因为我们已经完成了一些文档设置的重新安排,所以我有两个单独阅读我需要从同一个GitHub仓库构建的文档项目。其中一个是全新的,另一个曾经指向旧的回购。

我已经在每个项目上设置了一个webhook,并将这些webhook添加到了repo中。

问题在于,在过去指向旧存储库的项目中,稳定版本仍然与旧存储库中最新版本的SHA相关联,新存储库中不存在该版本。这会导致stable构建失败。

我希望解决的另一件事是,当激活一些新版本(以前存在于旧回购中)时," _a"然后添加到已发布的版本名称,即使没有多个具有相同名称的可发布版本。

我想知道:是否可以完全刷新所有RTD检测到的版本和标签?我认为这样做可以解决这两个问题。

我已经尝试过"擦拭"虽然构建但没有帮助,但我已多次阅读版本上的RTD文档,并且我已经从github触发了新的推送事件(已成功发送和接收)但仍无法生成任何进展。

2 个答案:

答案 0 :(得分:0)

解决这个问题的最佳方法是重新创建RTD项目。如果其他人遇到此问题,您可以查看我在RTD回购https://github.com/rtfd/readthedocs.org/issues/3763上制作的门票。

答案 1 :(得分:0)

我不知道"正确"这样做的方法,但我发现这有效:

  • 在管理员下,使项目的git repo URL无效(我将.git更改为.gitX)并保存
  • 等待构建失败,因为它无法克隆存储库。
  • 将git repo URL更改回正确的URL并保存。

"最新"然后,build将重新运行,克隆主repo,此时将刷新完整的Versions列表。

(我假设将提交推送到"最新"分支并让网络钩子触发器也可以工作,但对于一个受欢迎的项目,这并不总是一个选项。)