* added first draft of documentation

git-svn-id: svn+ssh://svn.synyx.de/var/svn/synyx/opensource/hera/trunk@3246 5a64d73e-33d6-4ccc-9058-23f8668ecac9

src/doc/layout/html/fo-html.xsl

@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="us-ascii"?>
+<!-- 
+    This is the XSL HTML configuration file for the Spring
+    Reference Documentation.
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:fo="http://www.w3.org/1999/XSL/Format" version="1.0">
+
+    <xsl:import href="urn:docbkx:stylesheet"/>
+
+    <!--###################################################
+                    HTML Settings
+   ################################################### -->
+
+    <xsl:param name="html.stylesheet">html.css</xsl:param>
+
+    <!-- These extensions are required for table printing and other stuff -->
+    <xsl:param name="use.extensions">1</xsl:param>
+    <xsl:param name="tablecolumns.extension">0</xsl:param>
+    <xsl:param name="callout.extensions">1</xsl:param>
+    <xsl:param name="graphicsize.extension">0</xsl:param>
+
+    <!--###################################################
+                     Table Of Contents
+   ################################################### -->
+
+    <!-- Generate the TOCs for named components only -->
+    <xsl:param name="generate.toc">
+        book toc
+    </xsl:param>
+
+    <!-- Show only Sections up to level 3 in the TOCs -->
+    <xsl:param name="toc.section.depth">3</xsl:param>
+
+    <!--###################################################
+                        Labels
+   ################################################### -->
+
+    <!-- Label Chapters and Sections (numbering) -->
+    <xsl:param name="chapter.autolabel">1</xsl:param>
+    <xsl:param name="section.autolabel" select="1"/>
+    <xsl:param name="section.label.includes.component.label" select="1"/>
+
+    <!--###################################################
+                        Callouts
+   ################################################### -->
+
+    <!-- Use images for callouts instead of (1) (2) (3) -->
+    <xsl:param name="callout.graphics">0</xsl:param>
+
+    <!-- Place callout marks at this column in annotated areas -->
+    <xsl:param name="callout.defaultcolumn">90</xsl:param>
+
+    <!--###################################################
+                      Admonitions
+   ################################################### -->
+
+    <!-- Use nice graphics for admonitions -->
+    <xsl:param name="admon.graphics">0</xsl:param>
+
+    <!--###################################################
+                         Misc
+   ################################################### -->
+    <!-- Placement of titles -->
+    <xsl:param name="formal.title.placement">
+        figure after
+        example before
+        equation before
+        table before
+        procedure before
+    </xsl:param>
+    <xsl:template match="author" mode="titlepage.mode">
+        <xsl:if test="name(preceding-sibling::*[1]) = 'author'">
+            <xsl:text>, </xsl:text>
+        </xsl:if>
+        <span class="{name(.)}">
+            <xsl:call-template name="person.name"/>
+            <xsl:apply-templates mode="titlepage.mode" select="./contrib"/>
+            <xsl:apply-templates mode="titlepage.mode" select="./affiliation"/>
+        </span>
+    </xsl:template>
+    <xsl:template match="authorgroup" mode="titlepage.mode">
+        <div class="{name(.)}">
+            <h2>Authors</h2>
+            <p/>
+            <xsl:apply-templates mode="titlepage.mode"/>
+        </div>
+    </xsl:template>
+
+</xsl:stylesheet>

src/doc/layout/html/resources/styles.css

