Stylesheet documentation for: odds.xsl

Description

TEI Utility stylesheet defining templates for use in processing ODD

This software is dual-licensed: 1. Distributed under a Creative Commons Attribution-ShareAlike 3.0 Unported License http://creativecommons.org/licenses/by-sa/3.0/ 2. http://www.opensource.org/licenses/BSD-2-Clause All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. This software is provided by the copyright holders and contributors "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the copyright holder or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.

Author: See AUTHORS

Id: $Id: odds.xsl 12078 2013-05-05 12:51:58Z rahtz $

QName	Namespace
coded	No namespace
includeValList	No namespace
showListRef	No namespace

<xsl:template name="makeDescription">
  <xsl:param name="includeValList">false</xsl:param>
  <xsl:param name="coded">true</xsl:param>
  <xsl:param name="showListRef">true</xsl:param>
  <xsl:variable name="langs">
    <xsl:value-of select="concat(normalize-space(tei:generateDocumentationLang(.)),' ')"/>
  </xsl:variable>
  <xsl:variable name="firstLang">
    <xsl:value-of select="substring-before($langs,' ')"/>
  </xsl:variable>
  <!-- first the gloss -->
  <xsl:call-template name="makeGloss">
    <xsl:with-param name="langs" select="$langs"/>
  </xsl:call-template>
  <!-- now the description -->
  <xsl:choose>
    <xsl:when test="not(tei:desc)">
    </xsl:when>
    <xsl:when test="count(tei:desc)=1">
      <xsl:for-each select="tei:desc">
        <xsl:apply-templates select="." mode="inLanguage"/>
      </xsl:for-each>
    </xsl:when>
    <xsl:when test="tei:desc[@xml:lang=$firstLang]">
      <xsl:for-each select="tei:desc[@xml:lang=$firstLang]">
        <xsl:apply-templates select="." mode="inLanguage"/>
      </xsl:for-each>
    </xsl:when>
    <xsl:otherwise>
      <xsl:variable name="D">
        <xsl:for-each select="tei:desc">
          <xsl:variable name="currentLang">
            <xsl:call-template name="findLanguage"/>
          </xsl:variable>
          <xsl:if test="contains($langs,concat($currentLang,' '))">
            <xsl:apply-templates select="." mode="inLanguage"/>
          </xsl:if>
        </xsl:for-each>
      </xsl:variable>
      <xsl:choose>
        <xsl:when test="$D='' and tei:desc[not(@xml:lang)]">
          <xsl:for-each select="tei:desc[not(@xml:lang)]">
            <xsl:apply-templates select="." mode="inLanguage"/>
          </xsl:for-each>
        </xsl:when>
        <xsl:when test="$coded='false'">
          <xsl:value-of select="$D"/>
        </xsl:when>
        <xsl:otherwise>
          <xsl:copy-of select="$D"/>
        </xsl:otherwise>
      </xsl:choose>
    </xsl:otherwise>
  </xsl:choose>
  <xsl:choose>
    <xsl:when test="$includeValList='false'"/>
    <xsl:when test="tei:valList[@type='open']">
      <xsl:text>
</xsl:text>
      <xsl:sequence select="tei:i18n('Sample values include')"/>
      <xsl:text>: </xsl:text>
      <xsl:for-each select="tei:valList/tei:valItem">
        <xsl:number/>
        <xsl:text>] </xsl:text>
        <xsl:choose>
          <xsl:when test="tei:altIdent=@ident">
            <xsl:value-of select="@ident"/>
          </xsl:when>
          <xsl:when test="tei:altIdent">
            <xsl:value-of select="normalize-space(tei:altIdent)"/>
          </xsl:when>
          <xsl:otherwise>
            <xsl:value-of select="@ident"/>
          </xsl:otherwise>
        </xsl:choose>
        <xsl:variable name="langs">
          <xsl:value-of select="concat(normalize-space(tei:generateDocumentationLang(.)),' ')"/>
        </xsl:variable>
        <xsl:variable name="firstLang">
          <xsl:value-of select="substring-before($langs,' ')"/>
        </xsl:variable>
        <xsl:call-template name="makeGloss">
          <xsl:with-param name="langs" select="$langs"/>
        </xsl:call-template>
        <xsl:if test="following-sibling::tei:valItem">
          <xsl:text>; </xsl:text>
        </xsl:if>
      </xsl:for-each>
    </xsl:when>
    <xsl:when test="tei:valList[@type='semi']">
      <xsl:text>
