Sphinx make文件可能使用了错误的docutils文件

Question

我正在关注this教程，了解如何开始使用sphinx Python文档。

在我的Mac上，我运行make命令

$ make html

（按照视频中09:25分钟的指示），但是我收到了错误消息

Exception occurred:
  File "/Users/me/anaconda/lib/python2.7/site-packages/docutils/writers/html4css1/__init__.py", line 21, in <module>
    from docutils.writers import _html_base
ImportError: cannot import name _html_base

从该错误看来，make文件使用的是Mac随附的docutils的旧python 2.7版本。我相信make文件应该使用此处的docutils的较新版本

/Users/me/anaconda/pkgs/sphinx-1.6.3-py36hcd1b3e7_0/lib/python3.6/site-packages/sphinx/utils/docutils.py

此文件未导入包_html_base，这似乎是docutils文件的python 2.7版本的问题。

我如何“指向make文件以使用python 3.6 docutils”？如果这个问题有意义。还是有更好的方法来解决此问题？

Answer 1

问题是您通过命令pip install -U sphinx安装了sphinx，其中pip指向Mac的Python2.7

为了克服这个问题，您需要pip3 install -U sphinx（如果有可用的Python3.x）。