@@ -0,0 +1,291 @@
+body {
+	font-family: Verdana, Arial, monospace;
+	text-align: justify;
+	width: 900px;
+	margin-right: auto;
+	margin-left: auto;
+}
+
+a,a[accesskey ^="h"],a[accesskey ^="n"],a[accesskey ^="u"],a[accesskey ^="p"]
+	{
+	font-family: Verdana, Arial, helvetica, sans-serif;
+	font-size: 12px;
+	color: #003399;
+}
+
+a:active {
+	color: #003399;
+}
+
+a:visited {
+	color: #888888;
+}
+
+p {
+	font-family: Verdana, Arial, sans-serif;
+}
+
+dt {
+	font-family: Verdana, Arial, sans-serif;
+	font-size: 12px;
+}
+
+p,dl,dt,dd,blockquote {
+	color: #000000;
+	margin-bottom: 3px;
+	margin-top: 3px;
+	padding-top: 0;
+}
+
+ol,ul,p {
+	margin-top: 6px;
+	margin-bottom: 6px;
+}
+
+p,blockquote {
+	font-size: 90%;
+}
+
+p.releaseinfo {
+	font-size: 100%;
+	font-weight: bold;
+	font-family: Verdana, Arial, helvetica, sans-serif;
+	padding-top: 10px;
+}
+
+p.pubdate {
+	font-size: 120%;
+	font-weight: bold;
+	font-family: Verdana, Arial, helvetica, sans-serif;
+}
+
+td {
+	font-size: 80%;
+}
+
+td,th,span {
+	color: #000000;
+}
+
+td[width ^="40%"] {
+	font-family: Verdana, Arial, helvetica, sans-serif;
+	font-size: 12px;
+	color: #003399;
+}
+
+table[summary ^="Navigation header"] tbody tr th[colspan ^="3"] {
+	font-family: Verdana, Arial, helvetica, sans-serif;
+}
+
+blockquote {
+	margin-right: 0;
+}
+
+h1,h2,h3,h4,h6,H6 {
+	color: #000000;
+	font-weight: 500;
+	margin-top: 0;
+	padding-top: 14px;
+	font-family: Verdana, Arial, helvetica, sans-serif;
+	margin-bottom: 0;
+}
+
+h2.title {
+	font-weight: 800;
+	margin-bottom: 8px;
+}
+
+h2.subtitle {
+	font-weight: 800;
+	margin-bottom: 20px;
+}
+
+.firstname,.surname {
+	font-size: 12px;
+	font-family: Verdana, Arial, helvetica, sans-serif;
+}
+
+table {
+	border-collapse: collapse;
+	border-spacing: 0;
+	border: 1px black;
+	empty-cells: hide;
+	margin: 10px 0 30px 50px;
+	width: 90%;
+}
+
+div.table {
+	margin: 30px 0 30px 0;
+	border: 1px dashed gray;
+	padding: 10px;
+}
+
+div .table-contents table {
+	border: 1px solid black;
+}
+
+div.table>p.title {
+	padding-left: 10px;
+}
+
+table[summary ^="Navigation footer"] {
+	border-collapse: collapse;
+	border-spacing: 0;
+	border: 1px black;
+	empty-cells: hide;
+	margin: 0px;
+	width: 100%;
+}
+
+table[summary ^="Note"],table[summary ^="Warning"],table[summary ^="Tip"]
+	{
+	border-collapse: collapse;
+	border-spacing: 0;
+	border: 1px black;
+	empty-cells: hide;
+	margin: 10px 0px 10px -20px;
+	width: 100%;
+}
+
+td {
+	padding: 4pt;
+	font-family: Verdana, Arial, helvetica, sans-serif;
+}
+
+div.warning TD {
+	text-align: justify;
+}
+
+h1 {
+	font-size: 150%;
+}
+
+h2 {
+	font-size: 110%;
+}
+
+h3 {
+	font-size: 100%;
+	font-weight: bold;
+}
+
+h4 {
+	font-size: 90%;
+	font-weight: bold;
+}
+
+h5 {
+	font-size: 90%;
+	font-style: italic;
+}
+
+h6 {
+	font-size: 100%;
+	font-style: italic;
+}
+
+tt {
+	font-size: 110%;
+	font-family: "Courier New", Courier, monospace;
+	color: #000000;
+}
+
+.navheader,.navfooter {
+	border: none;
+}
+
+div.navfooter table {
+	background-color: #eef;
+}
+
+pre {
+	font-size: 110%;
+	padding: 5px;
+	border-style: solid;
+	border-width: 1px;
+	border-color: #CCCCCC;
+	background-color: #eef;
+}
+
+ul,ol,li {
+	list-style: disc;
+}
+
+hr {
+	width: 100%;
+	height: 1px;
+	background-color: #CCCCCC;
+	border-width: 0;
+	padding: 0;
+}
+
+.variablelist {
+	padding-top: 10px;
+	padding-bottom: 10px;
+	margin: 0;
+}
+
+.term {
+	font-weight: bold;
+}
+
+.mediaobject {
+	padding-top: 30px;
+	padding-bottom: 30px;
+}
+
+.legalnotice {
+	font-family: Verdana, Arial, helvetica, sans-serif;
+	font-size: 12px;
+	font-style: italic;
+}
+
+.sidebar {
+	float: right;
+	margin: 10px 0 10px 30px;
+	padding: 10px 20px 20px 20px;
+	width: 33%;
+	border: 1px solid black;
+	background-color: #F4F4F4;
+	font-size: 14px;
+}
+
+.property {
+	font-family: "Courier New", Courier, monospace;
+}
+
+a code {
+	font-family: Verdana, Arial, monospace;
+	font-size: 12px;
+}
+
+td code {
+	font-size: 110%;
+}
+
+div.note * td,div.tip * td,div.warning * td,div.calloutlist * td {
+	text-align: justify;
+	font-size: 100%;
+}
+
+.programlisting .interfacename,.programlisting .literal,.programlisting .classname
+	{
+	font-size: 95%;
+}
+
+.title .interfacename,.title .literal,.title .classname {
+	font-size: 130%;
+}
+
+/* everything in a <lineannotation/> is displayed in a coloured, comment-like font */
+.programlisting * .lineannotation,.programlisting * .lineannotation * {
+	color: green;
+}
+
+.question * p {
+	font-size: 100%;
+}
+
+.answer * p {
+	font-size: 100%;
+}

