mirror of
				https://github.com/apache/httpd.git
				synced 2025-11-03 17:53:20 +03:00 
			
		
		
		
	git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1740987 13f79535-47bb-0310-9956-ffa450edef68
		
			
				
	
	
		
			410 lines
		
	
	
		
			16 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
			
		
		
	
	
			410 lines
		
	
	
		
			16 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 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">
 | 
						|
 | 
						|
<!-- ==================================================================== -->
 | 
						|
<!-- <quickreference>                                                     -->
 | 
						|
<!-- Builds the directive quickreference page                             -->
 | 
						|
<!-- ==================================================================== -->
 | 
						|
<xsl:template match="quickreference">
 | 
						|
<html xml:lang="{$doclang}" lang="{$doclang}">
 | 
						|
    <xsl:call-template name="head"/>&lf;
 | 
						|
 | 
						|
    <body id="directive-index">&lf;
 | 
						|
        <xsl:call-template name="top"/>&lf;
 | 
						|
 | 
						|
        <xsl:call-template name="retired" />
 | 
						|
 | 
						|
        <div id="preamble">
 | 
						|
            <h1>
 | 
						|
                <xsl:value-of select="title" />
 | 
						|
            </h1>&lf;
 | 
						|
 | 
						|
            <xsl:call-template name="langavail" />&lf;
 | 
						|
 | 
						|
            <xsl:apply-templates select="summary" />
 | 
						|
        </div>&lf; <!-- /#preamble -->
 | 
						|
 | 
						|
        <div id="directive-ref">
 | 
						|
            <xsl:variable name="directives"
 | 
						|
                select="document(document(document(
 | 
						|
                            document($allmodules)/modulefilelist/modulefile
 | 
						|
                        )/*/@metafile)/metafile/@reference)
 | 
						|
                        /modulesynopsis/directivesynopsis[not(@location)]" />
 | 
						|
            <xsl:variable name="modules"
 | 
						|
                select="document(
 | 
						|
                            document($allmodules)/modulefilelist/modulefile
 | 
						|
                        )/modulesynopsis" />
 | 
						|
 | 
						|
            <xsl:variable name="start-letters">
 | 
						|
                <xsl:call-template name="directive-startletters">
 | 
						|
                    <xsl:with-param name="directives" select="$directives" />
 | 
						|
                </xsl:call-template>
 | 
						|
            </xsl:variable>
 | 
						|
 | 
						|
            <table id="legend">&lf;
 | 
						|
            <tr>
 | 
						|
                <td class="letters">
 | 
						|
                    <span>
 | 
						|
                        <xsl:call-template name="letter-bar">
 | 
						|
                            <xsl:with-param name="letters"
 | 
						|
                                select="$start-letters" />
 | 
						|
                            <xsl:with-param name="first" select="true()" />
 | 
						|
                        </xsl:call-template>
 | 
						|
                    </span>
 | 
						|
                </td>&lf;
 | 
						|
                <td>
 | 
						|
                    <table>
 | 
						|
                    <tr>
 | 
						|
                        <th>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='serverconfig']/@letter"/>
 | 
						|
                        </th>
 | 
						|
                        <td>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='serverconfig']"/>
 | 
						|
                        </td>
 | 
						|
                    </tr>&lf;
 | 
						|
                    <tr>
 | 
						|
                        <th>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='virtualhost']/@letter"/>
 | 
						|
                        </th>
 | 
						|
                        <td>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='virtualhost']"/>
 | 
						|
                        </td>
 | 
						|
                    </tr>&lf;
 | 
						|
                    <tr>
 | 
						|
                        <th>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='directory']/@letter"/>
 | 
						|
                        </th>
 | 
						|
                        <td>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='directory']"/>
 | 
						|
                        </td>
 | 
						|
                    </tr>&lf;
 | 
						|
                    <tr>
 | 
						|
                        <th>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='htaccess']/@letter"/>
 | 
						|
                        </th>
 | 
						|
                        <td>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='htaccess']"/>
 | 
						|
                        </td>
 | 
						|
                    </tr>&lf;
 | 
						|
                    <tr>
 | 
						|
                        <th>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='proxy']/@letter"/>
 | 
						|
                        </th>
 | 
						|
                        <td>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='proxy']"/>
 | 
						|
                        </td>
 | 
						|
                    </tr>&lf;
 | 
						|
                    </table>
 | 
						|
                </td>&lf;
 | 
						|
                <td>
 | 
						|
                    <table>
 | 
						|
                    <tr>
 | 
						|
                        <th>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='core']/@letter"/>
 | 
						|
                        </th>
 | 
						|
                        <td>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='core']"/>
 | 
						|
                        </td>
 | 
						|
                    </tr>&lf;
 | 
						|
                    <tr>
 | 
						|
                        <th>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='mpm']/@letter"/>
 | 
						|
                        </th>
 | 
						|
                        <td>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='mpm']"/>
 | 
						|
                        </td>
 | 
						|
                    </tr>&lf;
 | 
						|
                    <tr>
 | 
						|
                        <th>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='base']/@letter"/>
 | 
						|
                        </th>
 | 
						|
                        <td>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='base']"/>
 | 
						|
                        </td>
 | 
						|
                    </tr>&lf;
 | 
						|
                    <tr>
 | 
						|
                        <th>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='extension']/@letter"/>
 | 
						|
                        </th>
 | 
						|
                        <td>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='extension']"/>
 | 
						|
                        </td>
 | 
						|
                    </tr>&lf;
 | 
						|
                    <tr>
 | 
						|
                        <th>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='experimental']/@letter"/>
 | 
						|
                        </th>
 | 
						|
                        <td>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='experimental']"/>
 | 
						|
                        </td>
 | 
						|
                    </tr>&lf;
 | 
						|
                    <tr>
 | 
						|
                        <th>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='external']/@letter"/>
 | 
						|
                        </th>
 | 
						|
                        <td>
 | 
						|
                            <xsl:value-of
 | 
						|
                                select="$message[@id='external']"/>
 | 
						|
                        </td>
 | 
						|
                    </tr>&lf;
 | 
						|
                    </table>
 | 
						|
                </td>
 | 
						|
            </tr>&lf;
 | 
						|
            </table>&lf;
 | 
						|
 | 
						|
            <table class="qref">&lf;
 | 
						|
            <xsl:call-template name="reference-of-letter">
 | 
						|
                <xsl:with-param name="letters-todo" select="$start-letters" />
 | 
						|
                <xsl:with-param name="offset" select="number(0)" />
 | 
						|
                <xsl:with-param name="directives" select="$directives" />
 | 
						|
                <xsl:with-param name="modules" select="$modules" />
 | 
						|
            </xsl:call-template>
 | 
						|
            </table>
 | 
						|
        </div>&lf; <!-- /#directive-ref -->
 | 
						|
 | 
						|
        <xsl:call-template name="bottom"/>&lf;
 | 
						|
    </body>
 | 
						|
</html>
 | 
						|
</xsl:template>
 | 
						|
<!-- /quickreference -->
 | 
						|
 | 
						|
 | 
						|
<!-- ==================================================================== -->
 | 
						|
<!-- the working horse. builds rows of all directives starting with one   -->
 | 
						|
<!-- letter when done, it calls itself to catch the next letter           -->
 | 
						|
<!-- ==================================================================== -->
 | 
						|
<xsl:template name="reference-of-letter">
 | 
						|
<xsl:param name="letters-todo" />
 | 
						|
<xsl:param name="offset" />
 | 
						|
<xsl:param name="directives" />
 | 
						|
<xsl:param name="modules" />
 | 
						|
 | 
						|
<xsl:variable name="letter" select="substring($letters-todo, 1, 1)" />
 | 
						|
 | 
						|
<xsl:for-each
 | 
						|
    select="$directives[$letter=translate(substring(normalize-space(name), 1,1),
 | 
						|
                                          $lowercase,$uppercase)]">
 | 
						|
<xsl:sort select="name" />
 | 
						|
<xsl:sort select="../name" /> <!-- in case of duplicate directives -->
 | 
						|
 | 
						|
    <xsl:choose>
 | 
						|
    <xsl:when test="$modules[name=current()/../name]
 | 
						|
                    /directivesynopsis[name=current()/name]">
 | 
						|
        <xsl:call-template name="reference-of-letter-loop">
 | 
						|
            <xsl:with-param name="letter" select="$letter" />
 | 
						|
            <xsl:with-param name="directive"
 | 
						|
                select="$modules[name=current()/../name]
 | 
						|
                        /directivesynopsis[name=current()/name]" />
 | 
						|
            <xsl:with-param name="offset" select="$offset" />
 | 
						|
            <xsl:with-param name="position" select="position()" />
 | 
						|
        </xsl:call-template>
 | 
						|
    </xsl:when>
 | 
						|
    <xsl:otherwise>
 | 
						|
        <xsl:call-template name="reference-of-letter-loop">
 | 
						|
            <xsl:with-param name="letter" select="$letter" />
 | 
						|
            <xsl:with-param name="directive" select="." />
 | 
						|
            <xsl:with-param name="offset" select="$offset" />
 | 
						|
            <xsl:with-param name="position" select="position()" />
 | 
						|
        </xsl:call-template>
 | 
						|
    </xsl:otherwise>
 | 
						|
    </xsl:choose>
 | 
						|
 | 
						|
</xsl:for-each> <!-- /directives -->
 | 
						|
 | 
						|
<!-- call next letter, if there is -->
 | 
						|
<xsl:if test="string-length($letters-todo) > 1">
 | 
						|
    <xsl:call-template name="reference-of-letter">
 | 
						|
        <xsl:with-param name="letters-todo"
 | 
						|
            select="substring($letters-todo, 2)" />
 | 
						|
        <xsl:with-param name="offset"
 | 
						|
            select="(count($directives[$letter=translate(substring(
 | 
						|
                        normalize-space(name), 1, 1),
 | 
						|
                        $lowercase, $uppercase)])
 | 
						|
                    + $offset) mod 2" />
 | 
						|
        <xsl:with-param name="directives" select="$directives" />
 | 
						|
        <xsl:with-param name="modules" select="$modules" />
 | 
						|
    </xsl:call-template>
 | 
						|
</xsl:if>
 | 
						|
</xsl:template>
 | 
						|
<!-- /reference-of-letter -->
 | 
						|
 | 
						|
 | 
						|
<xsl:template name="reference-of-letter-loop">
 | 
						|
<xsl:param name="directive" />
 | 
						|
<xsl:param name="letter" />
 | 
						|
<xsl:param name="offset" />
 | 
						|
<xsl:param name="position" />
 | 
						|
 | 
						|
    <tr>
 | 
						|
        <xsl:if test="$position mod 2 = $offset">
 | 
						|
            <xsl:attribute name="class">odd</xsl:attribute>
 | 
						|
        </xsl:if>
 | 
						|
 | 
						|
        <td>
 | 
						|
            <a href="{$directive/../name}.html#{
 | 
						|
                        translate($directive/name, $uppercase, $lowercase)}">
 | 
						|
                <xsl:if test="$position = 1">
 | 
						|
                    <xsl:attribute name="id">
 | 
						|
                        <xsl:value-of select="$letter" />
 | 
						|
                    </xsl:attribute>
 | 
						|
                    <xsl:attribute name="name">
 | 
						|
                        <xsl:value-of select="$letter" />
 | 
						|
                    </xsl:attribute>
 | 
						|
                </xsl:if>
 | 
						|
 | 
						|
                <xsl:apply-templates select="$directive/syntax" />
 | 
						|
            </a>
 | 
						|
        </td>
 | 
						|
 | 
						|
        <!-- if the default value contains (at least) one <br />, -->
 | 
						|
        <!-- this probably means that a short explanation follows -->
 | 
						|
        <!-- the actual default value. We cut off the string      -->
 | 
						|
        <!-- after the <br /> so it will not be shown here.       -->
 | 
						|
        <!-- (add the + character instead)                        -->
 | 
						|
        <xsl:variable name="default">
 | 
						|
            <xsl:choose>
 | 
						|
            <xsl:when test="count($directive/default[count(br) > 0])
 | 
						|
                            > 0">
 | 
						|
                <xsl:value-of
 | 
						|
                    select="$directive/default/child::node()
 | 
						|
                            [count(preceding-sibling::*) = 0]" />
 | 
						|
            </xsl:when>
 | 
						|
            <xsl:otherwise>
 | 
						|
                <xsl:value-of select="$directive/default"/>
 | 
						|
            </xsl:otherwise>
 | 
						|
            </xsl:choose>
 | 
						|
        </xsl:variable>
 | 
						|
 | 
						|
        <!-- Now. If the default output is empty, the xslt processor emits -->
 | 
						|
        <!-- <td />. In order to avoid this, we simply emit <td></td>      -->
 | 
						|
        <!-- by ourselves. Crap.                                           -->
 | 
						|
        <xsl:choose>
 | 
						|
        <xsl:when test="not(substring(substring-after(
 | 
						|
                            concat($default, ' '), name),1,20) = '')">
 | 
						|
        <td>
 | 
						|
            <xsl:value-of select="substring(substring-after(concat($default,
 | 
						|
                                  ' '), name),1,20)" />
 | 
						|
 | 
						|
            <xsl:if test="string-length(substring-after(concat($default, ' '),
 | 
						|
                              name)) > 20
 | 
						|
                          or count($directive/default[count(br) > 0])
 | 
						|
                             > 0">
 | 
						|
                <xsl:text> +</xsl:text>
 | 
						|
            </xsl:if>
 | 
						|
        </td>
 | 
						|
        </xsl:when>
 | 
						|
        <xsl:otherwise>
 | 
						|
            <xsl:text disable-output-escaping="yes"><td></td></xsl:text>
 | 
						|
        </xsl:otherwise>
 | 
						|
        </xsl:choose>
 | 
						|
 | 
						|
        <td>
 | 
						|
            <xsl:if test="$directive/contextlist/context
 | 
						|
                          [normalize-space(.)='server config']">
 | 
						|
                <xsl:value-of select="$message[@id='serverconfig']/@letter"/>
 | 
						|
            </xsl:if>
 | 
						|
            <xsl:if test="$directive/contextlist/context
 | 
						|
                          [normalize-space(.)='virtual host']">
 | 
						|
                <xsl:value-of select="$message[@id='virtualhost']/@letter"/>
 | 
						|
            </xsl:if>
 | 
						|
            <xsl:if test="$directive/contextlist/context
 | 
						|
                          [normalize-space(.)='directory']">
 | 
						|
                <xsl:value-of select="$message[@id='directory']/@letter"/>
 | 
						|
            </xsl:if>
 | 
						|
            <xsl:if test="$directive/contextlist/context
 | 
						|
                          [normalize-space(.)='.htaccess']">
 | 
						|
                <xsl:value-of select="$message[@id='htaccess']/@letter"/>
 | 
						|
            </xsl:if>
 | 
						|
            <xsl:if test="$directive/contextlist/context
 | 
						|
                          [normalize-space(.)='proxy section']">
 | 
						|
                <xsl:value-of select="$message[@id='proxy']/@letter"/>
 | 
						|
            </xsl:if>
 | 
						|
        </td>
 | 
						|
        <td>
 | 
						|
            <xsl:choose>
 | 
						|
            <xsl:when test="$directive/../status='External'">
 | 
						|
                <xsl:choose>
 | 
						|
                <xsl:when test="$directive/../status/@href">
 | 
						|
                    <a href="{$directive/../status/@href}">
 | 
						|
                        <xsl:value-of
 | 
						|
                            select="$message[@id='external']/@letter"/>
 | 
						|
                    </a>
 | 
						|
                </xsl:when>
 | 
						|
                <xsl:otherwise>
 | 
						|
                    <xsl:value-of select="$message[@id='external']/@letter"/>
 | 
						|
                </xsl:otherwise>
 | 
						|
                </xsl:choose>
 | 
						|
            </xsl:when>
 | 
						|
            <xsl:otherwise>
 | 
						|
                <xsl:variable name="status" select="translate(
 | 
						|
                    $directive/../status, $uppercase, $lowercase)"/>
 | 
						|
                <xsl:value-of select="$message[@id=$status]/@letter"/>
 | 
						|
            </xsl:otherwise>
 | 
						|
            </xsl:choose>
 | 
						|
        </td>
 | 
						|
    </tr>
 | 
						|
    <tr>
 | 
						|
        <xsl:if test="$position mod 2 = $offset">
 | 
						|
            <xsl:attribute name="class">odd</xsl:attribute>
 | 
						|
        </xsl:if>
 | 
						|
 | 
						|
        <td colspan="4" class="descr">
 | 
						|
            <xsl:choose>
 | 
						|
            <xsl:when test="string-length(normalize-space(
 | 
						|
                                $directive/description)) > 0">
 | 
						|
                <xsl:apply-templates select="$directive/description" />
 | 
						|
            </xsl:when>
 | 
						|
            <xsl:otherwise>
 | 
						|
                <xsl:text>-</xsl:text>
 | 
						|
            </xsl:otherwise>
 | 
						|
            </xsl:choose>
 | 
						|
        </td>
 | 
						|
    </tr>&lf;
 | 
						|
</xsl:template>
 | 
						|
 | 
						|
</xsl:stylesheet>
 |