readthedocs 中自动生成的索引文件

Question

我无法将我为我的项目准备的文档上传到 readthedocs，我正在尝试了解问题所在。该文档在本地使用 make html 构建良好，但我无法上传它。

GitHub 项目是 ASCIIGenome and the documentation is in the docs/ 目录（现在可能需要更多 readme.rst 和 index.rst 文件）。

所以我登录到 readthedocs 并按照他们的说明进行操作：

dashboard -> import a project -> Choose: https://github.com/dariober/ASCIIGenome.git

然后对于 ASCIIGenome 项目我设置：

姓名：ASCIIGenome
存储库URL：https://github.com/dariober/ASCIIGenome.git
存储库类型：Git

然后 "build" -> 构建完成（通过）。

但是一旦我在 http://asciigenome.readthedocs.io/en/latest/ 访问文档，我就会看到以下页面：

Welcome to Read the Docs
This is an autogenerated index file.

Please create a /home/docs/checkouts/readthedocs.org/user_builds/asciigenome/checkouts/latest/index.rst 

or /home/docs/checkouts/readthedocs.org/user_builds/asciigenome/checkouts/latest/README.rst file with your own content.

If you want to use another markup, choose a different builder in your settings.

如果我按照该页面顶部的 "Edit on GitHub" link，我会转到 https://github.com/dariober/ASCIIGenome/blob//trunk//index.rst，在那里我发现了 404 错误。

如果重要的话，我使用 SVN 与 github 交互。

你能看出我的项目设置有什么问题吗？

谢谢！

Answer 1

看来我只是不耐烦，一切都很好。即使构建被标记为 "passed".

，文档也需要一点时间（~1/2 小时？）才能上线

readthedocs 中自动生成的索引文件

Autogenerated index file in readthedocs

svn

github

read-the-docs