1

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

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

有什么建议么？

4

2 回答 2

3

看起来您缺少 docutils，或者您的版本较旧；

包资源。DistributionNotFound: docutils>=0.7

确定安装了吗？

于 2012-04-25T19:49:25.757 回答
3

尝试：

pip install --force-reinstall sphinx

看起来 Sphinx 包没有正确安装，或者更准确地说，它的依赖项当前没有安装。如果您没有超级用户权限，请找管理员安装或使用virtualenv。

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

于 2012-04-25T19:55:08.020 回答