斯芬克斯的OS X安裝：找不到'sphinx-build'和'sphinx-quickstart'

Question

在這個主題上有幾個'未回答'的帖子，關於發現'sphinx-build'無法找到： sphinx-build -h command not found in Mac OS

獅身人面像同時使用在OSX安裝：

• python3 -m pip install sphinx
• brew install sphinx

無論如何，都找不到命令sphinx-build和sphinx-quickstart。

即使python3 -m pip freeze顯示安裝：

Sphinx==1.3.6 

我缺少什麼？

Thx

Answer 1

在OS X El Capitan上安裝sphinx後，我遇到了類似的問題。我使用pip安裝了獅身人面像：pip install sphinx --user。儘管~/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

繼@Dan Murphy

我安裝的Python 3.4的建議是從根本。修改~/.bash_profile如下：

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

Answer 3

如果使用自制安裝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配置文件，然後重新啓動終端。

Answer 4

對於自制，這些工具似乎在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似乎對我無害。