Teru's blog

Building up Pinax Documents by Sphinx

When checked docs directory in the Pinax source, found it uses Sphinx-build, which was not listed in the Ubuntu repository somehow. Sphinx site suggests to use

$ easy_install Sphinx

Now, where is easy_install? Turned out it's in python-setuptools. Installed it by

$ sudo apt-get install python-setuptools

OK, install Sphinx

$ sudo easy_install Sphinx

Wow, it's downloading and installing... but, failed:

INFORMATION the speedup extension could not be compiled, Jinja will fall back to the native python classes. =============================================================================== error: Setup script exited with error: can't copy 'Jinja.egg-info/native_libs.txt': doesn't exist or not a regular file

Hmm... well, install

$ sudo apt-get install python-jinja

and ran again

$ sudo easy_install Sphinx

OK, it worked So, ran Sphinx as

$ cd ~/pinax/docs
$ make htmlhelp

Ah, great automation... with one warning

build succeeded, 1 warning.

and says

Build finished; now you can run HTML Help Workshop with the .hhp project file in .build/htmlhelp.

Doing

$ cd .build/htmlhelp
$ firefox index.html

showed

Good Still a lot to read

http://pinaxproject.com/docs/trunk/ provides the same pages.