我的第一个公共Python项目现在在readthedocs (RTD)上。有一个问题我正在努力解决,但到目前为止还没有成功。
我使用:async:
选项标记协同线。这是由狮身人面像2.1+支持的。RTD在我的项目中使用了斯芬克斯1.8.5。所有的协同线都从HTML输出中跳过,即根本没有文档记录。这太糟糕了。
我在包含:sphinx>=2.1.0
的项目中创建了sphinx>=2.1.0
文件,并且在RTD >sphinx>=2.1.0
>高级设置中输入了:/docs/requirements.txt
作为“构建文档所需的pip需求文件。不知道这是否是专门制作狮身人面像的正确方法。总之我试过了。
构建失败:
ERROR: Could not open requirements file: [Errno 2] No such file or directory: '../../../../../../../../docs/requirements.txt'
我怎样才能克服这些问题,使所有的协同工作都有适当的记录?
发布于 2020-05-13 23:14:42
RTD找不到您的需求文件。删除前面的斜杠,尝试指定相对于项目根的路径,而不是绝对路径。
https://stackoverflow.com/questions/61773532
复制相似问题