Author: alexsmirnov Date: 2007-07-16 17:32:03 -0400 (Mon, 16 Jul 2007) New Revision: 1640 Added: trunk/docs/xslt/src/main/css/css/html.css trunk/docs/xslt/src/main/xslt/f.xsl trunk/docs/xslt/src/main/xslt/fopdf.xsl trunk/docs/xslt/src/main/xslt/html.xsl trunk/docs/xslt/src/main/xslt/html_chunk.xsl Removed: trunk/docs/xslt/src/main/resources/ Log: refactoring in the documentation build Copied: trunk/docs/xslt/src/main/css/css/html.css (from rev 1621, trunk/docs/xslt/src/main/resources/en/html.css) =================================================================== --- trunk/docs/xslt/src/main/css/css/html.css (rev 0) +++ trunk/docs/xslt/src/main/css/css/html.css 2007-07-16 21:32:03 UTC (rev 1640) @@ -0,0 +1,122 @@ + * { + font-family: "Verdana", "Arial", "Helvetica"; + font-size: 14px; + } + + A { + color: #0000CC; + } + + A:active { + color: #0000CC; + } + + A:visited { + color: #0000CC; + } + + P, OL, UL, LI, DL, DT, DD, BLOCKQUOTE { + color: #000000; + } + + TD, TH, SPAN { + color: #000000; + } + + BLOCKQUOTE { + margin-right: 0px; + } + + + H1, H2, H3, H4, H5, H6 { + color: #003399; + font-weight: 500; + margin-top: 10px; + padding-top: 5px; + } + + H1 { font-size: 150%; } + H2 { font-size: 140%; } + H3 { font-size: 110%; font-weight: bold; } + H4 { font-size: 110%; font-weight: bold;} + H5 { font-size: 100%; font-style: italic; } + H6 { font-size: 100%; font-style: italic; } + + TABLE { + border-collapse: collapse; + border-spacing: 0; + border: 1px dashed #CCCCCC; + empty-cells: hide; + width: 100% + } + + TD { + padding: 4pt; + } + + + TT { + font-size: 90%; + font-style: monospace; + color: #111111; + } + + PRE { + font-size: 100%; + padding: 5px; + border-style: solid; + border-width: 1px; + border-color: #CCCCCC; + background-color: #F4F4F4; + } + + HR { + width: 100%; + height: 1px; + background-color: #CCCCCC; + border-width: 0px; + padding: 0px; + color: #CCCCCC; + } + + .variablelist { + padding-top: 10; + padding-bottom: 10; + margin: 0; + } + + .itemizedlist { + padding-top: 0; + padding-bottom: 0; + margin: 0; + list-style-type: disc; + + } + + .orderedlist{ + padding-top: 0; + padding-bottom: 0; + margin: 0; + } + + .term { + font-weight: bold; + } + + .note + { + padding-bottom: 5px; + padding-left: 5px; + padding-right: 5px; + background-color: #FFFFCC; + } + + .warning + { + padding-bottom: 5px; + padding-left: 5px; + padding-right: 5px; + background-color: #FBDADA; + } + + Copied: trunk/docs/xslt/src/main/xslt/f.xsl (from rev 1636, trunk/docs/xslt/src/main/resources/en/f.xsl) =================================================================== --- trunk/docs/xslt/src/main/xslt/f.xsl (rev 0) +++ trunk/docs/xslt/src/main/xslt/f.xsl 2007-07-16 21:32:03 UTC (rev 1640) @@ -0,0 +1,84 @@ +<?xml version="1.0" encoding="UTF-8"?> +<xsl:transform xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:javaee="http://java.sun.com/JSP/TagLibraryDescriptor" + version="1.0" exclude-result-prefixes="javaee"> + <xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes" omit-xml-declaration="yes"/> + <xsl:param name="lang" /> + <xsl:param name="title" /> + <xsl:param name="separator" /> + + <xsl:template match="javaee:taglib | taglib"> + <xsl:variable name="excluded-tag-names">header2,header3,header4,header5,header6</xsl:variable> + + <xsl:for-each select="javaee:tag | tag"> + + <!--xsl:value-of select="./name/text()" /--> + + <xsl:if test="not(contains($excluded-tag-names, javaee:name))"> + <xsl:call-template name="tag" /> + </xsl:if> + <xsl:if test="not(contains($excluded-tag-names, ./name/text()))"> + <xsl:call-template name="tag" /> + </xsl:if> + </xsl:for-each> + </xsl:template> + + <xsl:template name="tag"> + <section role="NotInToc"> + <xsl:variable name="tag_name"> + <xsl:choose> + <xsl:when test="javaee:name"> + <xsl:value-of select="javaee:name" /> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="./name/text()" /> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:variable name="prefix"> + <xsl:choose> + <xsl:when test="/javaee:taglib/javaee:short-name"> + <xsl:value-of select="/javaee:taglib/javaee:short-name" /> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="/taglib/short-name/text()" /> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:attribute name="id"><xsl:value-of select="$tag_name"/></xsl:attribute> + <title>&lt;<xsl:value-of select="concat($prefix,':', $tag_name)" />&gt;</title> + <xsl:for-each select="document(concat($lang, $separator,'included',$separator,$tag_name, '.desc.xml'))/*"> + <xsl:copy-of select="./*"/> + </xsl:for-each> + <table> + <title><xsl:value-of select="$prefix"/>:<xsl:value-of select="javaee:name"/><xsl:value-of select="name"/> attributes</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Attribute Name</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <xsl:for-each select="javaee:attribute | attribute"> + <row> + <entry> + <xsl:value-of select="javaee:name"/> + <xsl:value-of select="name"/> + </entry> + <entry> + <xsl:value-of select="javaee:description" disable-output-escaping="yes"/> + <xsl:value-of select="description" disable-output-escaping="yes"/> + </entry> + </row> + </xsl:for-each> + </tbody> + </tgroup> + </table> + <xsl:for-each select="document(concat($lang, $separator,'included',$separator,$tag_name, '.xml'))/*"> + <xsl:copy-of select="./*"/> + </xsl:for-each> + </section> + </xsl:template> +</xsl:transform> \ No newline at end of file Copied: trunk/docs/xslt/src/main/xslt/fopdf.xsl (from rev 1636, trunk/docs/xslt/src/main/resources/en/fopdf.xsl) =================================================================== --- trunk/docs/xslt/src/main/xslt/fopdf.xsl (rev 0) +++ trunk/docs/xslt/src/main/xslt/fopdf.xsl 2007-07-16 21:32:03 UTC (rev 1640) @@ -0,0 +1,543 @@ +<?xml version="1.0"?> + +<!-- + This was originally the XSL FO configuration file for the Hibernate + Reference Documentation. It defines a custom titlepage and + the parameters for the A4 sized PDF printable output. It is released + under the LGPL. + + Modifications were made to better suit the needs of the JBoss documentation. +--> + +<!DOCTYPE xsl:stylesheet [ + <!ENTITY db_xsl_path "../support/docbook-xsl"> +]> + +<xsl:stylesheet version="1.0" xmlns="http://www.w3.org/TR/xhtml1/transitional" + xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:fo="http://www.w3.org/1999/XSL/Format" exclude-result-prefixes="#default"> + + + <!-- assume catalog-based resolution... --> + <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.... /> + + + <!-- ########## XRef --> + <!-- this controls whether xrefs have the title in it. We + don't want that --> + <xsl:param name="xref.with.number.and.title" select="0"/> + + <xsl:template match="processing-instruction('lb')"> + <fo:block> + <xsl:text> </xsl:text> + </fo:block> + </xsl:template> + + <!--########## 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"> + <xsl:if test="bookinfo/mediaobject"> + <fo:block> + <fo:external-graphic> + <xsl:attribute name="src"> + FILE:<xsl:value-of + select="bookinfo/mediaobject/imageobject/imagedata/@fileref" /> + </xsl:attribute> + </fo:external-graphic> + </fo:block> + </xsl:if> + <xsl:if test="bookinfo/title"> + <fo:block font-family="Helvetica" font-size="22pt" padding-before="10mm"> + <xsl:value-of select="bookinfo/title"/> + </fo:block> + </xsl:if> + <xsl:if test="bookinfo/subtitle"> + <fo:block font-family="Helvetica" font-size="18pt" padding-before="10mm"> + <xsl:value-of select="bookinfo/subtitle"/> + </fo:block> + </xsl:if> + <xsl:if test="bookinfo/releaseinfo"> + <fo:block font-family="Helvetica" font-size="12pt" + padding="10mm"><xsl:value-of select="bookinfo/releaseinfo"/> + </fo:block> + </xsl:if> + <xsl:if test="bookinfo/copyright"> + <fo:block font-family="Helvetica" font-size="12pt" + padding="10mm"> + + <xsl:apply-templates select="bookinfo/copyright" + mode="titlepage.mode"/> + </fo:block> + </xsl:if> + </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 name="book.titlepage.verso"/> + <xsl:template name="book.titlepage.separator"/> + + + <!--################################################### + 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 name="margin-left">-5em</xsl:attribute> + <xsl:attribute name="margin-right">-5em</xsl:attribute> + </xsl:attribute-set> + + + <!--################################################### + Custom Footer + ################################################### --> + <!-- This footer prints the Hibernate version number on the left side --> + <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:choose> + <xsl:when test="//releaseinfo"> + <xsl:text>JBoss </xsl:text> + <xsl:value-of select="//releaseinfo"/> + </xsl:when> + <xsl:otherwise> + <!-- nop --> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:choose> + <xsl:when test="$sequence='blank'"> + <xsl:choose> + <xsl:when test="$double.sided != 0 and $position = 'left'"> + <xsl:value-of select="$Version"/> + </xsl:when> + <xsl:when test="$double.sided = 0 and $position = 'center'"> + <!-- nop --> + </xsl:when> + <xsl:otherwise> + <fo:page-number/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="$pageclass='titlepage'"> + <!-- nop: other titlepage sequences have no footer --> + </xsl:when> + <xsl:when test="$double.sided != 0 and $sequence = 'even' and $position='left'"> + <fo:page-number/> + </xsl:when> + <xsl:when test="$double.sided != 0 and $sequence = 'odd' and $position='right'"> + <fo:page-number/> + </xsl:when> + <xsl:when test="$double.sided = 0 and $position='right'"> + <fo:page-number/> + </xsl:when> + <xsl:when test="$double.sided != 0 and $sequence = 'odd' and $position='left'"> + <xsl:value-of select="$Version"/> + </xsl:when> + <xsl:when test="$double.sided != 0 and $sequence = 'even' and $position='right'"> + <xsl:value-of select="$Version"/> + </xsl:when> + <xsl:when test="$double.sided = 0 and $position='left'"> + <xsl:value-of select="$Version"/> + </xsl:when> + <xsl:otherwise> + <!-- nop --> + </xsl:otherwise> + </xsl:choose> + </xsl:template> + + + + <!--################################################### + Custom Toc Line + ################################################### --> + <!-- Improve the TOC. --> + <xsl:template name="toc.trt"> + <xsl:variable name="id"> + <xsl:call-template name="object.id"/> + </xsl:variable> + <xsl:variable name="label"> + <xsl:apply-templates select="." mode="label.markup"/> + </xsl:variable> + <fo:block text-align-last="justify" end-indent="{$toc.indent.width}pt" last-line-end-indent="-{$toc.indent.width}pt"> + <fo:inline keep-with-next.within-line="always"> + <fo:basic-link internal-destination="{$id}"> + <!-- Chapter titles should be bold. --> + <xsl:choose> + <xsl:when test="local-name(.) = 'chapter'"> + <xsl:attribute name="font-weight">bold</xsl:attribute> + </xsl:when> + </xsl:choose> + <xsl:if test="$label != ''"> + <xsl:copy-of select="$label"/> + <xsl:value-of select="$autotoc.label.separator"/> + </xsl:if> + <xsl:apply-templates select="." mode="titleabbrev.markup"/> + </fo:basic-link> + </fo:inline> + <fo:inline keep-together.within-line="always"> + <xsl:text/> + <fo:leader leader-pattern="dots" leader-pattern-width="3pt" + leader-alignment="reference-area" keep-with-next.within-line="always"/> + <xsl:text/> + <fo:basic-link internal-destination="{$id}"> + <fo:page-number-citation ref-id="{$id}"/> + </fo:basic-link> + </fo:inline> + </fo:block> + </xsl:template> + + + <!--################################################### + Extensions + ################################################### --> + <!-- These extensions are required for table printing and other stuff --> + <xsl:param name="use.extensions">1</xsl:param> + + <xsl:param name="linenumbering.extension">1</xsl:param> + <xsl:param name="linenumbering.everyNth">1</xsl:param> + <xsl:param name="linenumbering.separator">: </xsl:param> + + <xsl:param name="tablecolumns.extension">0</xsl:param> + <!-- FOP provide only PDF Bookmarks at the moment --> + <xsl:param name="fop.extensions">1</xsl:param> + + + + <!--################################################### + Table Of Contents + ################################################### --> + <!-- Generate the TOCs for named components only --> + <xsl:param name="generate.toc"> book toc,title</xsl:param> + <!-- ,figure,table,equation --> + <!-- Show only Sections up to level 3 in the TOCs --> + <xsl:param name="toc.section.depth">3</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="page.margin.top">5mm</xsl:param> + <xsl:param name="region.before.extent">10mm</xsl:param> + <xsl:param name="body.margin.top">10mm</xsl:param> + <xsl:param name="body.margin.bottom">15mm</xsl:param> + <xsl:param name="region.after.extent">10mm</xsl:param> + <xsl:param name="page.margin.bottom">0mm</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 + ################################################### --> + <!-- Default Font size --> + <xsl:param name="body.font.master">11</xsl:param> + <!-- Line height in body text --> + <xsl:param name="line-height">1.4</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.8em</xsl:attribute> + </xsl:attribute-set> + + + <!--################################################### + Tables + ################################################### --> + <!-- The table width should be adapted to the paper size --> + <xsl:param name="default.table.width">17.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 + ################################################### --> + + <xsl:attribute-set name="chapter.titlepage.recto.style"> + <xsl:attribute name="text-align">right</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> + + + <xsl:attribute-set name="appendix.titlepage.recto.style"> + <xsl:attribute name="text-align">right</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> + + <xsl:template name="appendix.titlepage.before.recto"> + <xsl:param name="node" select="ancestor-or-self::appendix[1]"/> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" + text-align="right" + font-size="72pt" font-weight="bold"> + <xsl:number from="book" format="A"/> + </fo:block> + </xsl:template> + + <xsl:template name="chapter.titlepage.before.recto"> + <xsl:param name="node" select="ancestor-or-self::chapter[1]"/> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" + text-align="right" + font-size="72pt" font-weight="bold"> + <xsl:number from="book" format="1"/> + </fo:block> + </xsl:template> + + <xsl:template match="title" mode="appendix.titlepage.recto.auto.mode"> + <xsl:variable name="titleabbrev"> + <xsl:apply-templates select="ancestor-or-self::appendix[1]" + mode="titleabbrev.markup"/> + </xsl:variable> + + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" + xsl:use-attribute-sets="appendix.titlepage.recto.style"> + <xsl:value-of select="$titleabbrev" /> + </fo:block> + </xsl:template> + + <xsl:template match="title" mode="chapter.titlepage.recto.auto.mode"> + <xsl:variable name="titleabbrev"> + <xsl:apply-templates select="ancestor-or-self::chapter[1]" + mode="titleabbrev.markup"/> + </xsl:variable> + + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" + xsl:use-attribute-sets="chapter.titlepage.recto.style"> + <xsl:value-of select="$titleabbrev" /> + </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> + + + + <!-- ########## blockquote --> + <xsl:attribute-set name="blockquote.properties"> + <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="space-after.minimum">0.1em</xsl:attribute> + <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> + <xsl:attribute name="space-after.maximum">0.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 name="background-color">#F0F0F0</xsl:attribute> + </xsl:attribute-set> + + + + <!--################################################### + Programlistings + ################################################### --> + <!-- Verbatim text formatting (programlistings) --> + <xsl:attribute-set name="verbatim.properties"> + <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="space-after.minimum">0.1em</xsl:attribute> + <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> + <xsl:attribute name="space-after.maximum">0.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 + ################################################### --> + <!-- We want to use callouts... --> + <xsl:param name="callout.extensions">1</xsl:param> + <!-- Place callout bullets at this column in programmlisting.--> + <xsl:param name="callout.defaultcolumn">90</xsl:param> + <!-- + No, don't use crappy graphics for the callout bullets. This setting + enables some weird Unicode rendering for some fancy bullet points + in callouts. By default, this can only count to 10 and produces + strange results if you ever have more than 10 callouts for one + programlisting. We will fix that next. + --> + <xsl:param name="callout.graphics">0</xsl:param> + <!-- + Again, fun with DocBook XSL: The callout bullets are rendered in + two places: In the programlisting itself and in the list below + the listing, with the actual callout text. The rendering in the + programlisting is some XSL transformer extension (e.g. a Saxon + extension), so we can't change that without messing with the + extensions. We only can turn it off by setting this limit to + zero, then, a simple bracket style like "(3)" and "(4)" will + be used in the programlisting. + --> + <xsl:param name="callout.unicode.number.limit" select="'0'"/> + <!-- + The callout bullets in the actual callout list will be rendered + with an XSL FO template. The default template is broken: limited to 10 + nice looking Unicode bullet points and then it doesn't print anything, + the fallback doesn't work. We implement our own template, which is not + as complicated, more ugly, but works. As always, function is more + important than form. + --> + <xsl:template name="callout-bug"> + <xsl:param name="conum" select="1"/> + <fo:inline color="black" padding-top="0.1em" padding-bottom="0.1em" + padding-start="0.2em" padding-end="0.2em" baseline-shift="0.1em" + font-family="{$monospace.font.family}" font-weight="bold" font-size="75%"> + <xsl:text>(</xsl:text> + <xsl:value-of select="$conum"/> + <xsl:text>)</xsl:text> + </fo:inline> + </xsl:template> + + + + <!--################################################### + Misc + ################################################### --> + <!-- Correct placement of titles for figures and examples. --> + <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, this is much better. --> + <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> + <!-- Newer DocBook XSL apparently thinks that some sections are by + default "draft" status, and this idiotic thing is by default + also set to "maybe", so it spits out a lot of errors with the + latest FOP as the XSL/FO styles have references to some draft + watermarks, which you actually don't want in the first place. + Turn this crap off. If you have to work with the "status" + attribute, don't. + --> + <xsl:param name="draft.mode" select="'no'"/> + +</xsl:stylesheet> Copied: trunk/docs/xslt/src/main/xslt/html.xsl (from rev 1636, trunk/docs/xslt/src/main/resources/en/html.xsl) =================================================================== --- trunk/docs/xslt/src/main/xslt/html.xsl (rev 0) +++ trunk/docs/xslt/src/main/xslt/html.xsl 2007-07-16 21:32:03 UTC (rev 1640) @@ -0,0 +1,86 @@ +<?xml version="1.0"?> + +<!-- + + This is the XSL HTML configuration file for the Hibernate + Reference Documentation. + + It took me days to figure out this stuff and fix most of + the obvious bugs in the DocBook XSL distribution. Some of + the workarounds might not be appropriate with a newer version + of DocBook XSL. This file is released as part of Hibernate, + hence LGPL licensed. + + christian(a)hibernate.org +--> + +<!DOCTYPE xsl:stylesheet [ + <!ENTITY db_xsl_path "../support/docbook-xsl"> +]> + +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0" + xmlns="http://www.w3.org/TR/xhtml1/transitional" + exclude-result-prefixes="#default"> + +<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/docboo... + +<!--################################################### + HTML Settings + ################################################### --> + + <xsl:param name="html.stylesheet">css/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 + ################################################### --> + + <!-- Don't use graphics, use a simple number style --> + <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> + +<!--################################################### + 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="section[@role = 'NotInToc']//*" mode="toc" /> + <xsl:template match="chapter[@role = 'NotInToc']//section//*" mode="toc" /> + +</xsl:stylesheet> Copied: trunk/docs/xslt/src/main/xslt/html_chunk.xsl (from rev 1636, trunk/docs/xslt/src/main/resources/en/html_chunk.xsl) =================================================================== --- trunk/docs/xslt/src/main/xslt/html_chunk.xsl (rev 0) +++ trunk/docs/xslt/src/main/xslt/html_chunk.xsl 2007-07-16 21:32:03 UTC (rev 1640) @@ -0,0 +1,88 @@ +<?xml version="1.0"?> + +<!-- + + This is the XSL HTML configuration file for the Hibernate + Reference Documentation. + + It took me days to figure out this stuff and fix most of + the obvious bugs in the DocBook XSL distribution. Some of + the workarounds might not be appropriate with a newer version + of DocBook XSL. This file is released as part of Hibernate, + hence LGPL licensed. + + christian(a)hibernate.org +--> + +<!DOCTYPE xsl:stylesheet [ + <!ENTITY db_xsl_path "../support/docbook-xsl"> +]> + +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0" + xmlns="http://www.w3.org/TR/xhtml1/transitional" + exclude-result-prefixes="#default"> + +<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/chunk.... + +<!--################################################### + HTML Settings + ################################################### --> + + <xsl:param name="chunk.section.depth">'5'</xsl:param> + <xsl:param name="use.id.as.filename">'1'</xsl:param> + <xsl:param name="html.stylesheet">css/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 + ################################################### --> + + <!-- Don't use graphics, use a simple number style --> + <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> + +<!--################################################### + 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="section[@role = 'NotInToc']//*" mode="toc" /> + <xsl:template match="chapter[@role = 'NotInToc']//section//*" mode="toc" /> + +</xsl:stylesheet>