</xsl:text>
      <xsl:sequence select="tei:i18n('Suggested values include')"/>
      <xsl:text>: </xsl:text>
      <xsl:for-each select="tei:valList/tei:valItem">
        <xsl:number/>
        <xsl:text>] </xsl:text>
        <xsl:choose>
          <xsl:when test="tei:altIdent=@ident">
            <xsl:value-of select="@ident"/>
          </xsl:when>
          <xsl:when test="tei:altIdent">
            <xsl:value-of select="normalize-space(tei:altIdent)"/>
          </xsl:when>
          <xsl:otherwise>
            <xsl:value-of select="@ident"/>
          </xsl:otherwise>
        </xsl:choose>
        <xsl:variable name="langs">
          <xsl:value-of select="concat(normalize-space(tei:generateDocumentationLang(.)),' ')"/>
        </xsl:variable>
        <xsl:variable name="firstLang">
          <xsl:value-of select="substring-before($langs,' ')"/>
        </xsl:variable>
        <xsl:call-template name="makeGloss">
          <xsl:with-param name="langs" select="$langs"/>
        </xsl:call-template>
        <xsl:if test="following-sibling::tei:valItem">
          <xsl:text>; </xsl:text>
        </xsl:if>
      </xsl:for-each>
    </xsl:when>
  </xsl:choose>
  <xsl:if test="tei:listRef and $showListRef='true'">
    <xsl:text> [</xsl:text>
    <xsl:for-each select="tei:listRef/tei:*">
      <xsl:apply-templates select="." mode="weave"/>
      <xsl:if test="following-sibling::tei:*">
        <xsl:text> </xsl:text>
      </xsl:if>
    </xsl:for-each>
    <xsl:text>]</xsl:text>
  </xsl:if>
</xsl:template>

Template

makeDescription

Template

findLanguage

QName	Namespace
langs	No namespace

<xsl:template name="makeGloss">
  <xsl:param name="langs"/>
  <xsl:variable name="firstLang">
    <xsl:value-of select="substring-before($langs,' ')"/>
  </xsl:variable>
  <xsl:choose>
    <xsl:when test="not(tei:gloss)"/>
    <xsl:when test="string-length(tei:gloss[1])=0"/>
    <xsl:when test="count(tei:gloss)=1 and not(tei:gloss[@xml:lang])">
      <xsl:text> (</xsl:text>
      <xsl:apply-templates select="tei:gloss" mode="inLanguage"/>
      <xsl:text>) </xsl:text>
    </xsl:when>
    <xsl:when test="tei:gloss[@xml:lang=$firstLang]">
      <xsl:if test="not(tei:gloss[@xml:lang=$firstLang]='')">
        <xsl:text> (</xsl:text>
        <xsl:apply-templates select="tei:gloss[@xml:lang=$firstLang]" mode="inLanguage"/>
        <xsl:text>) </xsl:text>
      </xsl:if>
    </xsl:when>
    <xsl:otherwise>
      <xsl:variable name="G">
        <xsl:for-each select="tei:gloss">
          <xsl:variable name="currentLang">
            <xsl:call-template name="findLanguage"/>
          </xsl:variable>
          <xsl:if test="contains($langs,concat($currentLang,' '))">
            <xsl:text>(</xsl:text>
            <xsl:apply-templates select="." mode="inLanguage"/>
            <xsl:text>) </xsl:text>
          </xsl:if>
        </xsl:for-each>
      </xsl:variable>
      <xsl:choose>
        <xsl:when test="$G='' and tei:gloss[not(@xml:lang)]">
          <xsl:text> (</xsl:text>
          <xsl:apply-templates select="tei:gloss[not(@xml:lang)]" mode="inLanguage"/>
          <xsl:text>) </xsl:text>
        </xsl:when>
        <xsl:otherwise>
          <xsl:copy-of select="$G"/>
        </xsl:otherwise>
      </xsl:choose>
    </xsl:otherwise>
  </xsl:choose>
</xsl:template>

