| 1 | <?xml version='1.0'?>
 | 
|---|
| 2 | <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 | 
|---|
| 3 |                 xmlns:fo="http://www.w3.org/1999/XSL/Format"
 | 
|---|
| 4 |                 xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
 | 
|---|
| 5 |                 exclude-result-prefixes="doc"
 | 
|---|
| 6 |                 version='1.0'>
 | 
|---|
| 7 | 
 | 
|---|
| 8 | <!-- ********************************************************************
 | 
|---|
| 9 |      $Id$
 | 
|---|
| 10 |      ********************************************************************
 | 
|---|
| 11 | 
 | 
|---|
| 12 |      This file is part of the XSL DocBook Stylesheet distribution.
 | 
|---|
| 13 |      See ../README or http://docbook.sf.net/release/xsl/current/ for
 | 
|---|
| 14 |      copyright and other information.
 | 
|---|
| 15 | 
 | 
|---|
| 16 |      ******************************************************************** -->
 | 
|---|
| 17 | 
 | 
|---|
| 18 | <doc:reference xmlns="">
 | 
|---|
| 19 | <referenceinfo>
 | 
|---|
| 20 | <releaseinfo role="meta">
 | 
|---|
| 21 | $Id$
 | 
|---|
| 22 | </releaseinfo>
 | 
|---|
| 23 | <author><surname>Walsh</surname>
 | 
|---|
| 24 | <firstname>Norman</firstname></author>
 | 
|---|
| 25 | <copyright><year>1999</year><year>2000</year><year>2001</year>
 | 
|---|
| 26 | <holder>Norman Walsh</holder>
 | 
|---|
| 27 | </copyright>
 | 
|---|
| 28 | </referenceinfo>
 | 
|---|
| 29 | <title>HTML EBNF Reference</title>
 | 
|---|
| 30 | 
 | 
|---|
| 31 | <partintro>
 | 
|---|
| 32 | <section><title>Introduction</title>
 | 
|---|
| 33 | 
 | 
|---|
| 34 | <para>This is technical reference documentation for the DocBook XSL
 | 
|---|
| 35 | Stylesheets; it documents (some of) the parameters, templates, and
 | 
|---|
| 36 | other elements of the stylesheets.</para>
 | 
|---|
| 37 | 
 | 
|---|
| 38 | <para>This reference describes the templates and parameters relevant
 | 
|---|
| 39 | to formatting EBNF markup.</para>
 | 
|---|
| 40 | 
 | 
|---|
| 41 | <para>This is not intended to be <quote>user</quote> documentation.
 | 
|---|
| 42 | It is provided for developers writing customization layers for the
 | 
|---|
| 43 | stylesheets, and for anyone who's interested in <quote>how it
 | 
|---|
| 44 | works</quote>.</para>
 | 
|---|
| 45 | 
 | 
|---|
| 46 | <para>Although I am trying to be thorough, this documentation is known
 | 
|---|
| 47 | to be incomplete. Don't forget to read the source, too :-)</para>
 | 
|---|
| 48 | </section>
 | 
|---|
| 49 | </partintro>
 | 
|---|
| 50 | </doc:reference>
 | 
|---|
| 51 | 
 | 
|---|
| 52 | <!-- ==================================================================== -->
 | 
|---|
| 53 | 
 | 
|---|
| 54 | <xsl:template match="productionset">
 | 
|---|
| 55 |   <xsl:variable name="id"><xsl:call-template name="object.id"/></xsl:variable>
 | 
|---|
| 56 | 
 | 
|---|
| 57 |   <xsl:choose>
 | 
|---|
| 58 |     <xsl:when test="title">
 | 
|---|
| 59 |       <fo:block id="{$id}" xsl:use-attribute-sets="formal.object.properties">
 | 
|---|
| 60 |         <xsl:call-template name="formal.object.heading">
 | 
|---|
| 61 |           <xsl:with-param name="placement" select="'before'"/>
 | 
|---|
| 62 |         </xsl:call-template>
 | 
|---|
| 63 | 
 | 
|---|
| 64 |         <fo:table table-layout="fixed" width="100%">
 | 
|---|
| 65 |           <fo:table-column column-number="1" column-width="3%"/>
 | 
|---|
| 66 |           <fo:table-column column-number="2" column-width="15%"/>
 | 
|---|
| 67 |           <fo:table-column column-number="3" column-width="5%"/>
 | 
|---|
| 68 |           <fo:table-column column-number="4" column-width="52%"/>
 | 
|---|
| 69 |           <fo:table-column column-number="5" column-width="25%"/>
 | 
|---|
| 70 |           <fo:table-body start-indent="0pt" end-indent="0pt">
 | 
|---|
| 71 |             <xsl:apply-templates select="production|productionrecap"/>
 | 
|---|
| 72 |           </fo:table-body>
 | 
|---|
| 73 |         </fo:table>
 | 
|---|
| 74 |       </fo:block>
 | 
|---|
| 75 |     </xsl:when>
 | 
|---|
| 76 |     <xsl:otherwise>
 | 
|---|
| 77 |       <fo:table id="{$id}" table-layout="fixed" width="100%">
 | 
|---|
| 78 |         <fo:table-column column-number="1" column-width="3%"/>
 | 
|---|
| 79 |         <fo:table-column column-number="2" column-width="15%"/>
 | 
|---|
| 80 |         <fo:table-column column-number="3" column-width="5%"/>
 | 
|---|
| 81 |         <fo:table-column column-number="4" column-width="52%"/>
 | 
|---|
| 82 |         <fo:table-column column-number="5" column-width="25%"/>
 | 
|---|
| 83 |         <fo:table-body start-indent="0pt" end-indent="0pt">
 | 
|---|
| 84 |           <xsl:apply-templates select="production|productionrecap"/>
 | 
|---|
| 85 |         </fo:table-body>
 | 
|---|
| 86 |       </fo:table>
 | 
|---|
| 87 |     </xsl:otherwise>
 | 
|---|
| 88 |   </xsl:choose>
 | 
|---|
| 89 | </xsl:template>
 | 
|---|
| 90 | 
 | 
|---|
| 91 | <xsl:template match="productionset/title">
 | 
|---|
| 92 |   <!-- suppressed -->
 | 
|---|
| 93 | </xsl:template>
 | 
|---|
| 94 | 
 | 
|---|
| 95 | <xsl:template match="production">
 | 
|---|
| 96 |   <xsl:param name="recap" select="false()"/>
 | 
|---|
| 97 |   <xsl:variable name="id"><xsl:call-template name="object.id"/></xsl:variable>
 | 
|---|
| 98 |   <fo:table-row>
 | 
|---|
| 99 |     <fo:table-cell>
 | 
|---|
| 100 |       <fo:block text-align="start">
 | 
|---|
| 101 |         <xsl:text>[</xsl:text>
 | 
|---|
| 102 |         <xsl:number count="production" level="any"/>
 | 
|---|
| 103 |         <xsl:text>]</xsl:text>
 | 
|---|
| 104 |       </fo:block>
 | 
|---|
| 105 |     </fo:table-cell>
 | 
|---|
| 106 |     <fo:table-cell>
 | 
|---|
| 107 |       <fo:block text-align="end">
 | 
|---|
| 108 |         <xsl:choose>
 | 
|---|
| 109 |           <xsl:when test="$recap">
 | 
|---|
| 110 |             <fo:basic-link internal-destination="{$id}"
 | 
|---|
| 111 |                            xsl:use-attribute-sets="xref.properties">
 | 
|---|
| 112 |               <xsl:apply-templates select="lhs"/>
 | 
|---|
| 113 |             </fo:basic-link>
 | 
|---|
| 114 |           </xsl:when>
 | 
|---|
| 115 |           <xsl:otherwise>
 | 
|---|
| 116 |             <fo:wrapper id="{$id}">
 | 
|---|
| 117 |               <xsl:apply-templates select="lhs"/>
 | 
|---|
| 118 |             </fo:wrapper>
 | 
|---|
| 119 |           </xsl:otherwise>
 | 
|---|
| 120 |         </xsl:choose>
 | 
|---|
| 121 |       </fo:block>
 | 
|---|
| 122 |     </fo:table-cell>
 | 
|---|
| 123 |     <fo:table-cell>
 | 
|---|
| 124 |       <fo:block text-align="center">
 | 
|---|
| 125 |         <xsl:copy-of select="$ebnf.assignment"/>
 | 
|---|
| 126 |       </fo:block>
 | 
|---|
| 127 |     </fo:table-cell>
 | 
|---|
| 128 |     <fo:table-cell>
 | 
|---|
| 129 |       <fo:block>
 | 
|---|
| 130 |         <xsl:apply-templates select="rhs"/>
 | 
|---|
| 131 |         <xsl:copy-of select="$ebnf.statement.terminator"/>
 | 
