我的第一个公共Python项目现在在readthedocs(RTD)上。我正在尝试解决一个问题,但到目前为止没有成功。
我正在使用:async:
选项标记协程。 sphinx 2.1+支持此功能。 RTD在我的项目中使用了狮身人面像1.8.5。只是从HTML输出中跳过了所有协程,即根本没有记录。太糟糕了。
我在包含docs/requirements.txt
和RTD>管理>高级设置的项目中创建了sphinx>=2.1.0
文件,我已经输入:/docs/requirements.txt
as “构建文档所需的点子要求文件。从根目录开始的路径您的项目。“。不知道这是指定狮身人面像版本的正确方法。无论如何,我尝试过。
构建失败:
ERROR: Could not open requirements file: [Errno 2] No such file or directory: '../../../../../../../../docs/requirements.txt'
我如何克服这些问题以正确记录所有协程?
RTD找不到您的需求文件。尝试通过删除前导斜线来指定项目根目录的路径[[relative,而不是绝对路径。