<xsl:template name="findLanguage">
  <xsl:choose>
    <xsl:when test="@xml:lang">
      <xsl:value-of select="@xml:lang"/>
    </xsl:when>
    <xsl:when test="ancestor::tei:*[@xml:lang]">
      <xsl:value-of select="(ancestor::tei:*[@xml:lang])[1]/@xml:lang"/>
    </xsl:when>
    <xsl:otherwise>
      <xsl:text>en</xsl:text>
    </xsl:otherwise>
  </xsl:choose>
</xsl:template>

QName	Namespace
message	No namespace

<xsl:template name="die">
  <xsl:param name="message"/>
  <xsl:message terminate="yes">
    <xsl:text>Error: odd2odd.xsl: </xsl:text>
    <xsl:value-of select="$message"/>
  </xsl:message>
</xsl:template>

<xsl:template match="@*|text()" mode="justcopy">
  <xsl:copy-of select="."/>
</xsl:template>

<xsl:template match="processing-instruction()" mode="justcopy">
  <xsl:copy-of select="."/>
</xsl:template>

<xsl:template match="*" mode="justcopy">
  <xsl:copy>
    <xsl:apply-templates select="*|@*|processing-instruction()|text()" mode="justcopy"/>
  </xsl:copy>
</xsl:template>

<xsl:template match="a:*" mode="justcopy">
  <xsl:element xmlns="http://relaxng.org/ns/compatibility/annotations/1.0" name="{name()}">
    <xsl:apply-templates select="*|@*|processing-instruction()|text()" mode="justcopy"/>
  </xsl:element>
</xsl:template>

<xsl:template match="rng:*" mode="justcopy">
  <xsl:element xmlns="http://relaxng.org/ns/structure/1.0" name="{local-name()}">
    <xsl:apply-templates select="*|@*|processing-instruction()|text()" mode="justcopy"/>
  </xsl:element>
</xsl:template>

Variable

DEFAULTSOURCE

<xsl:param name="defaultSource"/>

Variable

DEFAULTSOURCE

<xsl:param name="defaultTEIVersion">current</xsl:param>

<xsl:param name="defaultTEIServer">http://www.tei-c.org/Vault/P5/</xsl:param>

<xsl:param name="currentDirectory"/>

<xsl:param name="verbose">false</xsl:param>

Variable

DEFAULTSOURCE

<xsl:param name="configDirectory"/>

<xsl:param name="doclang"/>

Variable

whichSchemaSpec

<xsl:param name="selectedSchema"/>

Parameter	selectedSchema
Key	SCHEMASPECS

<xsl:variable name="whichSchemaSpec">
  <xsl:choose>
    <xsl:when test="$selectedSchema">
      <xsl:value-of select="$selectedSchema"/>
    </xsl:when>
    <xsl:otherwise>
      <xsl:value-of select="key('SCHEMASPECS',1)[1]/@ident"/>
    </xsl:otherwise>
  </xsl:choose>
</xsl:variable>

<xsl:variable name="DEFAULTSOURCE">
  <xsl:choose>
    <xsl:when test="$defaultSource != ''">
      <xsl:value-of select="$defaultSource"/>
    </xsl:when>
    <xsl:when test="$configDirectory != ''">
      <xsl:value-of select="$configDirectory"/>
      <xsl:text>odd/p5subset.xml</xsl:text>
    </xsl:when>
    <xsl:otherwise>
      <xsl:value-of select="$defaultTEIServer"/>
      <xsl:value-of select="$defaultTEIVersion"/>
      <xsl:text>/xml/tei/odd/p5subset.xml</xsl:text>
    </xsl:otherwise>
  </xsl:choose>
</xsl:variable>

Variable	DEFAULTSOURCE
Parameters	currentDirectory; defaultTEIServer; verbose
Template	die

QName	Namespace
e	No namespace

