Daisy Wiki PDF Notes

Introduction

Daisy generates PDFs by feeding XSL-FO (a vocabulary for specifying formatting semantics) to Apache FOP (and XSL-FO processor). The PDFs are generated on the fly when a user requests them.

Images

FOP caches images, normally indefinitely. Daisy clears FOPs' image cache from time to time, by default every 5 minutes (this is configurable in the cocoon.xconf file). So if you upload a new version of an image, it can take up to 5 minutes before appearing in the PDF. Closing and reopening your browser would also give immediately the new variant, since images are retrieved on a per-session basis (the sessionid is encoded in the image URL).

Links

In PDF output, link URLs are mentioned in footnotes.

Layout limitations

Below we list the known limitations in PDF output.

Table column widths

FOP can't auto-balance column widths like web browsers do. Therefore, all columns in a table are made the same width, which might give undesirable results. At the time of this writing, it is not yet possible to specify explicit column widths in Daisy.

One possible work around is specifying a class attribute on the table and adjust the XSLTs to handle the special case.

Text flow around images

Text flow around images is not supported.

Table cell vertical alignment

Table cell vertical alignment is not supported.