狮身人面像扩展(numpydoc)

Question

注意:我终于让numpydoc工作了。这也是python 2的一个问题。我对它进行了2到3次测试，现在它似乎正在工作。

好的，我花了整整一天的时间尝试让任何斯芬克斯扩展工作，现在我希望有人能指出我做错了什么。(对不起，这有点长，但是也许更多的信息会帮助你快速发现我的错误)。

狮身人面像广告中那样工作，但我想使用NumPy风格的文档，所以我想安装numpydoc。如果重要的话，我使用Python3.3( windows 7上的winpython 64位)。我从这里的方向开始，但得到了错误：

Extension error:
Could not import extension numpydoc (exception: cannot import name setup)

我在谷歌上发现，有些人是通过使用numpydoc.numpydoc No dice来绕过它的。我确保所有可能相关的东西都在我的路径中(以及添加到sys.path中的conf.py文件中)。我甚至尝试将numpydoc复制到sphinx的ext文件夹中，并相应地更改扩展字符串，仍然没有成功。

在这一点上，我放弃了numpdoc，并决定尝试拿破仑。按照安装指南，我只需使用pip install sphinxcontrib-napoleon，然后就可以了。但是，唉，不是，因为拿破仑似乎在2.x而不是3(虽然蛋上写着Sphinx-1.1.3-py3.3.egg-info，在安装过程中它说它正在安装sphinxcontrib_napoleon-0.2.1-py3.3-nspkg.pth。)很多python 2代码。我尝试用2到3来转换它，但是后来我得到了一个太深的递归错误。

所以，我决定看看我是否有能力安装斯芬克斯的任何扩展。我基本上是随便挑出任何东西。根据请求安装它，它也会失败，这一次是因为重新路径错误(ValueError: path is on mount 'C:', start on mount 'D:')。我猜这意味着我的python安装在C上是不愉快的，但是我试图记录的代码(我试图运行sphinx的地方)是D(而且我运行的是Windows)。

那么，我只是碰巧选择了3个麻烦的扩展吗？或者，如果没有，我做错了什么？(更重要的是)我如何才能正确地做到这一点？

PS，我对Python完全陌生，所以请不要假设我没有犯一个非常愚蠢和基本的错误。

Answer 1

然而，旧线..。

如果您正在使用Ubuntu 20+，请不要通过pip安装numpydoc。使用

apt install python3-numpydoc

而不是。许多狮身人面像的软件包都需要以这种方式安装。