Sphinx-quickstart doesn't work

Question

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?

Answer 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.
...

Answer 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