Sphinx扩展(numpydoc)

时间:2013-09-19 23:26:24

标签: python python-3.x numpy packages python-sphinx

注释后添加:我终于让numpydoc工作了。这也是一个python 2问题。我在它上面运行2to3,现在它似乎正在工作。

好的,我花了一整天时间试图让任何Sphinx扩展工作,现在我希望有人可以指出我做错了什么。 (对不起,这有点长,但也许更多信息可以帮助您快速找到我的方式错误。)

Sphinx似乎正如宣传的那样工作,但我想使用NumPy风格的文档,所以我想安装numpydoc。如果它很重要,我使用的是Python 3.3(Windows 7上的winpython 64位)。我从方向here开始,但得到了错误:

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

谷歌搜索我发现有些人使用numpydoc.numpydoc没有骰子绕过它。我确保所有可能相关的东西都在我的路径中(以及在sphinx' s conf.py文件中添加到sys.path中)。我甚至尝试将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我尝试用2to3转换它然后我得到一个递归太深的错误。

所以,我决定看看我是否能够为sphinx安装任何扩展。我基本上随意挑选一些东西。按要求安装它也会失败,这次是因为重新路径错误(ValueError: path is on mount 'C:', start on mount 'D:')。我想这意味着我的python安装在C上是不开心的,但是我试图记录的代码(以及我试图运行sphinx的地方)是在D上(而且我是...运行Windows)。

那么,我刚碰巧选择了3个有问题的扩展吗?或者,如果没有,我做错了什么(更重要的是)我怎么能做到这一点才能使我的工作正常进行?

PS我是Python的新手,所以请不要假设我没有做出令人难以置信的愚蠢和基本的错误。

0 个答案:

没有答案