src/docbkx/resources/xsl/tld.to.docbook.xsl

<?xml version="1.0"?>
<!--
  ~ Licensed to the Apache Software Foundation (ASF) under one
  ~ or more contributor license agreements.  See the NOTICE file
  ~ distributed with this work for additional information
  ~ regarding copyright ownership.  The ASF licenses this file
  ~ to you under the Apache License, Version 2.0 (the
  ~ "License"); you may not use this file except in compliance
  ~ with the License.  You may obtain a copy of the License at
  ~
  ~     http://www.apache.org/licenses/LICENSE-2.0
  ~
  ~ Unless required by applicable law or agreed to in writing,
  ~ software distributed under the License is distributed on an
  ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  ~ KIND, either express or implied.  See the License for the
  ~ specific language governing permissions and limitations
  ~ under the License.
  -->

<!--
   Effects the transformation of taglib XML to DocBook XML.

   Author: Rick Evans (based on Tim 'katentim' Nolan's original stylesheet)
-->
<xsl:stylesheet version="1.0"
                xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                xmlns:xalan="http://xml.apache.org/xalan">

  <xsl:output
    method="xml"
    indent="yes"
    xalan:indent-amount="3"
    omit-xml-declaration="no"/>

  <xsl:param name="title"/>

  <xsl:template match="taglib">
    <xsl:element name="appendix">
      <xsl:attribute name="id">
        <xsl:value-of select="$title"/>
      </xsl:attribute>
      <xsl:element name="title">
        <xsl:value-of select="$title"/>
      </xsl:element>

      <xsl:element name="section">
        <xsl:attribute name="id">
          <xsl:value-of select="$title"/>
          <xsl:text>-intro</xsl:text>
        </xsl:attribute>
        <xsl:element name="title">
          <xsl:text>Introduction</xsl:text>
        </xsl:element>
      </xsl:element>

      <xsl:element name="para">
        <xsl:text>One of the view technologies you can use with Ki
          is Java Server Pages (JSPs). To help you implement views using Java Server Pages,
          Ki provides you with some tags for evaluating errors, setting
          themes and outputting internationalized messages.
        </xsl:text>
      </xsl:element>

      <xsl:element name="para">
        <xsl:text>Please note that the various tags generated by this form tag library
          are compliant with the
        </xsl:text>
        <xsl:element name="ulink">
          <xsl:attribute name="url">
            <xsl:text>http://www.w3.org/TR/xhtml1/</xsl:text>
          </xsl:attribute>
          <xsl:text>XHTML-1.0-Strict specification</xsl:text>
        </xsl:element>
        <xsl:text>and attendant</xsl:text>
        <xsl:element name="ulink">
          <xsl:attribute name="url">
            <xsl:text>http://www.w3.org/TR/xhtml1/dtds.html#a_dtd_XHTML-1.0-Strict</xsl:text>
          </xsl:attribute>
          <xsl:text>DTD</xsl:text>
        </xsl:element>
        <xsl:text>.</xsl:text>
      </xsl:element>

      <xsl:element name="para">
        <xsl:text>This appendix describes the</xsl:text>
        <xsl:element name="literal">
          <xsl:value-of select="$title"/>
        </xsl:element>
        <xsl:text>tag library.</xsl:text>
      </xsl:element>

      <xsl:element name="itemizedlist">
        <xsl:apply-templates select="tag" mode="mini-toc">
          <xsl:sort select="name" order="ascending"/>
        </xsl:apply-templates>
      </xsl:element>
      <xsl:apply-templates select="tag">
        <xsl:sort select="name" order="ascending"/>
      </xsl:apply-templates>
    </xsl:element>
  </xsl:template>

  <xsl:template match="tag" mode="mini-toc">
    <xsl:element name="listitem">
      <xsl:element name="xref">
        <xsl:attribute name="linkend">
          <xsl:call-template name="generate.id">
            <xsl:with-param name="id">
              <xsl:value-of select="./name"/>
            </xsl:with-param>
          </xsl:call-template>
        </xsl:attribute>
      </xsl:element>
    </xsl:element>
  </xsl:template>

  <xsl:template match="tag">
    <xsl:element name="section">
      <xsl:attribute name="id">
        <xsl:call-template name="generate.id">
          <xsl:with-param name="id">
            <xsl:value-of select="./name"/>
          </xsl:with-param>
        </xsl:call-template>
      </xsl:attribute>
      <xsl:element name="title">
        <xsl:text>The</xsl:text>
        <xsl:element name="literal">
          <xsl:value-of select="./name"/>
        </xsl:element>
        <xsl:text>tag</xsl:text>
      </xsl:element>
      <xsl:element name="para">
        <xsl:value-of select="./description"/>
      </xsl:element>
      <xsl:element name="table">
        <xsl:attribute name="id">
          <xsl:call-template name="generate.id">
            <xsl:with-param name="id">
              <xsl:value-of select="./name"/>
            </xsl:with-param>
          </xsl:call-template>
          <xsl:text>.table</xsl:text>
        </xsl:attribute>
        <xsl:element name="title">
          <xsl:text>Attributes</xsl:text>
        </xsl:element>
        <xsl:element name="tgroup">
          <xsl:attribute name="cols">
            <xsl:text>3</xsl:text>
          </xsl:attribute>
          <xsl:element name="colspec">
            <xsl:attribute name="align">
              <xsl:text>center</xsl:text>
            </xsl:attribute>
            <xsl:attribute name="colname">
              <xsl:text>Attribute</xsl:text>
            </xsl:attribute>
          </xsl:element>
          <xsl:element name="colspec">
            <xsl:attribute name="align">
              <xsl:text>center</xsl:text>
            </xsl:attribute>
            <xsl:attribute name="colname">
              <xsl:text>Required</xsl:text>
            </xsl:attribute>
          </xsl:element>
          <xsl:element name="colspec">
            <xsl:attribute name="align">
              <xsl:text>center</xsl:text>
            </xsl:attribute>
            <xsl:attribute name="colname">
              <xsl:text>Runtime.Expression</xsl:text>
            </xsl:attribute>
          </xsl:element>
          <xsl:element name="colspec">
            <xsl:attribute name="align">
              <xsl:text>left</xsl:text>
            </xsl:attribute>
            <xsl:attribute name="colname">
              <xsl:text>Description</xsl:text>
            </xsl:attribute>
          </xsl:element>

          <xsl:element name="thead">
            <xsl:element name="row">
              <xsl:element name="entry">
                <xsl:attribute name="align">
                  <xsl:text>center</xsl:text>
                </xsl:attribute>
                <xsl:text>Attribute</xsl:text>
              </xsl:element>
              <xsl:element name="entry">
                <xsl:attribute name="align">
                  <xsl:text>center</xsl:text>
                </xsl:attribute>
                <xsl:text>Required?</xsl:text>
              </xsl:element>
              <xsl:element name="entry">
                <xsl:attribute name="align">
                  <xsl:text>center</xsl:text>
                </xsl:attribute>
                <xsl:text>Runtime Expression?</xsl:text>
              </xsl:element>
              <xsl:element name="entry">
                <xsl:attribute name="align">
                  <xsl:text>left</xsl:text>
                </xsl:attribute>
                <xsl:text>Description</xsl:text>
              </xsl:element>
            </xsl:element>

          </xsl:element>
          <xsl:element name="tbody">
            <xsl:apply-templates select="attribute">
              <xsl:sort select="name" order="ascending"/>
            </xsl:apply-templates>
          </xsl:element>
        </xsl:element>
      </xsl:element>
    </xsl:element>
  </xsl:template>

  <xsl:template match="attribute">
    <xsl:element name="row">
      <xsl:element name="entry">
        <xsl:element name="para">
          <xsl:value-of select="name"/>
        </xsl:element>
      </xsl:element>
      <xsl:element name="entry">
        <xsl:element name="para">
          <xsl:value-of select="required"/>
        </xsl:element>
      </xsl:element>
      <xsl:element name="entry">
        <xsl:element name="para">
          <xsl:value-of select="rtexprvalue"/>
        </xsl:element>
      </xsl:element>
      <xsl:element name="entry">
        <xsl:element name="para">
          <xsl:value-of select="description"/>
        </xsl:element>
      </xsl:element>
    </xsl:element>
  </xsl:template>

  <xsl:template name="generate.id">
    <xsl:param name="id"/>
    <xsl:value-of select="$title"/>.
    <xsl:value-of select="$id"/>
  </xsl:template>

</xsl:stylesheet>