Question

我真的很难进入Sphinx教程阶梯的第一个阶段。

我需要为工作项目实施Sphinx。我们正在为一个大型项目开始新的代码库（Django）。

我的任务是设置新的代码库（自动化单元测试，文档等）。我过去使用过doxygen（主要用于C ++，有点用于Python）。我看过很多消息来源说Sphinx对Python来说是最好的，我想试一试。

问题在于我似乎无法完成本教程的第一步 - sphinx-quickstart。

我可以选项卡完成命令，因此我认为它已正确安装。（也许不是？）

这是我得到的错误：

  File "/usr/local/bin/sphinx-quickstart", line 5, in <module>
    from pkg_resources import load_entry_point
  File "/usr/lib/python2.6/dist-packages/pkg_resources.py", line 2655, in <module>
    working_set.require(__requires__)
  File "/usr/lib/python2.6/dist-packages/pkg_resources.py", line 648, in require
    needed = self.resolve(parse_requirements(requirements))
  File "/usr/lib/python2.6/dist-packages/pkg_resources.py", line 546, in resolve
    raise DistributionNotFound(req)
  pkg_resources.DistributionNotFound: docutils>=0.7

我试图找到一些与此问题相关的在线信息，但我找不到任何有用的信息。

有什么建议吗？

Answer 1

您似乎缺少doctils，或者您的版本较旧;

pkg_resources。 DistributionNotFound：docutils＆gt; = 0.7

你确定已经安装了吗？

Answer 2

尝试：

pip install --force-reinstall sphinx

看起来Sphinx软件包没有正确安装，或者更正确的是，它的依赖项目前尚未安装。如果您没有超级用户权限，请找管理员安装或使用virtualenv。

我强烈建议尽可能使用 virtualenv ，因为它不会触及/usr/local或任何Python .../site-packages目录中的内容。我会警告你，它很容易让人上瘾： - ）

sphinx-quickstart失败了

2 个答案: