doc/xslt/xhtml/ebnf.xsl

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