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 attachment 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...