src/doc/layout/pdf/fo-pdf.xsl

@@ -0,0 +1,437 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:fo="http://www.w3.org/1999/XSL/Format" version="1.0">
+
+	<!-- Import standard docbook stylesheet -->
+    <xsl:import href="urn:docbkx:stylesheet"/>
+    
+    <!-- Import highlighting color codes -->
+    <xsl:import href="highlight-fo.xsl"/>
+    
+    
+    <xsl:param name="glossterm.auto.link">1</xsl:param>
+    <xsl:param name="highlight.source">1</xsl:param>
+    <xsl:param name="use.extensions">1</xsl:param>
+    <xsl:param name="callouts.extension">1</xsl:param>
+    
+     
+     <!-- Custom Title Page -->
+
+    <xsl:template name="book.titlepage.recto">
+        <fo:block>
+            <fo:table table-layout="fixed" width="175mm">
+                <fo:table-column column-width="175mm"/>
+                <fo:table-body>
+                    <fo:table-row>
+                        <fo:table-cell text-align="center">
+                            <fo:block font-size="22pt" font-weight="bold" padding-before="30mm">
+                                <xsl:value-of select="bookinfo/title"/> 
+                            </fo:block>
+                            <fo:block font-size="14pt" padding="10mm">
+                                <xsl:value-of select="bookinfo/subtitle"/>
+                            </fo:block>
+                            <fo:block font-size="12pt" padding="10mm">
+                                <xsl:value-of select="bookinfo/releaseinfo"/>
+                            </fo:block>
+                        </fo:table-cell>
+                    </fo:table-row>
+                    <fo:table-row>
+                        <fo:table-cell text-align="center">
+                            <fo:block font-size="12pt" padding="10mm" padding-top="40mm">
+                                <xsl:value-of select="bookinfo/pubdate"/>
+                            </fo:block>
+                        </fo:table-cell>
+                    </fo:table-row>
+                    <fo:table-row>
+                        <fo:table-cell text-align="center">
+                        	<fo:block>
+                            	<fo:external-graphic src="file:target/doc/images/synyx-logo.tiff" width="70mm" height="auto" content-width="scale-to-fit" content-height="scale-to-fit" />
+                            </fo:block>
+                            <fo:block font-size="12pt" padding="10mm">
+                                <xsl:for-each select="bookinfo/authorgroup/author">
+                                    <xsl:if test="position() &gt; 1">
+                                        <xsl:text>, </xsl:text>
+                                    </xsl:if>
+                                    <xsl:value-of select="firstname"/>
+                                    <xsl:text> </xsl:text>
+                                    <xsl:value-of select="surname"/>
+                                    <xsl:text> (</xsl:text>
+                                    <xsl:value-of select="affiliation/jobtitle"/>
+                                    <xsl:text>, </xsl:text>
+                                    <xsl:value-of select="affiliation/orgname"/>
+                                    <xsl:text>)</xsl:text>
+                                </xsl:for-each>
+                            </fo:block>
+                            <fo:block font-size="12pt" padding="10mm">
+								<xsl:text>Copyright &#169; </xsl:text>
+								<xsl:value-of select="bookinfo/copyright/year" />
+							</fo:block>
+
+                            <fo:block font-size="10pt" padding="1mm">
+                                <xsl:value-of select="bookinfo/legalnotice"/>
+                            </fo:block>
+                        </fo:table-cell>
+                    </fo:table-row>
+                </fo:table-body>
+            </fo:table>
+        </fo:block>
+    </xsl:template>
+       
+    
+    <!-- Prevent blank pages in output -->
+    <xsl:template name="book.titlepage.before.verso">
+    </xsl:template>
+    <xsl:template name="book.titlepage.verso">
+    </xsl:template>
+    <xsl:template name="book.titlepage.separator">
+    </xsl:template>
+
+    <!-- Header -->
+
+    <!-- More space in the center header for long text 
+    <xsl:attribute-set name="header.content.properties">
+        <xsl:attribute name="font-family">
+            <xsl:value-of select="$body.font.family"/>
+        </xsl:attribute>
+    </xsl:attribute-set>
+    -->
+
+    <!-- Custom Footer -->
+    <xsl:template name="footer.content">
+        <xsl:param name="pageclass" select="''"/>
+        <xsl:param name="sequence" select="''"/>
+        <xsl:param name="position" select="''"/>
+        <xsl:param name="gentext-key" select="''"/>
+		<xsl:variable name="Version">
+			<xsl:value-of select="//bookinfo/title" />
+			<!-- 
+			<xsl:if test="//releaseinfo">
+				<xsl:text>Product Oriented Import (</xsl:text><xsl:value-of select="//releaseinfo"/><xsl:text>)</xsl:text>
+			</xsl:if>-->
+		</xsl:variable>
+        <xsl:choose>
+            <xsl:when test="$sequence='blank'">
+                <xsl:if test="$position = 'center'">
+                    <xsl:value-of select="$Version"/>
+                </xsl:if>
+            </xsl:when>
+            <!-- for double sided printing, print page numbers on alternating sides (of the page) -->
+            <xsl:when test="$double.sided != 0">
+                <xsl:choose>
+                    <xsl:when test="$sequence = 'even' and $position='left'">
+                        <fo:page-number/>
+                    </xsl:when>
+                    <xsl:when test="$sequence = 'odd' and $position='right'">
+                        <fo:page-number/>
+                    </xsl:when>
+                    <xsl:when test="$position='center'">
+                        <xsl:value-of select="$Version"/>
+                    </xsl:when>
+                </xsl:choose>
+            </xsl:when>
+            <!-- for single sided printing, print all page numbers on the right (of the page) -->
+            <xsl:when test="$double.sided = 0">
+                <xsl:choose>
+                    <xsl:when test="$position='center'">
+                        <xsl:value-of select="$Version"/>
+                    </xsl:when>
+                    <xsl:when test="$position='right'">
+                        <fo:page-number/>
+                    </xsl:when>
+                </xsl:choose>
+            </xsl:when>
+        </xsl:choose>
+    </xsl:template>
+
+    <!-- Table Of Contents -->
+
+    <!-- Generate the TOCs for named components only -->
+    <xsl:param name="generate.toc">
+        book toc,title
+    </xsl:param>
+
+    <!-- Show only Sections up to level 3 in the TOCs -->
+    <xsl:param name="toc.section.depth">2</xsl:param>
+
+    <!-- Dot and Whitespace as separator in TOC between Label and Title-->
+    <xsl:param name="autotoc.label.separator" select="'.  '"/>
+
+
+    <!-- Paper & Page Size -->
+
+    <!-- Paper type, no headers on blank pages, no double sided printing -->
+    <xsl:param name="paper.type" select="'A4'"/>
+    <xsl:param name="double.sided">0</xsl:param>
+    <xsl:param name="headers.on.blank.pages">0</xsl:param>
+    <xsl:param name="footers.on.blank.pages">0</xsl:param> 
+
+    <!-- Space between paper border and content (chaotic stuff, don't touch) -->
+    
+    <xsl:param name="region.before.extent">15mm</xsl:param>
+    <xsl:param name="region.after.extent">10mm</xsl:param>
+    
+    <xsl:param name="body.margin.top">10mm</xsl:param>
+    <xsl:param name="body.margin.bottom">10mm</xsl:param>
+    
+    <xsl:param name="page.margin.top">15mm</xsl:param>
+    <xsl:param name="page.margin.bottom">15mm</xsl:param>
+	
+    <xsl:param name="page.margin.outer">18mm</xsl:param>
+    <xsl:param name="page.margin.inner">18mm</xsl:param>
+
+    <!-- No intendation of Titles -->
+    <xsl:param name="title.margin.left">0pc</xsl:param>
+
+   	 <!-- Fonts & Styles -->
+
+    <!-- Left aligned text and no hyphenation -->
+    <xsl:param name="alignment">justify</xsl:param>
+    <xsl:param name="hyphenate">true</xsl:param>
+    
+    <!-- Links -->
+    <xsl:param name="xref.with.number.and.title" select="1"/>
+    
+    <xsl:attribute-set name="xref.properties">
+	  <xsl:attribute name="color">
+	    <xsl:choose>
+	      <xsl:when test="self::ulink | self::xref">blue</xsl:when>
+	      <xsl:otherwise>inherit</xsl:otherwise>
+	    </xsl:choose>
+	  </xsl:attribute>
+	  <xsl:attribute name="text-decoration">
+	    <xsl:choose>
+	      <xsl:when test="self::ulink | self::xref">underline</xsl:when>
+	      <xsl:otherwise>inherit</xsl:otherwise>
+	    </xsl:choose>
+	  </xsl:attribute>
+	</xsl:attribute-set>
+    
+
+    <!-- Default Font size -->
+    <xsl:param name="title.font.family">StellaLining</xsl:param>
+    
+    <xsl:param name="body.font.family">StellaLining</xsl:param>
+    <xsl:param name="body.font.master">11</xsl:param>
+    <xsl:param name="body.font.small">9</xsl:param>
+
+    <!-- Line height in body text -->
+    <xsl:param name="line-height">1.3</xsl:param> 
+
+    <!-- Monospaced fonts are smaller than regular text -->
+    <xsl:attribute-set name="monospace.properties">
+        <xsl:attribute name="font-family">
+            <xsl:value-of select="$monospace.font.family"/>
+        </xsl:attribute>
+        <xsl:attribute name="font-size">0.9em</xsl:attribute>
+    </xsl:attribute-set>
+
+    <!-- Tables -->
+
+    <!-- The table width should be adapted to the paper size -->
+    <xsl:param name="default.table.width">15.4cm</xsl:param>
+
+    <!-- Some padding inside tables -->
+    <xsl:attribute-set name="table.cell.padding">
+        <xsl:attribute name="padding-left">4pt</xsl:attribute>
+        <xsl:attribute name="padding-right">4pt</xsl:attribute>
+        <xsl:attribute name="padding-top">4pt</xsl:attribute>
+        <xsl:attribute name="padding-bottom">4pt</xsl:attribute>
+    </xsl:attribute-set>
+
+    <!-- Only hairlines as frame and cell borders in tables -->
+    <xsl:param name="table.frame.border.thickness">0.1pt</xsl:param>
+    <xsl:param name="table.cell.border.thickness">0.1pt</xsl:param>
+
+    <!-- Labels -->
+
+    <!-- Label Chapters and Sections (numbering) -->
+    <xsl:param name="chapter.autolabel">1</xsl:param>
+    <xsl:param name="section.autolabel" select="1"/>
+    <xsl:param name="section.label.includes.component.label" select="1"/>
+
+    <!-- Titles -->
+
+    <!-- Chapter title size -->
+    <xsl:attribute-set name="chapter.titlepage.recto.style">
+        <xsl:attribute name="text-align">left</xsl:attribute>
+        <xsl:attribute name="font-weight">bold</xsl:attribute>
+        <xsl:attribute name="font-size">
+            <xsl:value-of select="$body.font.master * 1.8"/>
+            <xsl:text>pt</xsl:text>
+        </xsl:attribute>
+    </xsl:attribute-set>
+
+    <!-- Why is the font-size for chapters hardcoded in the XSL FO templates? 
+        Let's remove it, so this sucker can use our attribute-set only... -->
+    <xsl:template match="title" mode="chapter.titlepage.recto.auto.mode">
+        <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style">
+            <xsl:call-template name="component.title">
+                <xsl:with-param name="node" select="ancestor-or-self::chapter[1]"/>
+            </xsl:call-template>
+        </fo:block>
+    </xsl:template>
+
+    <!-- Sections 1, 2 and 3 titles have a small bump factor and padding -->
+    <xsl:attribute-set name="section.title.level1.properties">
+        <xsl:attribute name="space-before.optimum">0.8em</xsl:attribute>
+        <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute>
+        <xsl:attribute name="space-before.maximum">0.8em</xsl:attribute>
+        <xsl:attribute name="font-size">
+            <xsl:value-of select="$body.font.master * 1.5"/>
+            <xsl:text>pt</xsl:text>
+        </xsl:attribute>
+        <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute>
+        <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute>
+        <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute>
+    </xsl:attribute-set>
+    <xsl:attribute-set name="section.title.level2.properties">
+        <xsl:attribute name="space-before.optimum">0.6em</xsl:attribute>
+        <xsl:attribute name="space-before.minimum">0.6em</xsl:attribute>
+        <xsl:attribute name="space-before.maximum">0.6em</xsl:attribute>
+        <xsl:attribute name="font-size">
+            <xsl:value-of select="$body.font.master * 1.25"/>
+            <xsl:text>pt</xsl:text>
+        </xsl:attribute>
+        <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute>
+        <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute>
+        <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute>
+    </xsl:attribute-set>
+    <xsl:attribute-set name="section.title.level3.properties">
+        <xsl:attribute name="space-before.optimum">0.4em</xsl:attribute>
+        <xsl:attribute name="space-before.minimum">0.4em</xsl:attribute>
+        <xsl:attribute name="space-before.maximum">0.4em</xsl:attribute>
+        <xsl:attribute name="font-size">
+            <xsl:value-of select="$body.font.master * 1.0"/>
+            <xsl:text>pt</xsl:text>
+        </xsl:attribute>
+        <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute>
+        <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute>
+        <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute>
+    </xsl:attribute-set>
+
+    <!-- Titles of formal objects (tables, examples, ...) -->
+    <xsl:attribute-set name="formal.title.properties" use-attribute-sets="normal.para.spacing">
+        <xsl:attribute name="font-weight">bold</xsl:attribute>
+        <xsl:attribute name="font-size">
+            <xsl:value-of select="$body.font.master"/>
+            <xsl:text>pt</xsl:text>
+        </xsl:attribute>
+        <xsl:attribute name="hyphenate">false</xsl:attribute>
+        <xsl:attribute name="space-after.minimum">0.4em</xsl:attribute>
+        <xsl:attribute name="space-after.optimum">0.6em</xsl:attribute>
+        <xsl:attribute name="space-after.maximum">0.8em</xsl:attribute>
+    </xsl:attribute-set>
+
+    <!-- Programlistings -->
+
+    <!-- Verbatim text formatting (programlistings) -->
+    <xsl:attribute-set name="monospace.verbatim.properties">
+        <xsl:attribute name="font-size">
+            <xsl:value-of select="$body.font.small"/>
+            <xsl:text>pt</xsl:text>
+        </xsl:attribute>
+    </xsl:attribute-set>
+
+    <xsl:attribute-set name="verbatim.properties">
+    	<xsl:attribute name="keep-together.within-column">always</xsl:attribute>
+        <xsl:attribute name="space-before.minimum">1em</xsl:attribute>
+        <xsl:attribute name="space-before.optimum">1em</xsl:attribute>
+        <xsl:attribute name="space-before.maximum">1em</xsl:attribute>
+        <xsl:attribute name="border-color">#444444</xsl:attribute>
+        <xsl:attribute name="border-style">solid</xsl:attribute>
+        <xsl:attribute name="border-width">0.1pt</xsl:attribute>
+        <xsl:attribute name="padding-top">0.5em</xsl:attribute>
+        <xsl:attribute name="padding-left">0.5em</xsl:attribute>
+        <xsl:attribute name="padding-right">0.5em</xsl:attribute>
+        <xsl:attribute name="padding-bottom">0.5em</xsl:attribute>
+        <xsl:attribute name="margin-left">0.5em</xsl:attribute>
+        <xsl:attribute name="margin-right">0.5em</xsl:attribute>
+    </xsl:attribute-set>
+
+    <!-- Shade (background) programlistings -->
+    <xsl:param name="shade.verbatim">1</xsl:param>
+    <xsl:attribute-set name="shade.verbatim.style">
+        <xsl:attribute name="background-color">#F0F0F0</xsl:attribute>
+    </xsl:attribute-set>
+
+    <!-- Callouts -->
+
+    <!-- Use images for callouts instead of (1) (2) (3) -->
+    <xsl:param name="callout.graphics">0</xsl:param>
+    <xsl:param name="callout.unicode">1</xsl:param>
+
+    <!-- Place callout marks at this column in annotated areas -->
+    <xsl:param name="callout.defaultcolumn">79</xsl:param>
+
+    <!-- Admonitions -->
+
+    <!-- Use nice graphics for admonitions
+    
+    <xsl:param name="admon.graphics">'1'</xsl:param>
+    <xsl:param name="admon.graphics.path">src/docbkx/resources/images/admons/</xsl:param>-->
+
+    <!-- Misc -->
+
+    <!-- Placement of titles -->
+    <xsl:param name="formal.title.placement">
+        figure after
+        example before
+        equation before
+        table before
+        procedure before
+    </xsl:param>
+
+    <!-- Format Variable Lists as Blocks (prevents horizontal overflow) -->
+    <xsl:param name="variablelist.as.blocks">1</xsl:param>
+
+    <!-- The horrible list spacing problems -->
+    <xsl:attribute-set name="list.block.spacing">
+        <xsl:attribute name="space-before.optimum">0.8em</xsl:attribute>
+        <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute>
+        <xsl:attribute name="space-before.maximum">0.8em</xsl:attribute>
+        <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute>
+        <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute>
+        <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute>
+    </xsl:attribute-set>
+
+    <!-- colored and hyphenated links -->
+    <xsl:template match="ulink">
+        <fo:basic-link external-destination="{@url}" xsl:use-attribute-sets="xref.properties" text-decoration="underline" color="blue">
+            <xsl:choose>
+                <xsl:when test="count(child::node())=0">
+                    <xsl:value-of select="@url"/>
+                </xsl:when>
+                <xsl:otherwise>
+                    <xsl:apply-templates/>
+                </xsl:otherwise>
+            </xsl:choose>
+        </fo:basic-link>
+    </xsl:template>
+
+    <xsl:template match="link">
+        <fo:basic-link internal-destination="{@linkend}" xsl:use-attribute-sets="xref.properties" text-decoration="underline" color="blue">
+            <xsl:choose>
+                <xsl:when test="count(child::node())=0">
+                    <xsl:value-of select="@linkend"/>
+                </xsl:when>
+                <xsl:otherwise>
+                    <xsl:apply-templates/>
+                </xsl:otherwise>
+            </xsl:choose>
+        </fo:basic-link>
+    </xsl:template>
+    
+    <!--
+    <xsl:template match="xref">
+        <fo:basic-link internal-destination="{@linkend}" xsl:use-attribute-sets="xref.properties" text-decoration="underline" color="blue">
+            <xsl:choose>
+                <xsl:when test="count(child::node())=0">
+                    <xsl:value-of select="@linkend"/>
+                </xsl:when>
+                <xsl:otherwise>
+                    <xsl:apply-templates/>
+                </xsl:otherwise>
+            </xsl:choose>
+        </fo:basic-link>
+    </xsl:template>-->
+	
+</xsl:stylesheet>

src/doc/layout/pdf/highlight-fo.xsl

@@ -0,0 +1,39 @@
+<?xml version="1.0"?>
+<!-- 
+    Simple highlighter for FO/PDF output. Follows the Eclipse color scheme.
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:xslthl="http://xslthl.sf.net" exclude-result-prefixes="xslthl" version="1.0">
+
+	<xsl:template match="xslthl:keyword">
+	  <fo:inline font-weight="bold" color="#7F0055"><xsl:apply-templates/></fo:inline>
+	</xsl:template>
+	
+	<xsl:template match="xslthl:comment">
+	  <fo:inline font-style="italic" color="#3F5F5F"><xsl:apply-templates/></fo:inline>
+	</xsl:template>
+
+	<xsl:template match="xslthl:oneline-comment">
+	  <fo:inline font-style="italic" color="#3F5F5F"><xsl:apply-templates/></fo:inline>
+	</xsl:template>
+
+	<xsl:template match="xslthl:multiline-comment">
+	  <fo:inline font-style="italic" color="#3F5FBF"><xsl:apply-templates/></fo:inline>
+	</xsl:template>
+
+	<xsl:template match="xslthl:tag">
+	  <fo:inline color="#3F7F7F"><xsl:apply-templates/></fo:inline>
+	</xsl:template>
+
+	<xsl:template match="xslthl:attribute">
+	  <fo:inline color="#7F007F"><xsl:apply-templates/></fo:inline>
+	</xsl:template>
+	
+	<xsl:template match="xslthl:value">
+	  <fo:inline color="#2A00FF"><xsl:apply-templates/></fo:inline>
+	</xsl:template>
+
+	<xsl:template match="xslthl:string">
+	  <fo:inline color="#2A00FF"><xsl:apply-templates/></fo:inline>
+	</xsl:template>
+
+</xsl:stylesheet>