Readthedocs 尝试使用 sphinx 构建 mkdocs 项目

Question

我是第一次创建一个 python 包，在将我的文档上传到 readthedocs 时遇到了很多麻烦。我正在使用 mkdocs 来创建我的文档。当我运行mkdocs serve 命令时，我的文档会按照我想要的方式加载。但是，当我尝试将我的项目与 readthedocs 同步时，遇到了很多麻烦。构建是“成功的”，但我认为它正在构建，就好像它是用 sphinx 创建的（参见构建的屏幕截图）。我做了以下事情：

• 根据 mkdocs readthedocs 教程包含一个 .readthedocs.yml 文件
• 包含一个有效的 mkdocs.yml 文件
• 在高级设置中将文档类型设置为“Mkdocs”

我想不出会发生这种情况的其他原因。如果您有任何想法，请告诉我。谢谢！

Readthedocs Build Screenshot

Answer 1

如果您知道构建正在运行并通过，您可能只需要删除缓存。