|---|
| 132 |       </fo:block>
 | 
|---|
| 133 |     </fo:table-cell>
 | 
|---|
| 134 |     <fo:table-cell border-start-width="3pt">
 | 
|---|
| 135 |       <fo:block text-align="start">
 | 
|---|
| 136 |         <xsl:choose>
 | 
|---|
| 137 |           <xsl:when test="rhs/lineannotation|constraint">
 | 
|---|
| 138 |             <xsl:apply-templates select="rhs/lineannotation" mode="rhslo"/>
 | 
|---|
| 139 |             <xsl:apply-templates select="constraint"/>
 | 
|---|
| 140 |           </xsl:when>
 | 
|---|
| 141 |           <xsl:otherwise>
 | 
|---|
| 142 |             <xsl:text> </xsl:text>
 | 
|---|
| 143 |           </xsl:otherwise>
 | 
|---|
| 144 |         </xsl:choose>
 | 
|---|
| 145 |       </fo:block>
 | 
|---|
| 146 |     </fo:table-cell>
 | 
|---|
| 147 |   </fo:table-row>
 | 
|---|
| 148 | </xsl:template>
 | 
|---|
| 149 | 
 | 
|---|
| 150 | <xsl:template match="productionrecap">
 | 
|---|
| 151 |   <xsl:variable name="targets" select="key('id',@linkend)"/>
 | 
|---|
| 152 |   <xsl:variable name="target" select="$targets[1]"/>
 | 
|---|
| 153 | 
 | 
|---|
| 154 |   <xsl:if test="count($targets)=0">
 | 
|---|
| 155 |     <xsl:message>
 | 
|---|
| 156 |       <xsl:text>Error: no ID for productionrecap linkend: </xsl:text>
 | 
|---|
| 157 |       <xsl:value-of select="@linkend"/>
 | 
|---|
| 158 |       <xsl:text>.</xsl:text>
 | 
|---|
| 159 |     </xsl:message>
 | 
|---|
| 160 |   </xsl:if>
 | 
|---|
| 161 | 
 | 
|---|
| 162 |   <xsl:if test="count($targets)>1">
 | 
|---|
| 163 |     <xsl:message>
 | 
|---|
| 164 |       <xsl:text>Warning: multiple "IDs" for productionrecap linkend: </xsl:text>
 | 
|---|
| 165 |       <xsl:value-of select="@linkend"/>
 | 
|---|
| 166 |       <xsl:text>.</xsl:text>
 | 
|---|
| 167 |     </xsl:message>
 | 
|---|
| 168 |   </xsl:if>
 | 
|---|
| 169 | 
 | 
|---|
| 170 |   <xsl:apply-templates select="$target">
 | 
|---|
| 171 |     <xsl:with-param name="recap" select="true()"/>
 | 
|---|
| 172 |   </xsl:apply-templates>
 | 
|---|
| 173 | </xsl:template>
 | 
|---|
| 174 | 
 | 
|---|
| 175 | <xsl:template match="lhs">
 | 
|---|
| 176 |   <xsl:apply-templates/>
 | 
|---|
| 177 | </xsl:template>
 | 
|---|
| 178 | 
 | 
|---|
| 179 | <xsl:template match="rhs">
 | 
|---|
| 180 |   <xsl:apply-templates/>
 | 
|---|
| 181 | </xsl:template>
 | 
|---|
| 182 | 
 | 
|---|
| 183 | <xsl:template match="nonterminal">
 | 
|---|
| 184 |   <xsl:variable name="linkend">
 | 
|---|
| 185 |     <xsl:call-template name="xpointer.idref">
 | 
|---|
| 186 |       <xsl:with-param name="xpointer" select="@def"/>
 | 
|---|
| 187 |     </xsl:call-template>
 | 
|---|
| 188 |   </xsl:variable>
 | 
|---|
| 189 | 
 | 
|---|
| 190 |   <xsl:call-template name="check.id.unique">
 | 
|---|
| 191 |     <xsl:with-param name="linkend" select="$linkend"/>
 | 
|---|
| 192 |   </xsl:call-template>
 | 
|---|
| 193 | 
 | 
|---|
| 194 |   <xsl:call-template name="check.idref.targets">
 | 
|---|
| 195 |     <xsl:with-param name="linkend" select="$linkend"/>
 | 
|---|
| 196 |     <xsl:with-param name="element-list">production</xsl:with-param>
 | 
