冒着被告知我没有对此进行足够的研究的风险(我已经在这方面做了一个星期了),我无法让autoclass特性在sphinx中工作。我得到一系列导入错误。我已经将sys.path.insert(0,os.path.abspath('.'))
sys.path.insert(0, os.path.abspath('..'))
都添加到了conf.py
文件中,所以这不应该是原因,因为我也尝试了一大堆其他文件。在
我在这里做了一个小例子回购:GitHub
但jist是这样的:
在该结构的回购中:
funniest
funniest
__init__.py
text.py
text2.py
doc
source
index.rst
text.rst
text2.rst
其中text.py
和text2.py
包含如下简单类:
而text.rst
是:
Sad
===
Sad story
.. autoclass:: text.Sad
:members:
我不明白为什么它不起作用。显然,我遗漏了一些东西,但我发现sphinx doc(对于文档包来说是讽刺的)对于那些超出琐碎、也不是超级复杂的例子来说确实很难理解。在
如能提供任何关于问题所在的帮助,我们将不胜感激。在
首先,始终粘贴错误堆栈,以减少回答者的工作量,如下所示:
警告准确地说明了问题所在。第一个:
^{pr2}$…表示在
text.rst
中,第6行的导入不正确。所以改变这个:为此:
第二个警告:
…说
text2.rst
不能“导入类'笑话'”,并继续。。。在…这意味着在
text2.py
中,Python解释器希望在第10行的方法定义之后有更多的缩进。所以缩进方法的return
语句。在一旦你纠正了这两个错误,你就应该表现得很好了。在
额外提示1:使用代码编辑器检查Python语法是否存在简单错误。我喜欢PyCharm。它用各种红黄旗标记你的代码。在
额外提示2:您的
__init__.py
中不需要任何import语句。它可以是空白的。在相关问题 更多 >
编程相关推荐