Sphinx-quickstart doesn't work

问题

I am trying to install sphinx on a remote machine.

Since I don't have an access to the root, I did this:

$bash

$mkdir -p ~/local/lib/python2.7/site-packages

$export PYTHONPATH=$PYTHONPATH:~/local/lib/python2.7/site-packages

$export PATH=$PATH::~/local/lib/python2.7/site-packages

$easy_install -U --prefix=$HOME/local Sphinx

But apparently, $easy_install doesn't build sphinx-quickstart; when I type

$sphinx-quickstart

I get the following message:

bash: sphinx-quickstart: command not found

I tried

find $HOME -name sphinx-quickstart 

and no result was found. However, I can import sphinx inside python:

$python

And then

>>import sphinx 

works. Any idea why sphinx-quickstart doesn't work?

回答1:

An alternative way to invoke sphinx-quickstart is to explicitly load Sphinx's quickstart module. For Sphinx v1.7+:

python -m sphinx.cmd.quickstart

For older versions of Sphinx:

python -m sphinx.quickstart

For example:

$ /c/Python35/python -m sphinx.quickstart
Welcome to the Sphinx 1.6.2 quickstart utility.
...

回答2:

I found the solution in this webpage:

User (root/sudo free) installation of Python modules.

In section 3. Python 2.6+ he mentioned that the command line commands are in

~/local/bin

Although I had put ~/local/lib/python2.7/siste-packages in the path, the ~/local/bin directory was not in the path. So all I did

$export PYTHONPATH=$PYTHONPATH:~/local/bin

and now it works.

I don't know why find $HOME -name sphinx-quickstart did not find sphinx-quickstart

回答3:

In MacOS (Catalina) and zsh:

I installed sphinx with brew and had the same problem as you.

Solution: Installed it with conda as conda install sphinx and now it works for me

$ sphinx-quickstart
Welcome to the Sphinx 2.3.0 quickstart utility.

Installation Guide

来源：https://stackoverflow.com/questions/26876525/sphinx-quickstart-doesnt-work