mirror of
https://github.com/apache/httpd.git
synced 2025-06-01 23:21:45 +03:00
891555dc16
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@421072 13f79535-47bb-0310-9956-ffa450edef68
1157 lines
41 KiB
XML
1157 lines
41 KiB
XML
<?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.
|
|
-->
|
|
|
|
<!DOCTYPE xsl:stylesheet [
|
|
<!ENTITY nbsp SYSTEM "util/nbsp.xml">
|
|
<!ENTITY lf SYSTEM "util/lf.xml">
|
|
]>
|
|
<xsl:stylesheet version="1.0"
|
|
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
|
xmlns="http://www.w3.org/1999/xhtml">
|
|
|
|
<!-- -->
|
|
<!-- Please, don't hard-code output strings! Use the language -->
|
|
<!-- files and the translation "stuff"... -->
|
|
<!-- -->
|
|
|
|
<!-- Injected variables: -->
|
|
<!-- $is-chm - (boolean) target is for CHM generation or not -->
|
|
<!-- $is-zip - (boolean) target is for ZIP generation or not -->
|
|
<!-- $message - (node-set) localized common text snippets -->
|
|
<!-- $doclang - (string) document language -->
|
|
<!-- $output-encoding - (string) MIME charset name of the output -->
|
|
<!-- encoding -->
|
|
|
|
<!-- Constants used for case translation -->
|
|
<xsl:variable name="lowercase" select="'abcdefghijklmnopqrstuvwxyz'" />
|
|
<xsl:variable name="uppercase" select="'ABCDEFGHIJKLMNOPQRSTUVWXYZ'" />
|
|
|
|
<!-- space separated list of blockelements defined in common.dtd -->
|
|
<!-- used for inline content catching in <example>s -->
|
|
<xsl:variable name="blockelements">
|
|
p example note table ul ol dl pre img blockquote
|
|
</xsl:variable>
|
|
|
|
<!-- relative path to /manual/ -->
|
|
<xsl:variable name="metafile" select="document(/*/@metafile)/metafile" />
|
|
<xsl:variable name="path" select="$metafile/relpath" />
|
|
|
|
<!-- load outsourced page types -->
|
|
<xsl:include href="moduleindex.xsl" />
|
|
<xsl:include href="directiveindex.xsl" />
|
|
<xsl:include href="manualpage.xsl" />
|
|
<xsl:include href="synopsis.xsl" />
|
|
<xsl:include href="sitemap.xsl" />
|
|
<xsl:include href="indexpage.xsl" />
|
|
<xsl:include href="quickreference.xsl" />
|
|
<xsl:include href="faq.xsl" />
|
|
|
|
<!-- load utility snippets -->
|
|
<xsl:include href="util/modtrans.xsl" />
|
|
|
|
<!-- make sure, we set relative anchors only, if we're actually -->
|
|
<!-- transforming a modulefile (see <directive> template) -->
|
|
<xsl:variable name="in-modulesynopsis" select="boolean(/modulesynopsis)" />
|
|
|
|
<!-- when referencing to a directory, we may need to complete the path -->
|
|
<!-- with the index file (for offline applications like *.chm files) -->
|
|
<xsl:variable name="index-file">
|
|
<xsl:if test="$is-chm or $is-zip">index.html</xsl:if>
|
|
</xsl:variable>
|
|
|
|
<!-- it may be desired to open external targets in a new window -->
|
|
<xsl:variable name="ext-target" select="boolean($is-chm)" />
|
|
|
|
<!-- #################################################################### -->
|
|
<!-- Utility templates for constructing pages -->
|
|
<!-- #################################################################### -->
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- HTML head -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template name="head">
|
|
<head>
|
|
<!-- the meta element is necessary for offline handling like CHM -->
|
|
<xsl:choose>
|
|
<xsl:when test="$is-chm or $is-zip">
|
|
<meta http-equiv="Content-Type"
|
|
content="text/html; charset={$output-encoding}" />
|
|
</xsl:when>
|
|
<xsl:otherwise>
|
|
<xsl:comment>
|
|
&lf;
|
|
<xsl:text> </xsl:text>
|
|
<xsl:text>XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</xsl:text>
|
|
<xsl:text>XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</xsl:text>
|
|
&lf;
|
|
<xsl:text> </xsl:text>
|
|
<xsl:text>This file is generated from xml source: </xsl:text>
|
|
<xsl:text>DO NOT EDIT</xsl:text>
|
|
&lf;
|
|
<xsl:text> </xsl:text>
|
|
<xsl:text>XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</xsl:text>
|
|
<xsl:text>XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</xsl:text>
|
|
&lf;
|
|
<xsl:text> </xsl:text>
|
|
</xsl:comment>
|
|
</xsl:otherwise>
|
|
</xsl:choose>&lf;
|
|
|
|
<title>
|
|
<xsl:choose>
|
|
<xsl:when test="name">
|
|
<xsl:value-of select="name"/>
|
|
</xsl:when>
|
|
|
|
<xsl:otherwise>
|
|
<xsl:value-of select="title"/>
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
|
|
<xsl:text> </xsl:text>
|
|
<xsl:value-of select="normalize-space($message[@id='apachetitle'])"/>
|
|
</title>&lf;
|
|
|
|
<!-- chm files get a slightly different stylesheet -->
|
|
<xsl:choose>
|
|
<xsl:when test="$is-chm">
|
|
<link type="text/css" rel="stylesheet" media="all"
|
|
href="{$path}/style/css/manual-chm.css" />
|
|
</xsl:when>
|
|
<!-- zip packages do also -->
|
|
<xsl:when test="$is-zip">
|
|
<link title="Main stylesheet" type="text/css" media="all"
|
|
rel="stylesheet"
|
|
href="{$path}/style/css/manual-zip.css" />&lf;
|
|
<link title="No Sidebar - Default font size" type="text/css" media="all"
|
|
rel="alternate stylesheet"
|
|
href="{$path}/style/css/manual-zip-100pc.css"/>
|
|
</xsl:when>
|
|
<xsl:otherwise>
|
|
<link title="Main stylesheet" type="text/css" media="all"
|
|
rel="stylesheet"
|
|
href="{$path}/style/css/manual.css" />&lf;
|
|
<link title="No Sidebar - Default font size" type="text/css" media="all"
|
|
rel="alternate stylesheet"
|
|
href="{$path}/style/css/manual-loose-100pc.css"/>
|
|
</xsl:otherwise>
|
|
</xsl:choose>&lf;
|
|
|
|
<link type="text/css" media="print"
|
|
rel="stylesheet"
|
|
href="{$path}/style/css/manual-print.css"/>
|
|
|
|
<!-- chm files do not need a favicon -->
|
|
<xsl:if test="not($is-chm or $is-zip)">&lf;
|
|
<link rel="shortcut icon" href="{$path}/images/favicon.ico" />
|
|
</xsl:if>
|
|
</head>
|
|
</xsl:template>
|
|
<!-- /head -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- page top -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template name="top">
|
|
<div id="page-header">&lf;
|
|
<xsl:call-template name="super-menu" />&lf;
|
|
|
|
<p class="apache">
|
|
<xsl:value-of select="normalize-space($message
|
|
[@id='apachehttpserver'])"/>
|
|
</p>&lf;
|
|
|
|
<img src="{$path}/images/feather.gif" alt="" />
|
|
</div>&lf; <!-- /page-header -->
|
|
|
|
<div class="up">
|
|
<a href="./{$index-file}">
|
|
<xsl:if test="parentdocument">
|
|
<xsl:attribute name="href">
|
|
<xsl:value-of select="parentdocument/@href"/>
|
|
</xsl:attribute>
|
|
|
|
<xsl:call-template name="helper.uri.fix">
|
|
<xsl:with-param name="uri" select="parentdocument/@href" />
|
|
</xsl:call-template>
|
|
</xsl:if>
|
|
|
|
<img src="{$path}/images/left.gif" alt="<-" title="<-" />
|
|
</a>
|
|
</div>&lf;
|
|
|
|
<div id="path">&lf;
|
|
<a href="http://www.apache.org/">
|
|
<xsl:if test="$ext-target">
|
|
<xsl:attribute name="target">_blank</xsl:attribute>
|
|
</xsl:if>
|
|
<xsl:value-of select="$message[@id='apache']" />
|
|
</a>
|
|
|
|
<xsl:text> > </xsl:text>
|
|
|
|
<a href="http://httpd.apache.org/">
|
|
<xsl:if test="$ext-target">
|
|
<xsl:attribute name="target">_blank</xsl:attribute>
|
|
</xsl:if>
|
|
<xsl:value-of select="$message[@id='http-server']" />
|
|
</a>
|
|
|
|
<xsl:text> > </xsl:text>
|
|
|
|
<a href="http://httpd.apache.org/docs/">
|
|
<xsl:if test="$ext-target">
|
|
<xsl:attribute name="target">_blank</xsl:attribute>
|
|
</xsl:if>
|
|
<xsl:value-of select="$message[@id='documentation']" />
|
|
</a>
|
|
|
|
<xsl:if test="not(../indexpage)">
|
|
<xsl:text> > </xsl:text>
|
|
|
|
<a href="{$path}/{$index-file}">
|
|
<xsl:value-of select="$message[@id='version']"/>
|
|
</a>
|
|
</xsl:if>
|
|
|
|
<xsl:if test="../modulesynopsis or ../directiveindex or ../quickreference">
|
|
<xsl:text> > </xsl:text>
|
|
|
|
<a href="./{$index-file}">
|
|
<xsl:value-of select="$message[@id='modules']"/>
|
|
</a>
|
|
</xsl:if>
|
|
|
|
<xsl:if test="parentdocument/text()">
|
|
<xsl:text> > </xsl:text>
|
|
|
|
<a href="{parentdocument/@href}">
|
|
<xsl:call-template name="helper.uri.fix">
|
|
<xsl:with-param name="uri" select="parentdocument/@href"/>
|
|
</xsl:call-template>
|
|
<xsl:value-of select="parentdocument"/>
|
|
</a>
|
|
</xsl:if>
|
|
</div> <!-- /path -->
|
|
</xsl:template>
|
|
<!-- /top -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- out of date -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template name="outofdate">
|
|
<xsl:if test="$metafile/variants/variant[.=$doclang]/@outdated = 'yes'">
|
|
&lf;
|
|
<div class="outofdate">
|
|
<xsl:value-of select="$message[@id='outofdate']"/>
|
|
</div>
|
|
</xsl:if>
|
|
</xsl:template>
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- page bottom -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template name="bottom">
|
|
<xsl:call-template name="langavail">
|
|
<xsl:with-param name="position" select="'bottom'" />
|
|
</xsl:call-template>
|
|
|
|
<div id="footer">&lf;
|
|
<p class="apache">
|
|
<xsl:text>Copyright 2006 The Apache Software Foundation.</xsl:text><br />
|
|
<xsl:value-of select="$message[@id='licensed']"/>
|
|
<xsl:text> </xsl:text>
|
|
|
|
<a href="http://www.apache.org/licenses/LICENSE-2.0">
|
|
<xsl:if test="$ext-target">
|
|
<xsl:attribute name="target">_blank</xsl:attribute>
|
|
</xsl:if>
|
|
<xsl:text>Apache License, Version 2.0</xsl:text>
|
|
</a>
|
|
<xsl:text>.</xsl:text>
|
|
</p>&lf;
|
|
|
|
<xsl:call-template name="super-menu"/>
|
|
|
|
</div> <!-- /footer -->
|
|
</xsl:template>
|
|
<!-- /bottom -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- build an "available languages" section -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template name="langavail">
|
|
<xsl:param name="position" select="'top'" />
|
|
|
|
<xsl:if test="not($is-chm or $is-zip)">
|
|
<div class="{$position}lang">&lf;
|
|
<p>
|
|
<span>
|
|
<xsl:value-of select="$message[@id='langavail']" />
|
|
<xsl:text>: </xsl:text>
|
|
</span>
|
|
|
|
<xsl:for-each select="$metafile/variants/variant">
|
|
<xsl:sort select="." />
|
|
|
|
<a href="{$path}/{.}{$metafile/path}{$metafile/basename}.html">
|
|
<xsl:if test="$metafile/basename = 'index'">
|
|
<xsl:attribute name="href">
|
|
<xsl:value-of
|
|
select="concat($path, '/', ., $metafile/path)" />
|
|
</xsl:attribute>
|
|
</xsl:if>
|
|
<xsl:if test="$doclang != .">
|
|
<xsl:attribute name="hreflang">
|
|
<xsl:value-of select="." />
|
|
</xsl:attribute>
|
|
<xsl:attribute name="rel">alternate</xsl:attribute>
|
|
</xsl:if>
|
|
<xsl:attribute name="title">
|
|
<xsl:value-of select="document(concat('../lang/', .,
|
|
'.xml'))
|
|
/language/messages/message
|
|
[@id='nativename']" />
|
|
</xsl:attribute>
|
|
|
|
|
|
<xsl:value-of select="." />
|
|
|
|
</a>
|
|
<xsl:if test="position() != last()">
|
|
<xsl:text> |
</xsl:text>
|
|
</xsl:if>
|
|
</xsl:for-each>
|
|
</p>&lf;
|
|
</div> <!-- /.{$position}lang -->
|
|
</xsl:if>
|
|
|
|
<xsl:if test="$position = 'top'">
|
|
<xsl:call-template name="outofdate" />
|
|
</xsl:if>
|
|
|
|
</xsl:template>
|
|
<!-- /langavail -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- Process a documentation section -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="section">
|
|
<xsl:call-template name="toplink" />&lf;
|
|
<div class="section">&lf;
|
|
|
|
<!-- Section heading -->
|
|
<h2>
|
|
<xsl:choose>
|
|
<xsl:when test="@id">
|
|
<a id="{@id}" name="{@id}">
|
|
<xsl:apply-templates select="title" mode="print" />
|
|
</a>
|
|
</xsl:when>
|
|
|
|
<xsl:otherwise>
|
|
<xsl:apply-templates select="title" mode="print" />
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</h2>
|
|
|
|
<!-- Section body -->
|
|
<xsl:apply-templates />
|
|
</div> <!-- /.section -->
|
|
</xsl:template>
|
|
<!-- /section -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- handle subsections (lower level headings) -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="section/section">
|
|
<!-- Section heading -->
|
|
<h3>
|
|
<xsl:choose>
|
|
<xsl:when test="@id">
|
|
<a id="{@id}" name="{@id}">
|
|
<xsl:apply-templates select="title" mode="print" />
|
|
</a>
|
|
</xsl:when>
|
|
|
|
<xsl:otherwise>
|
|
<xsl:apply-templates select="title" mode="print" />
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</h3>
|
|
|
|
<!-- Section body -->
|
|
<xsl:apply-templates />
|
|
</xsl:template>
|
|
<!-- /section/section -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- handle subsubsections (h4) -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="section/section/section">
|
|
<!-- Section heading -->
|
|
<h4>
|
|
<xsl:choose>
|
|
<xsl:when test="@id">
|
|
<a id="{@id}" name="{@id}">
|
|
<xsl:apply-templates select="title" mode="print" />
|
|
</a>
|
|
</xsl:when>
|
|
|
|
<xsl:otherwise>
|
|
<xsl:apply-templates select="title" mode="print" />
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</h4>
|
|
|
|
<!-- Section body -->
|
|
<xsl:apply-templates/>
|
|
|
|
</xsl:template>
|
|
<!-- /section/section/section -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- section nesting > h4 is not supported for now -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="section/section/section/section">
|
|
<xsl:message terminate="yes">
|
|
<xsl:text>FATAL: exceeding maximum section nesting level.</xsl:text>
|
|
&lf;&lf;
|
|
<xsl:text>Perhaps you should consider to split your document into</xsl:text>
|
|
&lf;
|
|
<xsl:text>several ones...</xsl:text>
|
|
&lf;
|
|
</xsl:message>
|
|
</xsl:template>
|
|
<!-- /section/section/section/section -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- (sub)section titles -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="section/title" mode="print">
|
|
<xsl:apply-templates/>
|
|
</xsl:template>
|
|
<xsl:template match="section/title" />
|
|
<!-- /section/title -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- generate section index -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="section" mode="index">
|
|
<li>
|
|
<img src="{$path}/images/down.gif" alt="" />
|
|
<xsl:text> </xsl:text>
|
|
<xsl:choose>
|
|
<xsl:when test="@id">
|
|
<a href="#{@id}">
|
|
<xsl:apply-templates select="title" mode="print" />
|
|
</a>
|
|
</xsl:when>
|
|
<xsl:otherwise>
|
|
<xsl:apply-templates select="title" mode="print" />
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</li>&lf;
|
|
</xsl:template>
|
|
<!-- /section index -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- docs super menu -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template name="super-menu">
|
|
<p class="menu">
|
|
<a href="{$path}/mod/{$index-file}">
|
|
<xsl:value-of select="$message[@id='modules']" />
|
|
</a>
|
|
|
|
<xsl:text> | </xsl:text>
|
|
|
|
<a href="{$path}/mod/directives.html">
|
|
<xsl:value-of select="$message[@id='directives']" />
|
|
</a>
|
|
|
|
<xsl:text> | </xsl:text>
|
|
|
|
<a href="{$path}/faq/{$index-file}">
|
|
<xsl:value-of select="$message[@id='faq']" />
|
|
</a>
|
|
|
|
<xsl:text> | </xsl:text>
|
|
|
|
<a href="{$path}/glossary.html">
|
|
<xsl:value-of select="$message[@id='glossary']" />
|
|
</a>
|
|
|
|
<xsl:text> | </xsl:text>
|
|
|
|
<a href="{$path}/sitemap.html">
|
|
<xsl:value-of select="$message[@id='sitemap']" />
|
|
</a>
|
|
</p>
|
|
</xsl:template>
|
|
<!-- /super-menu -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <example> -->
|
|
<!-- iterate over *all* nodes; bare text and other inline stuff is -->
|
|
<!-- wrapped into <p><code>, block level elements (defined in -->
|
|
<!-- $blockelements) are applied "as is" -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:variable name="blocks"
|
|
select="concat(' ', normalize-space($blockelements), ' ')" />
|
|
|
|
<xsl:template match="example">
|
|
<div class="example">
|
|
<xsl:apply-templates select="title" mode="print" />
|
|
|
|
<xsl:for-each select="./node()">
|
|
<xsl:variable name="is-block-node"
|
|
select="boolean(contains($blocks,
|
|
concat(' ', local-name(), ' ')))"/>
|
|
<!-- bb = (number of) blocks nodes before (the current) -->
|
|
<xsl:variable name="bb"
|
|
select="count(preceding-sibling::*[
|
|
contains($blocks,
|
|
concat(' ', local-name(), ' '))])" />
|
|
|
|
<xsl:if test="$is-block-node or position()=last()">
|
|
<xsl:variable name="content">
|
|
<!-- phew. short explanation, what happens here: -->
|
|
<!-- We want to get the inline stuff between the last -->
|
|
<!-- block node and the current node. -->
|
|
<!-- So filter all previous nodes for the condition -->
|
|
<!-- that the number of block nodes of all of *their* -->
|
|
<!-- previous nodes is >= $bb. Hope that helps ;-) -->
|
|
<xsl:apply-templates
|
|
select="preceding-sibling::node()[
|
|
count(preceding-sibling::*[
|
|
contains($blocks,
|
|
concat(' ', local-name(), ' '))])
|
|
>= $bb]" />
|
|
|
|
<xsl:apply-templates
|
|
select="self::node()[not($is-block-node)]" />
|
|
</xsl:variable>
|
|
|
|
<!-- apply bare text only, if it's not only \s or empty -->
|
|
<xsl:if test="not(normalize-space($content) = '')">
|
|
<p><code>
|
|
<!-- same as $content above. xsl:copy-of seems to make -->
|
|
<!-- thread problems with xalan-j ... -->
|
|
<xsl:apply-templates
|
|
select="preceding-sibling::node()[
|
|
count(preceding-sibling::*[
|
|
contains($blocks,
|
|
concat(' ', local-name(),
|
|
' '))])
|
|
>= $bb]" />
|
|
|
|
<xsl:apply-templates
|
|
select="self::node()[not($is-block-node)]" />
|
|
</code></p>
|
|
</xsl:if>
|
|
|
|
<xsl:apply-templates select="self::node()[$is-block-node]" />
|
|
</xsl:if>
|
|
</xsl:for-each>
|
|
<!-- /node() -->
|
|
</div> <!-- /.example -->
|
|
</xsl:template>
|
|
<!-- /example -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- example/title -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="example/title" mode="print">
|
|
<h3>
|
|
<xsl:apply-templates/>
|
|
</h3>
|
|
</xsl:template>
|
|
<xsl:template match="example/title" />
|
|
<!-- /example/title -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- indentations -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="indent">
|
|
<span class="indent">
|
|
<xsl:apply-templates/>
|
|
</span>
|
|
</xsl:template>
|
|
<!-- /indent -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <note> -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="note">
|
|
<div class="note">
|
|
<xsl:if test="@type='warning'">
|
|
<xsl:attribute name="class">warning</xsl:attribute>
|
|
</xsl:if>
|
|
|
|
<xsl:apply-templates/>
|
|
</div>
|
|
</xsl:template>
|
|
<!-- /note -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <note><title> -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="note/title">
|
|
<h3>
|
|
<xsl:apply-templates/>
|
|
</h3>
|
|
</xsl:template>
|
|
<!-- /note/title -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <directive> -->
|
|
<!-- Inserts link to another directive, which might be in another module. -->
|
|
<!-- References are converted into lower case. -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="directive" name="directive">
|
|
<code class="directive">
|
|
<xsl:choose>
|
|
<xsl:when test="@module">
|
|
<xsl:variable name="lowerdirective"
|
|
select="translate(., $uppercase, $lowercase)" />
|
|
|
|
<xsl:choose>
|
|
<xsl:when test="$in-modulesynopsis and @module = /modulesynopsis/name">
|
|
<a href="#{$lowerdirective}">
|
|
<xsl:if test="@type='section'"><</xsl:if>
|
|
<xsl:value-of select="."/>
|
|
<xsl:if test="@type='section'">></xsl:if>
|
|
</a>
|
|
</xsl:when>
|
|
<xsl:otherwise>
|
|
<a href="{$path}/mod/{@module}.html#{$lowerdirective}">
|
|
<xsl:if test="@type='section'"><</xsl:if>
|
|
<xsl:value-of select="."/>
|
|
<xsl:if test="@type='section'">></xsl:if>
|
|
</a>
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</xsl:when>
|
|
|
|
<xsl:otherwise>
|
|
<xsl:if test="@type='section'"><</xsl:if>
|
|
<xsl:value-of select="."/>
|
|
<xsl:if test="@type='section'">></xsl:if>
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</code>
|
|
</xsl:template>
|
|
<!-- /directive -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <module> -->
|
|
<!-- Inserts a link to refereed module -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="module" name="module">
|
|
<code class="module">
|
|
<a href="{$path}/mod/{.}.html">
|
|
<xsl:value-of select="."/>
|
|
</a>
|
|
</code>
|
|
</xsl:template>
|
|
<!-- /module -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <program> -->
|
|
<!-- Inserts a link to referred program -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="program">
|
|
<code class="program">
|
|
<a href="{$path}/programs/{normalize-space(.)}.html">
|
|
<xsl:value-of select="normalize-space(.)" />
|
|
</a>
|
|
</code>
|
|
</xsl:template>
|
|
<!-- /program -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <related> -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="related">
|
|
<table class="related">
|
|
<tr>
|
|
<th>
|
|
<xsl:value-of select="$message[@id='relatedmodules']" />
|
|
</th>
|
|
<th>
|
|
<xsl:value-of select="$message[@id='relateddirectives']" />
|
|
</th>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<xsl:if test="count(modulelist/*) > 0">
|
|
<ul>
|
|
<xsl:apply-templates select="modulelist" />
|
|
</ul>
|
|
</xsl:if>
|
|
</td>
|
|
<td>
|
|
<xsl:if test="count(directivelist/*) > 0">
|
|
<ul>
|
|
<xsl:apply-templates select="directivelist"/>
|
|
</ul>
|
|
</xsl:if>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</xsl:template>
|
|
<!-- /related -->
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- related/modulelist -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="related/modulelist">
|
|
<xsl:for-each select="module">
|
|
<li>
|
|
<xsl:call-template name="module"/>
|
|
</li>
|
|
</xsl:for-each>
|
|
</xsl:template>
|
|
<!-- /related/modulelist -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- related/directivelist -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="related/directivelist">
|
|
<xsl:for-each select="directive">
|
|
<li>
|
|
<xsl:call-template name="directive"/>
|
|
</li>
|
|
</xsl:for-each>
|
|
</xsl:template>
|
|
<!-- /related/directivelist -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <table> -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="table">
|
|
<table>
|
|
<!-- existing border attribute will result in <table class="bordered"> -->
|
|
<xsl:if test="@border">
|
|
<xsl:attribute name="class">bordered</xsl:attribute>
|
|
</xsl:if>
|
|
|
|
<xsl:choose>
|
|
<xsl:when test="@style = 'zebra'">
|
|
<xsl:apply-templates select="tr" mode="zebra-table" />
|
|
</xsl:when>
|
|
<xsl:when test="@style = 'data'">
|
|
<xsl:apply-templates select="tr" mode="data-table" />
|
|
</xsl:when>
|
|
<xsl:otherwise>
|
|
<xsl:apply-templates />
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</table>
|
|
</xsl:template>
|
|
<!-- /table -->
|
|
|
|
<!-- data-table -->
|
|
<xsl:template match="tr" mode="data-table">
|
|
<!-- style="data": fixed font, padding-left and right alignment for <td>s -->
|
|
<xsl:variable name="cross-table" select="boolean(
|
|
preceding-sibling::tr/th[1]|following-sibling::tr/th[1])" />
|
|
|
|
<tr>
|
|
<xsl:for-each select="node()">
|
|
<xsl:choose>
|
|
<xsl:when test="local-name() = 'td'">
|
|
<td class="data">
|
|
<xsl:apply-templates select="*|@*|text()" />
|
|
</td>
|
|
</xsl:when>
|
|
<xsl:when test="local-name() = 'th' and
|
|
(not($cross-table) or
|
|
count(preceding-sibling::*) > 0)">
|
|
<th class="data">
|
|
<xsl:apply-templates select="*|@*|text()" />
|
|
</th>
|
|
</xsl:when>
|
|
<xsl:otherwise>
|
|
<xsl:apply-templates select="self::node()" />
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</xsl:for-each>
|
|
</tr>&lf;
|
|
</xsl:template>
|
|
|
|
|
|
<!-- zebra-table -->
|
|
<xsl:template match="tr" mode="zebra-table">
|
|
<!-- style="zebra": alternating colors per row, i.e. every second row -->
|
|
<!-- gets a class="odd". Header lines (no <td>) get a -->
|
|
<!-- class="header". These lines will be excluded from -->
|
|
<!-- the "odd" line count. That way header lines act -->
|
|
<!-- interjectional, which creates a better visual and -->
|
|
<!-- psychological effect. -->
|
|
<tr>
|
|
<xsl:choose>
|
|
<xsl:when test="count(td) = 0">
|
|
<xsl:attribute name="class">header</xsl:attribute>
|
|
</xsl:when>
|
|
|
|
<xsl:when test="position() mod 2 = (count(preceding-sibling::tr[count(td) = 0]) mod 2)">
|
|
<xsl:attribute name="class">odd</xsl:attribute>
|
|
</xsl:when>
|
|
</xsl:choose>
|
|
|
|
<xsl:apply-templates />
|
|
</tr>&lf;
|
|
</xsl:template>
|
|
<!-- /zebra-table -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <ol> -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="ol">
|
|
<ol>
|
|
<!-- A. B. C. D. (list-style-type="upper-alpha") -->
|
|
<xsl:choose>
|
|
<xsl:when test="@type = 'A'">
|
|
<xsl:attribute name="class">up-A</xsl:attribute>
|
|
</xsl:when>
|
|
<xsl:when test="@type = 'a'">
|
|
<xsl:attribute name="class">lo-A</xsl:attribute>
|
|
</xsl:when>
|
|
</xsl:choose>
|
|
|
|
<xsl:apply-templates/>
|
|
</ol>
|
|
</xsl:template>
|
|
<!-- /ol -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- diverse elements -->
|
|
<!-- Passes through content -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="summary|description|usage|syntax|default">
|
|
<xsl:apply-templates/>
|
|
</xsl:template>
|
|
<!-- /diverse -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <a> -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="a">
|
|
<xsl:choose>
|
|
<xsl:when test="not(@href)">
|
|
<xsl:copy>
|
|
<xsl:apply-templates select="@*|*|text()"/>
|
|
</xsl:copy>
|
|
</xsl:when>
|
|
<xsl:otherwise>
|
|
<a href="@href">
|
|
<xsl:apply-templates select="@*"/>
|
|
<xsl:call-template name="helper.uri.fix">
|
|
<xsl:with-param name="uri" select="@href"/>
|
|
</xsl:call-template>
|
|
|
|
<xsl:apply-templates select="*|text()"/>
|
|
</a>
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</xsl:template>
|
|
<!-- /a -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- toplink -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template name="toplink">
|
|
<div class="top">
|
|
<a href="#page-header"><img src="{$path}/images/up.gif" alt="top" /></a>
|
|
</div>
|
|
</xsl:template>
|
|
<!-- /toplink -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <transnote> -->
|
|
<!-- translator's notes are displayed in a different color -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="transnote">
|
|
<span class="transnote">
|
|
<xsl:text>(</xsl:text>
|
|
<em>
|
|
<xsl:value-of select="$message[@id='transnote']" />
|
|
</em>
|
|
<xsl:text> </xsl:text>
|
|
<xsl:apply-templates />
|
|
<xsl:text>)</xsl:text>
|
|
</span>
|
|
</xsl:template>
|
|
<!-- /transnote -->
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <phonetic> -->
|
|
<!-- phonetics are enclosed in square brackets and displayed in a -->
|
|
<!-- different color -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="phonetic">
|
|
<span class="phonetic">
|
|
<xsl:text>[</xsl:text>
|
|
<xsl:apply-templates />
|
|
<xsl:text>]</xsl:text>
|
|
</span>
|
|
</xsl:template>
|
|
<!-- /phonetic -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- <glossary> -->
|
|
<!-- link to a glossary anchor -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="glossary">
|
|
<xsl:variable name="glosslink">
|
|
<xsl:choose>
|
|
<xsl:when test="@ref">
|
|
<xsl:value-of select="@ref"/>
|
|
</xsl:when>
|
|
<xsl:otherwise>
|
|
<xsl:value-of select="translate(., $uppercase, $lowercase)"/>
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</xsl:variable>
|
|
|
|
<a href="{$path}/glossary.html#{$glosslink}" class="glossarylink">
|
|
<xsl:attribute name="title">
|
|
<xsl:value-of select="$message[@id='glossarylink']" />
|
|
</xsl:attribute>
|
|
<xsl:apply-templates />
|
|
</a>
|
|
</xsl:template>
|
|
<!-- /glossary -->
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- Filter   in text() nodes. -->
|
|
<!-- In some environments this character won't be transformed correctly, -->
|
|
<!-- so we just write it explicitely as " " into the output. -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="text()" name="filter.nbsp">
|
|
<xsl:param name="text" select="." />
|
|
|
|
<xsl:choose>
|
|
<xsl:when test="contains($text, ' ')">
|
|
<xsl:value-of select="substring-before($text, ' ')" />
|
|
|
|
<xsl:call-template name="filter.nbsp">
|
|
<xsl:with-param name="text" select="substring-after($text, ' ')" />
|
|
</xsl:call-template>
|
|
</xsl:when>
|
|
<xsl:otherwise>
|
|
<xsl:value-of select="$text" />
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</xsl:template>
|
|
<!-- /filter.nbsp -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- Process everything else by just passing it through -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="*">
|
|
<xsl:message terminate="yes">
|
|
<xsl:text>Unknown element: </xsl:text>
|
|
<xsl:value-of select="local-name()" />&lf;
|
|
<xsl:text>Is the document valid (try `build validate-xml`)?</xsl:text>
|
|
</xsl:message>
|
|
</xsl:template>
|
|
<xsl:template match="@*">
|
|
<xsl:copy>
|
|
<xsl:apply-templates select="*|@*|text()" />
|
|
</xsl:copy>
|
|
</xsl:template>
|
|
<xsl:template match="br"><br /></xsl:template>
|
|
<xsl:template match="tr"><tr><xsl:apply-templates select="*|@*|text()" /></tr></xsl:template>
|
|
<xsl:template match="th"><th><xsl:apply-templates select="*|@*|text()" /></th></xsl:template>
|
|
<xsl:template match="td"><td><xsl:apply-templates select="*|@*|text()" /></td></xsl:template>
|
|
<xsl:template match="p"><p><xsl:apply-templates select="*|@*|text()" /></p></xsl:template>
|
|
<xsl:template match="ul"><ul><xsl:apply-templates select="*|@*|text()" /></ul></xsl:template>
|
|
<xsl:template match="li"><li><xsl:apply-templates select="*|@*|text()" /></li></xsl:template>
|
|
<xsl:template match="dl"><dl><xsl:apply-templates select="*|@*|text()" /></dl></xsl:template>
|
|
<xsl:template match="dt"><dt><xsl:apply-templates select="*|@*|text()" /></dt></xsl:template>
|
|
<xsl:template match="dd"><dd><xsl:apply-templates select="*|@*|text()" /></dd></xsl:template>
|
|
<xsl:template match="em"><em><xsl:apply-templates select="*|@*|text()" /></em></xsl:template>
|
|
<xsl:template match="strong"><strong><xsl:apply-templates select="*|@*|text()" /></strong></xsl:template>
|
|
<xsl:template match="pre"><pre><xsl:apply-templates select="*|@*|text()" /></pre></xsl:template>
|
|
<xsl:template match="code"><code><xsl:apply-templates select="*|@*|text()" /></code></xsl:template>
|
|
<xsl:template match="var"><var><xsl:apply-templates select="*|@*|text()" /></var></xsl:template>
|
|
<xsl:template match="dfn"><dfn><xsl:apply-templates select="*|@*|text()" /></dfn></xsl:template>
|
|
<xsl:template match="blockquote"><blockquote><xsl:apply-templates select="*|@*|text()" /></blockquote></xsl:template>
|
|
<xsl:template match="q"><q><xsl:apply-templates select="*|@*|text()" /></q></xsl:template>
|
|
<xsl:template match="cite"><cite><xsl:apply-templates select="*|@*|text()" /></cite></xsl:template>
|
|
<xsl:template match="img"><img><xsl:apply-templates select="*|@*|text()" /></img></xsl:template>
|
|
<!-- /pass through -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- create a letter bar -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template name="letter-bar">
|
|
<xsl:param name="letters" />
|
|
<xsl:param name="first" />
|
|
|
|
<xsl:if test="not($first)">
|
|
<xsl:text> | </xsl:text>
|
|
</xsl:if>
|
|
|
|
<a href="#{substring($letters,1,1)}">
|
|
|
|
<xsl:value-of select="substring($letters, 1, 1)" />
|
|
|
|
</a>
|
|
|
|
<xsl:if test="string-length($letters) > 1">
|
|
<xsl:call-template name="letter-bar">
|
|
<xsl:with-param name="letters" select="substring($letters, 2)" />
|
|
<xsl:with-param name="first" select="false()" />
|
|
</xsl:call-template>
|
|
</xsl:if>
|
|
</xsl:template>
|
|
<!-- /letter-bar -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- template(s) for collecting all start letters of directives -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template name="directive-startletters">
|
|
<xsl:param name="directives" />
|
|
|
|
<xsl:call-template name="_squeeze-letters">
|
|
<xsl:with-param name="lastletter" select="''" />
|
|
<xsl:with-param name="letters">
|
|
<xsl:for-each select="$directives">
|
|
<xsl:sort select="name"/>
|
|
<xsl:value-of
|
|
select="translate(substring(normalize-space(name), 1, 1),
|
|
$lowercase, $uppercase)" />
|
|
</xsl:for-each>
|
|
</xsl:with-param>
|
|
</xsl:call-template>
|
|
</xsl:template>
|
|
<!-- /directive-startletters -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- squeeze subsequent letters in a string -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template name="_squeeze-letters">
|
|
<xsl:param name="letters"/>
|
|
<xsl:param name="lastletter"/>
|
|
|
|
<xsl:variable name="current" select="substring($letters, 1, 1)" />
|
|
|
|
<xsl:if test="not($lastletter = $current)">
|
|
<xsl:value-of select="$current" />
|
|
</xsl:if>
|
|
|
|
<xsl:if test="string-length($letters) > 1">
|
|
<xsl:call-template name="_squeeze-letters">
|
|
<xsl:with-param name="letters" select="substring($letters, 2)" />
|
|
<xsl:with-param name="lastletter" select="$current"/>
|
|
</xsl:call-template>
|
|
</xsl:if>
|
|
</xsl:template>
|
|
<!-- /_squeeze-letters -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- fix href and target attribute of an element. -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template name="helper.uri.fix">
|
|
<xsl:param name="uri"/>
|
|
|
|
<xsl:choose>
|
|
<!-- lame is_absolute_uri test -->
|
|
<xsl:when test=" contains($uri, ':')
|
|
and string-length(substring-before($uri, ':')) < 7">
|
|
<xsl:if test="$ext-target">
|
|
<xsl:attribute name="target">_blank</xsl:attribute>
|
|
</xsl:if>
|
|
</xsl:when>
|
|
<xsl:otherwise>
|
|
<xsl:variable name="fragment">
|
|
<xsl:if test="contains($uri, '#')">
|
|
<xsl:value-of select="concat('#', substring-after($uri, '#'))"/>
|
|
</xsl:if>
|
|
</xsl:variable>
|
|
<xsl:variable name="absuri">
|
|
<xsl:choose>
|
|
<xsl:when test="contains($uri, '#')">
|
|
<xsl:value-of select="concat('#', substring-before($uri, '#'))"/>
|
|
</xsl:when>
|
|
<xsl:otherwise>
|
|
<xsl:value-of select="$uri"/>
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</xsl:variable>
|
|
|
|
<xsl:if test="substring($absuri, string-length($uri), 1) = '/'">
|
|
<xsl:attribute name="href">
|
|
<xsl:value-of select="concat($absuri, $index-file, $fragment)"/>
|
|
</xsl:attribute>
|
|
</xsl:if>
|
|
</xsl:otherwise>
|
|
</xsl:choose>
|
|
</xsl:template>
|
|
<!-- /helper.uri.fix -->
|
|
|
|
|
|
<!-- ==================================================================== -->
|
|
<!-- Ignore table hints used for latex -->
|
|
<!-- ==================================================================== -->
|
|
<xsl:template match="columnspec">
|
|
</xsl:template>
|
|
|
|
<xsl:template match="column">
|
|
</xsl:template>
|
|
|
|
</xsl:stylesheet>
|