|---|
| 197 |   </xsl:call-template>
 | 
|---|
| 198 | 
 | 
|---|
| 199 |   <!-- If you don't provide content, you can't point outside this doc. -->
 | 
|---|
| 200 |   <xsl:choose>
 | 
|---|
| 201 |     <xsl:when test="*|text()"><!--nop--></xsl:when>
 | 
|---|
| 202 |     <xsl:otherwise>
 | 
|---|
| 203 |       <xsl:if test="$linkend = ''">
 | 
|---|
| 204 |         <xsl:message>
 | 
|---|
| 205 |           <xsl:text>Non-terminals with no content must point to </xsl:text>
 | 
|---|
| 206 |           <xsl:text>production elements in the current document.</xsl:text>
 | 
|---|
| 207 |         </xsl:message>
 | 
|---|
| 208 |         <xsl:message>
 | 
|---|
| 209 |           <xsl:text>Invalid xpointer for empty nt: </xsl:text>
 | 
|---|
| 210 |           <xsl:value-of select="@def"/>
 | 
|---|
| 211 |         </xsl:message>
 | 
|---|
| 212 |       </xsl:if>
 | 
|---|
| 213 |     </xsl:otherwise>
 | 
|---|
| 214 |   </xsl:choose>
 | 
|---|
| 215 | 
 | 
|---|
| 216 |   <xsl:variable name="href">
 | 
|---|
| 217 |     <xsl:choose>
 | 
|---|
| 218 |       <xsl:when test="$linkend != ''">
 | 
|---|
| 219 |         <xsl:variable name="targets" select="key('id',$linkend)"/>
 | 
|---|
| 220 |         <xsl:variable name="target" select="$targets[1]"/>
 | 
|---|
| 221 |         <xsl:call-template name="object.id">
 | 
|---|
| 222 |           <xsl:with-param name="object" select="$target"/>
 | 
|---|
| 223 |         </xsl:call-template>
 | 
|---|
| 224 |       </xsl:when>
 | 
|---|
| 225 |       <xsl:otherwise>
 | 
|---|
| 226 |         <xsl:value-of select="@def"/>
 | 
|---|
| 227 |       </xsl:otherwise>
 | 
|---|
| 228 |     </xsl:choose>
 | 
|---|
| 229 |   </xsl:variable>
 | 
|---|
| 230 | 
 | 
|---|
| 231 |   <fo:basic-link internal-destination="{$href}"
 | 
|---|
| 232 |                  xsl:use-attribute-sets="xref.properties">
 | 
|---|
| 233 |     <xsl:choose>
 | 
|---|
| 234 |       <xsl:when test="*|text()">
 | 
|---|
| 235 |         <xsl:apply-templates/>
 | 
|---|
| 236 |       </xsl:when>
 | 
|---|
| 237 |       <xsl:otherwise>
 | 
|---|
| 238 |         <xsl:choose>
 | 
|---|
| 239 |           <xsl:when test="$linkend != ''">
 | 
|---|
| 240 |             <xsl:variable name="targets" select="key('id',$linkend)"/>
 | 
|---|
| 241 |             <xsl:variable name="target" select="$targets[1]"/>
 | 
|---|
| 242 |             <xsl:apply-templates select="$target/lhs"/>
 | 
|---|
| 243 |           </xsl:when>
 | 
|---|
| 244 |           <xsl:otherwise>
 | 
|---|
| 245 |             <xsl:text>???</xsl:text>
 | 
|---|
| 246 |           </xsl:otherwise>
 | 
|---|
| 247 |         </xsl:choose>
 | 
|---|
| 248 |       </xsl:otherwise>
 | 
|---|
| 249 |     </xsl:choose>
 | 
|---|
| 250 |   </fo:basic-link>
 | 
|---|
| 251 | </xsl:template>
 | 
|---|
| 252 | 
 | 
|---|
| 253 | <xsl:template match="rhs/lineannotation">
 | 
|---|
| 254 |   <!--nop-->
 | 
|---|
| 255 | </xsl:template>
 | 
|---|
| 256 | 
 | 
|---|
| 257 | <xsl:template match="rhs/lineannotation" mode="rhslo">
 | 
|---|
| 258 |   <xsl:text>/* </xsl:text>
 | 
|---|
| 259 |   <xsl:apply-templates/>
 | 
|---|
| 260 |   <xsl:text> */</xsl:text>
 | 
|---|
| 261 | </xsl:template>
 | 
