我在斯芬克斯自动生成的文档中遇到了一些小麻烦。我基本上和这里有相同的问题:Python狮身人面像自动文档和装饰成员
当我在函数上使用装饰符时,文档中显示的签名就是修饰器的签名。在上述线程的插入之后,我在我的装饰器定义中添加了@decorator装饰器,它确实解决了这个问题。
现在,我已经将我的项目连接到了ReadTheDoc.org上,它运行得很好,唯一的问题是,装潢师的问题又回到了重新修复的过程中。
我对狮身人面像( Sphinx )非常陌生,所以我不确定这是否值得在RTD Github项目上产生问题。我在这里能少些什么?看到一个破碎的签名这里
会不会是一种配置?我用Python3构建文档
此外,如果模块不可用,我已经定义了一个虚拟@decorator,如下所示:
try:
    from decorator import decorator
except ImportError:
    def decorator(f):
        return f发布于 2018-05-11 06:08:20
根据您的最近在RTD上构建日志,装潢工没有安装在RTD上。
必须将装饰器指定为包中的依赖项,或者将其添加到RTD需求文件requirements.txt中。
发布于 2018-05-10 01:21:22
您可以在RTD中添加一个requirements.txt文件,在该文件中,可以指定与本地文件完全相同的环境。
当然包括sphinx,因为RTD使用sphinx==1.6.5。那个版本可能和你的不一样。
https://stackoverflow.com/questions/50264021
复制相似问题