Printable Documentation

[Colin D Bennett]

On Sun, 11 Jan 2009 00:12:43 -0800
Colin D Bennett <colin at gibibit.com> wrote:

> On Sat, 10 Jan 2009 21:56:38 -0800
> Colin D Bennett <colin at gibibit.com> wrote:
> 
> > On Sat, 10 Jan 2009 19:28:56 -0600
> > "Richard Fleming" <rfleming at acqusys.com> wrote:
> > 
> > > Hello,
> > > 
> > > I know that the user documentation is available on the website,
> > > however I was wondering if there was a "clean to print" version,
> > > like a PDF or Postscript?
> > 
> > Since the documentation is in reStructuredText format, it can be
> > rendered to nearly any format, including LaTeX and
> > OpenOffice-compatible ODT format.
> > 
> > I rendered the User Guide to PDF on US Letter size paper using
> > 'rst2pdf.py'. You can find the PDF at
> > <http://gibibit.com/upload/bzr-user-guide-r3933.en.pdf>.
> > 
> > If you want to render it yourself, you need docutils and LaTeX
> > installed, then get and run 'rst2pdf.py' from
> > <http://svn.berlios.de/viewcvs/docutils/trunk/sandbox/rst2pdf/rst2pdf.py>.
> 
> Ok, clearly the images didn't work too well in that.  For instance,
> page 8.  They are waaaaaay huge.  I'll take a look at that in the
> morning.
> 
> Cheers,
> Colin

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.

Regards,
Colin
-------------- next part --------------
A non-text attachment was scrubbed...
Name: prepare_bzr_docs_for_latex.py
Type: text/x-python
Size: 3333 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20090111/ded7e530/attachment.py 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 197 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20090111/ded7e530/attachment.pgp