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

Question

有关发现'sphinx-build'无法找到的关于此主题的几个"未答复"帖子:在Mac OS中找不到 sphinx-build -h命令

Sphinx在OSX上使用以下两种方式安装:

• python3 -m pip install sphinx
• brew install sphinx

在任一情况下,这两个命令sphinx-build和sphinx-quickstart无法找到.

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

Sphinx==1.3.6

我错过了什么？

谢谢

Answer 1

对于自制软件来说,这些工具似乎在sphinx-doc如今.并且它不是默认放入你的PATH任何一个因为sphinx-doc是"keg-only".要安装并进入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是只小桶,但只是sphinx-{quickstart,apidoc,autogen,build}在PATH似乎是无害的给我.

Answer 2

在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"解决我的问题.