如何在readthedocs中使用myst_parser和sphynx？

Question

我可以在我的计算机上完全正确地构建文档，并打开HTML结果，它看起来很棒，但是当我按GitHub并读取文档试图构建它时，我得到了以下错误：

root file /home/docs/checkouts/readthedocs.org/user_builds/cry-vs-py/checkouts/latest/docs/index.rst not found

我的索引文件有.md扩展名，而不是.rst。我怎么能让读医生用它呢？再一次

我的我的GitHub回购，我的读物页

我需要能够使用.md而不是.rst，因为我真的不理解重构的文本。谢谢。

Answer 1

设置source_suffix在conf.py中的值以包括Markdown文件。

source_suffix = [
    ".md",
]

然后安装一个源解析器扩展，例如MyST。有关安装和配置的详细信息，请参阅解析器的文档。