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 上安装的,同时使用:
python3 -m pip install sphinx
brew install sphinx
无论哪种情况,都找不到命令 sphinx-build
和 sphinx-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"
解决了我的问题。
的建议
我安装的 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
中对我来说似乎无害。
有几个 'unanswered' 帖子与此主题有关,发现 '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
我错过了什么?
谢谢
我在 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"
解决了我的问题。
我安装的 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
中对我来说似乎无害。