<xsl:function name="tei:workOutSource" as="xs:string*">
  <xsl:param name="e"/>
  <xsl:variable name="loc">
    <xsl:choose>
      <xsl:when test="$e/@source">
        <xsl:value-of select="$e/@source"/>
      </xsl:when>
      <xsl:when test="$e/ancestor::tei:schemaSpec/@source">
        <xsl:value-of select="$e/ancestor::tei:schemaSpec/@source"/>
      </xsl:when>
      <xsl:otherwise>
        <xsl:value-of select="$DEFAULTSOURCE"/>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:variable>
  <xsl:variable name="source">
    <xsl:choose>
      <xsl:when test="starts-with($loc,'/')">
        <xsl:value-of select="$loc"/>
      </xsl:when>
      <xsl:when test="starts-with($loc,'file:')">
        <xsl:value-of select="$loc"/>
      </xsl:when>
      <xsl:when test="starts-with($loc,'http:')">
        <xsl:value-of select="$loc"/>
      </xsl:when>
      <xsl:when test="starts-with($loc,'https:')">
        <xsl:value-of select="$loc"/>
      </xsl:when>
      <xsl:when test="starts-with($loc,'tei:')">
        <xsl:value-of select="replace($loc,'tei:',$defaultTEIServer)"/>
        <xsl:text>/xml/tei/odd/p5subset.xml</xsl:text>
      </xsl:when>
      <xsl:otherwise>
        <xsl:value-of select="$currentDirectory"/>
        <xsl:value-of select="$loc"/>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:variable>
  <xsl:choose>
    <xsl:when test="not(doc-available($source))">
      <xsl:call-template name="die">
        <xsl:with-param name="message">
          <xsl:text>Source </xsl:text>
          <xsl:value-of select="$source"/>
          <xsl:text> not readable</xsl:text>
        </xsl:with-param>
      </xsl:call-template>
    </xsl:when>
    <xsl:otherwise>
      <xsl:if test="$verbose='true'">
        <xsl:message>Setting source document to
          <xsl:value-of select="$source"/>
        </xsl:message>
      </xsl:if>
      <xsl:sequence select="$source"/>
    </xsl:otherwise>
  </xsl:choose>
</xsl:function>

QName	Namespace
message	No namespace

<xsl:function name="tei:message" as="xs:string">
  <xsl:param name="message"/>
  <xsl:message>
    <xsl:copy-of select="$message"/>
  </xsl:message>
  <xsl:text/>
</xsl:function>

QName	Namespace
e	No namespace

<xsl:function name="tei:uniqueName" as="xs:string">
  <xsl:param name="e"/>
  <xsl:for-each select="$e">
    <xsl:sequence select="concat(  if (@ns='http://www.tei-c.org/ns/1.0') then ''  else if (@ns) then @ns  else if (ancestor::tei:schemaSpec/@ns) then  ancestor::tei:schemaSpec/@ns else '',@ident)"/>
  </xsl:for-each>
</xsl:function>

QName	Namespace
e	No namespace

<xsl:function name="tei:generate-nsprefix-schematron" as="xs:string">
  <xsl:param name="e"/>
  <xsl:for-each select="$e">
    <xsl:variable name="myns" select="ancestor::tei:elementSpec/@ns"/>
    <xsl:choose>
      <xsl:when test="not($myns) or $myns='http://www.tei-c.org/ns/1.0'">
        <xsl:text>tei:</xsl:text>
      </xsl:when>
      <xsl:otherwise>
        <xsl:choose>
          <xsl:when test="ancestor::tei:schemaSpec//sch:ns[@uri=$myns]">
            <xsl:value-of select="concat(ancestor::tei:schemaSpec//sch:ns[@uri=$myns]/@prefix,':')"/>
          </xsl:when>
          <xsl:otherwise>
            <xsl:message terminate="yes">schematron rule cannot work out prefix for
              <xsl:value-of select="ancestor::tei:elementSpec/@ident"/>
            </xsl:message>
          </xsl:otherwise>
        </xsl:choose>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:for-each>
</xsl:function>

Variable	whichSchemaSpec
Key	LISTSCHEMASPECS
Parameter	doclang

QName	Namespace
context	No namespace

<xsl:function name="tei:generateDocumentationLang" as="node()*">
  <xsl:param name="context"/>
  <xsl:for-each select="$context">
    <xsl:choose>
      <xsl:when test="key('LISTSCHEMASPECS',$whichSchemaSpec)/@docLang">
        <xsl:value-of select="key('LISTSCHEMASPECS',$whichSchemaSpec)/@docLang"/>
      </xsl:when>
      <xsl:when test="string-length($doclang)>0">
        <xsl:value-of select="$doclang"/>
      </xsl:when>
      <xsl:otherwise>
        <xsl:text>en</xsl:text>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:for-each>
</xsl:function>

<xsl:key match="tei:schemaSpec" name="LISTSCHEMASPECS" use="@ident"/>

Stylesheet documentation generated by <oXygen/>^® XML Editor.

Mode:

Showing:

Description