可以在没有链接存储库的情况下将 Sphinx 源文件推送到 ReadTheDocs 吗？答案

【问题标题】：Can Sphinx source files be pushed to ReadTheDocs without a linked repository?可以在没有链接存储库的情况下将 Sphinx 源文件推送到 ReadTheDocs 吗？
【发布时间】：2020-01-04 17:16:23
【问题描述】：

我正在将我的所有开源项目的 Mercurial 存储库从 Bitbucket 移至 OSDN (OSDN.net)，因为 Bitbucket 很快就会放弃对 Mercurial 的支持。但是，OSDN 仅支持 SSH，而不支持 HTTPS，作为文件交换协议，ReadTheDocs 不支持 SSH URL。 ReadTheDocs 公共 API 允许触发构建，但不支持以任何方式为源文件提供构建触发器。

或任何记录的方式，至少。有谁知道使用构建触发器将文档源文件推送到 RTD，或者将 OSDN 存储库连接到 RTD 以便 RTD 可以克隆源文件本身的方法？

谢谢。

【问题讨论】：

标签： read-the-docs

【解决方案1】：

OSDN 确实支持 SSH 和 HTTP(S)，对于“写入”，唯一的选择是 ssh。但是，阅读文档只需要“阅读”； https 很好（并且支持，虽然有点难找）。

在 OSDN 上，切换 “RO|r/w”按钮，以查看其他 URL。它不是按钮，也不是触发器；但它看起来像 --UX/UI 设计不是很好......

复制该 RO 值（再次：忽略 UI 反馈。您可以复制 https-URL。并将其粘贴到 RTfD 上。

注意：目前，我可以让 webhooks/integration 正常工作。因此，在推动之后，您必须阅读文档才能重建。或者使用本地 Makefile 中的 curl webhook，请参阅：https://docs.readthedocs.io/en/stable/webhooks.html#parameters

【讨论】：

非常感谢。这很容易——但并不明显。