Printable Documentation

[Martin Pool]

2009/1/12 Colin D Bennett <colin at gibibit.com>:
> I've fixed the image size problem and changed it to use the vector
> versions of the images for superior quality.  I wrote a Python script
> to add 'width' and 'align' elements to the reStructuredText sources,
> and convert the SVG images to PDF, replacing the PNG references with
> PDF references.  Then when you run 'rst2pdf.py', it looks great.
>
> I've uploaded an updated PDF:
> <http://gibibit.com/upload/bzr-user-guide-r3933.en.pdf>
>
> The only problem I see now is a few lines that overrun the margins.
> (e.g., the last paragraph on p. 68)
>
> Hope this is useful.  I've attached my Python script.  BEWARE IT
> MODIFIES ALL '.txt' FILES IN THE CURRENT DIRECTORY, but it won't hurt
> to run it more than once on rST sources.

Thanks Colin, that's pretty helpful.  Do you think you could turn that
script into something that we could run from 'make doc' -- or maybe
some other target to allow for not everyone having latex.  Then we
could run it from the cron job that generates
http://doc.bazaar-vcs.org/

Ideally we'd have just one rst file that would work in both, but if it
needs pdf images to generate pdf perhaps we have to copy them before
processing it.

-- 
Martin <http://launchpad.net/~mbp/>