sphinx-quickstart 失败答案

【问题标题】：sphinx-quickstart failssphinx-quickstart 失败
【发布时间】：2012-04-25 19:44:31
【问题描述】：

我真的很难到达 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

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

有什么建议吗？

【问题讨论】：

标签： python python-sphinx

【解决方案1】：

您好像缺少 docutils，或者您的版本较旧；

pkg_resources.DistributionNotFound: docutils>=0.7

你确定它已经安装了吗？

【讨论】：

看来你是对的。我安装了 docutils 并遇到了更多问题。我怀疑 D.Shawley 是正确的……Sphinx 没有正确安装。

【解决方案2】：

试试：

pip install --force-reinstall sphinx

Sphinx 包似乎没有正确安装，或者更准确地说，它的依赖项当前没有安装。如果你没有超级用户权限，那就找管理员安装或者改用virtualenv。

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

【讨论】：

感谢您的建议。我想我需要退后一步，确保我正确安装了 sphinx。