Sphinx的OS X安装：找不到“Sphinx生成”和“Sphinx快速启动”

Question

关于此主题，有几篇“未答复”的帖子涉及找不到“sphinx build”： sphinx-build -h command not found in Mac OS

Sphinx安装在OSX上，使用两种方法：

• python3 -m pip install sphinx
• brew install sphinx

无论哪种情况，都找不到命令sphinx-build和sphinx-quickstart。

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

Sphinx==1.3.6

我错过了什么？

泰铢

Answer 1

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

问题是我的路径设置为PATH="~/Library/Python/2.7/bin:$PATH"。用$HOME替换颚化符~，使其PATH="$HOME/Library/Python/2.7/bin:$PATH"为我解决了这个问题。

Answer 2

对于自制，现在的工具似乎都在sphinx-doc中。默认情况下，它也不会放在您的PATH中，因为sphinx-doc是“仅桶”。要安装它并将其放入PATH，可以执行以下操作：

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

为了向读者全面披露，我将在不使用--force时提供啤酒发出的警告：

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

我不知道为什么sphinx-doc只是小桶，但是把sphinx-{quickstart,apidoc,autogen,build}放入PATH对我来说似乎是无害的。

Answer 3

根据@Dan Murphy的建议

python 3.4的安装是在根目录下进行的。修改~/.bash_profile如下：

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