Bug 25549

Summary:	Distribute our Documentation as PDF
Product:	Websites	Reporter:	Lars Weiler (RETIRED) <pylon>
Component:	[OLD] Documentation	Assignee:	Kurt Lieber (RETIRED) <klieber>
Status:	RESOLVED FIXED
Severity:	enhancement
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---

Description Lars Weiler (RETIRED) gentoo-dev

2003-07-29 19:26:17 UTC

A user asked me if we could create PDFs from our documents, so that printing
them is easier and better to read.

Due to the fact we create our documents in XML it should be quite simple to
create with the help of XSL and XSL-FO an own stylesheet for PDFs.  This is more
a long-term issue.

In the meantime we should make use of the guide-print.xsl in CVS and add a link
to a printable version to the documents, that will point to the with guide-print
generated document.

Comment 1 Kurt Lieber (RETIRED) gentoo-dev

2003-07-30 13:01:55 UTC

we have enabled printable documentation, as mentioned on the gentoo-doc mailing list.  PDF is more of a problem given the weak support that AxKit provides for PDF generation.  There are solutions, but most involve going through multiple layers of conversion to get a PDF doc as the end result.  At this point, I'm not comfortable with implementing a system that complex and would rather wait until something more elegant and cleaner comes around down the road.