python - OS X 安装 Sphinx : The 'sphinx-build' and 'sphinx-quickstart' not found

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

对于自制软件，这些工具现在似乎在 sphinx-doc 中。并且默认情况下它不会放入您的 PATH 中，因为 sphinx-doc 是“仅限桶”。要安装它并将其放入 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 对我来说似乎无害。