OS X安装Sphinx:' sphinx-build'和' sphinx-quickstart'未找到

时间:2016-03-21 17:10:26

标签: python macos python-sphinx

有几个未得到答复的'关于此主题的帖子有关发现&sphinx-build'无法找到: sphinx-build -h command not found in Mac OS

Sphinx使用两者安装在OSX上:

  • python3 -m pip install sphinx
  • brew install sphinx

在任何一种情况下,都找不到命令sphinx-buildsphinx-quickstart

即使python3 -m pip freeze显示安装:

Sphinx==1.3.6

我错过了什么?

THX

4 个答案:

答案 0 :(得分:18)

对于自制软件,这些工具现在似乎在sphinx-doc。并且默认情况下不会放在PATH中,因为sphinx-doc是“仅限keg”。要安装它并将其放入PATH,您可以执行以下操作:

brew install sphinx-doc
brew link sphinx-doc --force

为了完全向读者披露,我会在不使用--force时包含仅发生桶组的警告brew:

Warning: sphinx-doc is keg-only and must be linked with --force
Note that doing so can interfere with building software.

我不知道为什么sphinx-doc只是keg-only,但将sphinx-{quickstart,apidoc,autogen,build}放入PATH似乎对我无害。

答案 1 :(得分:10)

在OS X El Capitan上安装sphinx后,我遇到了类似的问题。我使用pip安装了sphinx:pip install sphinx --user。尽管sphinx-build中存在~/Library/Python/2.7/bin二进制文件,但找不到命令。

问题是我的路径设置为PATH="~/Library/Python/2.7/bin:$PATH"。将代字号~替换为$HOME,以便PATH="$HOME/Library/Python/2.7/bin:$PATH"为我解决问题。

答案 2 :(得分:1)

遵循@Dan Murphy

的建议

我的python 3.4的安装是根本的。修改后的~/.bash_profile如下:

export PATH="/Library/Frameworks/Python.framework/Versions/3.4/bin/:$PATH"

答案 3 :(得分:1)

如果您使用自制软件安装Python,则路径略有不同。以下是我希望解决此问题的一般方法

  • 运行python3 -c 'import sys; print("\n".join(sys.path))'并查找.../Python.framework/Versions/3.5/lib/...之类的行。

  • bin/将是lib/的兄弟姐妹。 bin/包含sphinx-quickstart和其他sphinx命令。

  • 对于osx上的自制软件安装python3,目录应为/usr/local/Cellar/python3/3.5.1/Frameworks/Python.framework/Versions/3.5/bin

  • export PATH=$PATH:.../Python.framework/Versions/3.5/bin放入您的bash配置文件中,然后重新启动终端。