Updating PDF Usage Docs

[Tim Soderstrom]

Though I have been trying to move much of these to the wiki itself, Becky did find a small error in the usage docs and, while looking into that, I noticed the docs on the Wiki are 0.9.6. Working on updating them to what is currently in GIT.

That said, I forget - how do we convert from HTML to PDF with Python-Sphinx?

[Andrew Garner]

# make latex && cd build/latex && make all-pdf

You probably need a recent version of pdflatex from texlive installed
to build those. If this doesn't work well (I haven't run this in a
really long time), we can look at other options. I think recent
versions of sphinx support less baroque options for pdf generation.

~Andy

[Tim Soderstrom]

Yeah, no good on CentOS 5. Trying to see if Ubuntu 10.04 has this stuff (betting that it does) and, if so, I can just use that.

[Andrew Garner]

On Fri, Jul 23, 2010 at 11:16 AM, Tim Soderstrom

I just ran this on lucid without running into problems. You do have
to have the right packages installed though. This post is useful:

http://jimmyg.org/blog/2009/sphinx-pdf-generation-with-latex.html

~Andy

[Tim Soderstrom]

Yep that was helpful. I distilled some of it down to a page on our wiki:

http://hollandbackup.org/BuildingUsageDocs

Didn't have to do any setuptools stuff with 10.04. Just basically installed the packages and started rocking.