Open Source Software in Libraries: a workshop by Eric Lease Morgan

DocBook stylesheets

Link: http://docbook.sourceforge.net/projects/xsl/

Given a set of XML/DocBook files, the DocBook stylesheets, and/or an XSL pro-

cessor such as xsltproc or FOP, you can transform your DocBook files into PDF

documents, HTML documents, XHTML documents, or a few other file types. When

you download the stylesheets, but sure to download the XSL sheets and not

other types. You would need other processors to use the other types. The

stylesheets are configurable by setting a number of parameters. Through this

means you can specify a cascading stylesheet to be incorporated into your

XHTML/HTML files. The stylesheets are thorough but do not allow you to change

very much of the resulting output. If you don't like the way the stylesheets

format your XML, you can always write your own stylesheets, but I'm willing to

bet you have better things to do with your time. As a person who is interested

in open source software, learning how to write DocBook files is a skill that

will come in handy in the future.

FOP

Link: http://xml.apache.org/fop/

FOP is an implementation of the Formating Objects standards for transforming

XML documents into documents intended for printing. It is mentioned here, not

because it a primary open source software application, but because it is a

Java application and represents a nice way to create PDF documents. For exam-

ple, given an Java virtual machine, a DocBook file, the DocBook stylesheets,

and FOP, you can create PDF versions of your DocBook documents. I have only

had success with version 0.20.3 but it has proven indispensible a number of

times. Writing FO stylesheets is not easy, and that is why I have relied on

the DocBook FO stylesheets. Learning how to use FOP will give you good experi-

ence with Java as well as XML files.