4

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

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

Sphinx 似乎像宣传的那样工作,但我想使用 NumPy 风格的文档,所以我想我会安装 numpydoc。万一这很重要,我使用的是 Python 3.3(windows 7 上的 winpython 64 位)。我从这里的指示开始,但得到了错误:

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

谷歌搜索,我发现有些人通过使用numpydoc.numpydoc 无骰子绕过它。我确保所有可能相关的内容都在我的路径中(以及添加到 sphinxconf.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 安装任何扩展。我基本上是随机选择 findanything。按要求安装它,但它也失败了,这一次是因为 relpath 错误 ( ValueError: path is on mount 'C:', start on mount 'D:')。我想这意味着我的 python 安装在 C 上是不高兴的,但我试图记录的代码(以及我试图运行 sphinx 的位置)在 D 上(并且我正在运行 Windows)。

那么,我是不是碰巧选择了 3 个有问题的扩展程序?或者,如果不是,我做错了什么以及(更重要的是)我怎样才能正确地做这件事才能让它工作?

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

4

0 回答 0