|---|
| 262 | 
 | 
|---|
| 263 | <xsl:template match="constraint">
 | 
|---|
| 264 |   <xsl:call-template name="check.id.unique">
 | 
|---|
| 265 |     <xsl:with-param name="linkend" select="@linkend"/>
 | 
|---|
| 266 |   </xsl:call-template>
 | 
|---|
| 267 | 
 | 
|---|
| 268 |   <xsl:call-template name="check.idref.targets">
 | 
|---|
| 269 |     <xsl:with-param name="linkend" select="@linkend"/>
 | 
|---|
| 270 |     <xsl:with-param name="element-list">constraintdef</xsl:with-param>
 | 
|---|
| 271 |   </xsl:call-template>
 | 
|---|
| 272 | 
 | 
|---|
| 273 |   <xsl:variable name="href">
 | 
|---|
| 274 |     <xsl:variable name="targets" select="key('id',@linkend)"/>
 | 
|---|
| 275 |     <xsl:variable name="target" select="$targets[1]"/>
 | 
|---|
| 276 |     <xsl:call-template name="object.id">
 | 
|---|
| 277 |       <xsl:with-param name="object" select="$target"/>
 | 
|---|
| 278 |     </xsl:call-template>
 | 
|---|
| 279 |   </xsl:variable>
 | 
|---|
| 280 | 
 | 
|---|
| 281 |   <xsl:if test="preceding-sibling::constraint">
 | 
|---|
| 282 |     <fo:inline linefeed-treatment="preserve">
</fo:inline>
 | 
|---|
| 283 |   </xsl:if>
 | 
|---|
| 284 |   <xsl:text>[ </xsl:text>
 | 
|---|
| 285 | 
 | 
|---|
| 286 |   <xsl:choose>
 | 
|---|
| 287 |     <xsl:when test="@role">
 | 
|---|
| 288 |       <xsl:value-of select="@role"/>
 | 
|---|
| 289 |       <xsl:text>: </xsl:text>
 | 
|---|
| 290 |     </xsl:when>
 | 
|---|
| 291 |     <xsl:otherwise>
 | 
|---|
| 292 |       <xsl:variable name="targets" select="key('id',@linkend)"/>
 | 
|---|
| 293 |       <xsl:variable name="target" select="$targets[1]"/>
 | 
|---|
| 294 |       <xsl:if test="$target/@role">
 | 
|---|
| 295 |         <xsl:value-of select="$target/@role"/>
 | 
|---|
| 296 |         <xsl:text>: </xsl:text>
 | 
|---|
| 297 |       </xsl:if>
 | 
|---|
| 298 |     </xsl:otherwise>
 | 
|---|
| 299 |   </xsl:choose>
 | 
|---|
| 300 | 
 | 
|---|
| 301 |   <fo:basic-link internal-destination="{$href}"
 | 
|---|
| 302 |                  xsl:use-attribute-sets="xref.properties">
 | 
|---|
| 303 |     <xsl:variable name="targets" select="key('id',@linkend)"/>
 | 
|---|
| 304 |     <xsl:variable name="target" select="$targets[1]"/>
 | 
|---|
| 305 |     <xsl:apply-templates select="$target" mode="title.markup"/>
 | 
|---|
| 306 |   </fo:basic-link>
 | 
|---|
| 307 |   <xsl:text> ]</xsl:text>
 | 
|---|
| 308 | </xsl:template>
 | 
|---|
| 309 | 
 | 
|---|
| 310 | <xsl:template match="constraintdef">
 | 
|---|
| 311 |   <xsl:variable name="id"><xsl:call-template name="object.id"/></xsl:variable>
 | 
|---|
| 312 |   <fo:block id="{$id}">
 | 
|---|
| 313 |     <xsl:apply-templates/>
 | 
|---|
| 314 |   </fo:block>
 | 
|---|
| 315 | </xsl:template>
 | 
|---|
| 316 | 
 | 
|---|
| 317 | <xsl:template match="constraintdef/title">
 | 
|---|
| 318 |   <fo:block font-weight="bold">
 | 
|---|
| 319 |     <xsl:apply-templates/>
 | 
|---|
| 320 |   </fo:block>
 | 
|---|
| 321 | </xsl:template>
 | 
|---|
| 322 | 
 | 
|---|
| 323 | <!-- ==================================================================== -->
 | 
|---|
| 324 | 
 | 
|---|
| 325 | </xsl:stylesheet>
 | 
|---|