> But building from source might be a pain for some people, especially newbies like me.
It's really not hard, and it's using a tool you should start using as soon as you start "serious" Python projects: Sphinx.
Building the doc from source is pretty much trivial on Unix-type systems (OSX, Linux, BSD, whatever)
* Get the django source, either tarball or source control
* Install sphinx
* Go to the root of your Django install
* `make -C docs [format...]` where format is any set of valid sphinx output formats: html, dirhtml, singlehtml, htmlhelp, qthelp, devhelp, epub, latex, latexpdf, text or man
You compiled documentation will be in the `_build/$format` directory, for each format you're building (you can build all of them). The latexpdf target requires that `pdflatex` be installed and available.
It's really not hard, and it's using a tool you should start using as soon as you start "serious" Python projects: Sphinx.
Building the doc from source is pretty much trivial on Unix-type systems (OSX, Linux, BSD, whatever)
* Get the django source, either tarball or source control
* Install sphinx
* Go to the root of your Django install
* `make -C docs [format...]` where format is any set of valid sphinx output formats: html, dirhtml, singlehtml, htmlhelp, qthelp, devhelp, epub, latex, latexpdf, text or man
You compiled documentation will be in the `_build/$format` directory, for each format you're building (you can build all of them). The latexpdf target requires that `pdflatex` be installed and available.