我已关注guide。
$ pip install sphinx sphinx-autobuild
$ pip freeze | grep "sphinx"
sphinx-autobuild==0.6.0
sphinxcontrib-websupport==1.0.0
$ cd docs
$ sphinx-quickstart
$ make html
make html
出现以下错误:
/Library/Frameworks/Python.framework/Versions/2.7/Resources/Python.app/Contents/MacOS/Python: No module named sphinx
make: *** [help] Error 1
[问] 如何防止此错误发生?
感谢您宝贵的时间和帮助。
答案 0 :(得分:4)
我遇到了同样的问题,我认为分享我找到的解决方案可能会有所帮助。
打开 Makefile 文件,然后更改以下行:
SPHINXBUILD = python -msphinx
对此:
SPHINXBUILD = python3 -msphinx
答案 1 :(得分:2)
首先,不要在系统的Python中安装任何东西。使用虚拟环境或系统的用户安装来隔离系统Python中的软件包。 Python Packaging Authority提供了why virtual environments are a good idea™的解释。
我更喜欢首先在我的系统上安装另一个版本的Python,使用official installers for macOS(初学者)或pyenv(不是初学者)。除非绝对必须使用Python 2,否则请安装Python 3.x.
下一个install or upgrade your Python's packaging tools。这是我在Pythons中安装或升级软件包的极少数情况之一,尽管您可能希望为您的用户这样做。
下一页create and use a virtual environment。
最后按照correct guide to install Sphinx进入您的虚拟环境并开始使用Sphinx。