Wow, the new docs look fantastic.

I've been using Sphinx to generate some docs at work and recently
figured out how to do the Sphinx -> LaTeX -> PDF thing so I thought
I'd share it with the class:
http://postneo.com/doc/django.pdf

I had to tweak conf.py a little to get it working.  Here's the patch
for that:
http://postneo.com/doc/0001-Tweak-conf.py-to-allow-for-building-LaTeX-documents.patch

It choked on some of the graphics files which will obviously not show
up in the PDF.  admin01.png might still be a pdf instead of a png.
You'll have to either comment out the reference to it or replace it
with a real png.  It also errored on the gifs (which I don't think
pdflatex can handle) and a few other of the pngs, but got most of
them.

To generate the docs at home you'll need to do the following:
Patch conf.py with the patch above.
Grab a TeX distro (I used MacTeX.  TeX Live is probably the easiest
way to get off the ground on other platforms.)
Make sure that pdflatex is on your PATH.  I had to add /usr/local/
texlive/2007/bin/i386-darwin/ to my PATH.
run "make latex" in the docs dir
change to the _build/latex dir and run "make pdf-all"
You'll encounter the image errors mentioned above but just keep
hitting return until it's done.

Thanks to all of the hard work put in by everyone.

--Matt
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"Django developers" group.
To post to this group, send email to django-developers@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/django-developers?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to