Bugzilla Bug 31672

When installing gentoo for the first (few) times, users usually print a copy of
the installation guide. This installation guide is available on the LiveCD in
pdf-format.

I realize that there exists a 'printer-friendly' xml-version of the guide though
on the doc pages though.

How about adding an online pdf-version of the guide to the doc page also?

Reproducible: Always
Steps to Reproduce:
1. visit http://www.gentoo.org/doc/en/index.xml

Actual Results:  
I failed to locate a pdf-guide on the page.

Expected Results:  
It should have linked to a pdf-version of the guide.

I mentioned this on #gentoo-doc on 2003-10-21. Erwin' stepped forward and said
he would discuss the issue on the mailing list.

This is a known issue. However, it is not really easy as we want to have
our website contain only up-to-date information. If we provide PDF files,
they must be automatically generated on the server, and not manually created
and uploaded.

We are working on this. You can find this task on http://www.gentoo.org/proj/en/gdp
where it has November 14 as target milestone.

We are still working on it :) A draft PDF can be found at
http://emu.gentoo.org/~swift/gentoo-x86-install.pdf. We're now checking out how
we can have such PDFs online for the users.

We are of course now working on a PDF version of the handbook as the individual
installation guides will disappear...

Okay, I'm giving up on XSL:FO transformations. My graphical abilities are too
slim and there are issues with:

- dynamically guessing of table sizes
- graphic embedding
- nested commands, such as <ul><li><pre>...</pre><ul>..</ul></li></ul>

I'll attach what I have now (for guides) to this bugreport. It's a stylesheet
which you can use to transform GUideXML to xsl-fo which, in return, can be
converted to any format (such as pdf) using fop:

xsltproc guide2pdf.xsl yourguide.xml > yourguide.fo
fop yourguide.fo yourguide.pdf

Created an attachment (id=23181) [details]
guide2pdf.xsl stylesheet (not 100% functional)

plasmaroo's working on PDF versions of the Gentoo handbook.

See http://dev.gentoo.org/~plasmaroo/handbook-test.

Ok, we now provide PDF handbooks on the LiveCDs for our Gentoo releases, and I
also keep snapshots at http://dev.gentoo.org/~plasmaroo/handbook-test/ so I
think I can close this bug...