Django's website seems good but for some reason I couldn't find where to download the documentation:
http://docs.djangoproject.com/en/1.1/
(Yes, I need the docs for 1.1)
Does anyone know?
+6
A:
Django's documentation is built using Sphinx and included in their source tree.
From a checked-out copy of Django's source, just run make in the docs directory. You can find instructions for getting the source here: http://www.djangoproject.com/download/
Michael Greene
2010-02-03 20:15:22
I'm not using Linux.
cool-RR
2010-02-03 20:44:25
The `Makefile` is only there for convenience. If you have Sphinx installed, you can just invoke the `sphinx-build` executable directly where you would make. `sphinx-build help` will list the arguments, and you can look at the `Makefile` to see what Django would use: http://code.djangoproject.com/browser/django/trunk/docs/Makefile
Michael Greene
2010-02-03 20:49:57
Also, you could always use Cygwin, but I assume that's not what you want to do ;)
Michael Greene
2010-02-03 20:50:32
Okay, I just did it manually using sphinx-build. It was a pretty bad experience. (I had to figure out how the makefile works, and there appears to have been a small error there that I managed to fix.) I just want to say that I don't think it's very Pythonic that you have to go through all this just to have an offline copy of the documentation. I hope that someone will make a better solution.
cool-RR
2010-02-04 13:32:39
Sphinx does have the ability to export PDFs, etc. I don't know if it's ever been proposed that the Django website host these artifacts, but if that's a need of yours maybe you should.
Michael Greene
2010-02-04 14:20:40
A:
"Okay, I just did it manually using sphinx-build. It was a pretty bad experience."
Hmm. I just tried and it was a pretty smooth experience (and I have never done this before). Here's the Linux recipe:
- "cd" to the directory where your Django 1.2.x download has been extracted (in my case "~/downloads/Django-1.2.1")
- cd docs
- make latex PAPER=a4
- cd _build/latex
- make all-pdf
And the end result is 1000 page tome of Django goodness!
gamesbook
2010-08-12 06:55:58