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

OS X install of Sphinx: The 'sphinx-build' and 'sphinx-quickstart' not found

有几个 'unanswered' 帖子与此主题有关,发现 'sphinx-build' 无法找到: sphinx-build -h command not found in Mac OS

Sphinx 是在 OSX 上安装的,同时使用:

无论哪种情况,都找不到命令 sphinx-buildsphinx-quickstart

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

Sphinx==1.3.6

我错过了什么?

谢谢

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

采纳@Dan Murphy

的建议

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

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

如果您使用 homebrew 安装 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 配置文件并重新启动您的终端。

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

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

为了向 reader 全面披露,我将包括在未使用 --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 中对我来说似乎无害。