From: André Malo <nd@apache.org>
Date: Tue, 22 Apr 2003 04:45:47 +0000 (+0000)
Subject: - break down the beast into smaller pieces and (try to) make it better readable.
X-Git-Tag: 2.0.46~212
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=477f81045f8a950ca10e434f2408bd0184d90095;p=thirdparty%2Fapache%2Fhttpd.git

- break down the beast into smaller pieces and (try to) make it better readable.
- add license
- fix a small bug, where document sections were not indexed, when a
  translated document was in html format only (affected Japanese only)


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/APACHE_2_0_BRANCH@99504 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/style/chm/hhc.xsl b/docs/manual/style/chm/hhc.xsl
index 0ca6616d2bd..4b8e78d89a8 100644
--- a/docs/manual/style/chm/hhc.xsl
+++ b/docs/manual/style/chm/hhc.xsl
@@ -1,37 +1,98 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml version="1.0"?><!--
+/* ====================================================================
+ * The Apache Software License, Version 1.1
+ *
+ * Copyright (c) 2003 The Apache Software Foundation.  All rights
+ * reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. 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.
+ *
+ * 3. The end-user documentation included with the redistribution,
+ *    if any, must include the following acknowledgment:
+ *       "This product includes software developed by the
+ *        Apache Software Foundation (http://www.apache.org/)."
+ *    Alternately, this acknowledgment may appear in the software itself,
+ *    if and wherever such third-party acknowledgments normally appear.
+ *
+ * 4. The names "Apache" and "Apache Software Foundation" must
+ *    not be used to endorse or promote products derived from this
+ *    software without prior written permission. For written
+ *    permission, please contact apache@apache.org.
+ *
+ * 5. Products derived from this software may not be called "Apache",
+ *    nor may "Apache" appear in their name, without prior written
+ *    permission of the Apache Software Foundation.
+ *
+ * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED 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 APACHE SOFTWARE FOUNDATION OR
+ * ITS 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.
+ * ====================================================================
+ *
+ * This software consists of voluntary contributions made by many
+ * individuals on behalf of the Apache Software Foundation.  For more
+ * information on the Apache Software Foundation, please see
+ * <http://www.apache.org/>.
+ */ -->
 <!DOCTYPE xsl:stylesheet [
-  <!ENTITY lf SYSTEM "../xsl/util/lf.xml">
-  <!ENTITY tab SYSTEM "../xsl/util/tab.xml">
-]>
+    <!ENTITY lf SYSTEM "../xsl/util/lf.xml">
+    <!ENTITY tab SYSTEM "../xsl/util/tab.xml">
 
+    <!ENTITY ul.start SYSTEM "../xsl/util/ul-start.xml">
+    <!ENTITY ul.end SYSTEM   "../xsl/util/ul-end.xml"  >
+    <!ENTITY li.start SYSTEM "../xsl/util/li-start.xml">
+    <!ENTITY li.end SYSTEM   "../xsl/util/li-end.xml"  >
+]>
 <xsl:stylesheet version="1.0"
-              xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
-
-<!--
-    XXX: WARNING! Do not touch anything, especially the whitespaces [1] unless
-    you know, what you're doing. The HTML help compiler parses the TOC file
-    not really as html instead of line by line and takes care of whitespace
-    indentations etc.
-
-    [1] Covered by the &lf; and &tab; entities.
-
-    You have been warned.
--->
-
+              xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                  xmlns="">
+
+<!--                                                                      -->
+<!-- WARNING! Do not touch anything, especially the whitespaces [1]       -->
+<!-- unless you know, what you're doing. The HTML help compiler parses    -->
+<!-- the TOC file not really as html instead of line by line and takes    -->
+<!-- care of whitespace indentations etc.                                 -->
+<!--                                                                      -->
+<!--   [1] Covered by the &lf; and &tab; entities.                        -->
+<!--                                                                      -->
+<!-- You have been warned.                                                -->
+<!--                                                                      -->
+
+<!-- create nodeset for referencing later                                 -->
+<xsl:variable name="not-exists" select="document('')/xsl:stylesheet/xsl:template
+                                        [@name='data']/not-exists/file" />
+
+<xsl:template name="data">
 <!-- documents not converted (yet?). -->
-<xsl:variable name="not-existing">
-  developer/API.xml
-
-  programs/ab.xml
-  programs/apxs.xml
-  programs/dbmmanage.xml
-  programs/htdigest.xml
-  programs/htpasswd.xml
-  programs/logresolve.xml
-  programs/rotatelogs.xml
-  programs/suexec.xml
-  programs/other.xml
-</xsl:variable>
+<not-exists>
+    <file>developer/API.xml</file>
+    <file>programs/ab.xml</file>
+    <file>programs/apxs.xml</file>
+    <file>programs/dbmmanage.xml</file>
+    <file>programs/htdigest.xml</file>
+    <file>programs/htpasswd.xml</file>
+    <file>programs/suexec.xml</file>
+    <file>programs/other.xml</file>
+</not-exists>
+</xsl:template>
 
 <!-- Constants used for case translation -->
 <xsl:variable name="lowercase" select="'abcdefghijklmnopqrstuvwxyz'" />
@@ -46,512 +107,603 @@
 <xsl:variable name="icon.section" select="'35'" />
 <xsl:variable name="icon.directive" select="'41'" />
 <xsl:variable name="icon.commondirective" select="'19'" />
+<!-- this should not happen. this icon is only displayed within the
+     toc view of the help workshop (it's a question mark): -->
+<xsl:variable name="icon.no-anchor" select="'9'" />
 
 <!-- for module-translatename -->
 <xsl:include href="../xsl/util/modtrans.xsl"/>
 
-<!--                                                    -->
-<!-- <sitemap>                                          -->
-<!-- Process an entire document into an HTML page       -->
-<!--                                                    -->
+<!-- ==================================================================== -->
+<!-- <sitemap>                                                            -->
+<!-- Create CHM contents file (toc) from sitemap                          -->
+<!-- The file is an html style text file (see warning on top)             -->
+<!-- ==================================================================== -->
 <xsl:template match="/sitemap">
+
+<!-- html head -->
 <xsl:text>&lt;html&gt;&lt;head&gt;</xsl:text>
-<xsl:text>&lt;title&gt;TOC - Apache HTTP Server Documentation&lt;/title&gt;</xsl:text>
+<xsl:text>&lt;title&gt;Apache HTTP Server Documentation&lt;/title&gt;</xsl:text>
 <xsl:text>&lt;/head&gt;</xsl:text>&lf;
 
 <xsl:text>&lt;body&gt;</xsl:text>&lf;
 
 <!-- toc properties first -->
-<xsl:text>
-&lt;object type="text/site properties"&gt;
-&#9;&lt;param name="Window Styles" value="0x800027"&gt;
-&#9;&lt;param name="Font" value="</xsl:text>
+<xsl:text>&lt;object type="text/site properties"&gt;</xsl:text>&lf;&tab;
+<!-- XXX: that magic value is still obfuscated. Research needed ... -->
+<xsl:text>&lt;param name="Window Styles" value="0x800027"&gt;</xsl:text>&lf;&tab;
+<xsl:text>&lt;param name="Font" value="</xsl:text>
     <xsl:value-of select="$toc-font" />
 <xsl:text>"&gt;</xsl:text>&lf;
 <xsl:text>&lt;/object&gt;</xsl:text>&lf;
 
-<xsl:text>&lt;ul&gt;</xsl:text>&lf;
-
-<!-- index page on top. -->
-<xsl:text>&lt;li&gt;&lt;object type="text/sitemap"&gt;</xsl:text>&lf;&tab;&tab;
+&ul.start; &lf;
 
-  <xsl:text>&lt;param name="Name" value="</xsl:text>
-    <xsl:call-template name="filter.attval">
-      <xsl:with-param name="text" select="$messages/message[@name='apachehttpserver']" />
+    <!-- index page on top. -->
+    &li.start;
+    <xsl:call-template name="object">
+        <xsl:with-param name="name"
+            select="$messages/message[@name='apachehttpserver']" />
+        <xsl:with-param name="href" select="'index.html'" />
+        <xsl:with-param name="indent" select="'&#9;&#9;'" />
     </xsl:call-template>
-  <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;
-
-  <xsl:text>&lt;param name="Local" value="</xsl:text>
-      <xsl:value-of select="'index.html'" />
-  <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;
-
-  <xsl:text>&lt;param name="ImageNumber" value="</xsl:text>
-    <xsl:choose>
-      <xsl:when test="$messages/@lang='en' or (document(document(concat($basedir, 'index.xml'))/*/@metafile)/metafile/variants/variant[.=$messages/@lang and not(@htmlonly='yes')])">
-        <xsl:value-of select="$icon.document" />
-      </xsl:when>
-
-      <xsl:otherwise>
-        <xsl:value-of select="$icon.document.not-translated" />
-      </xsl:otherwise>
-    </xsl:choose>
-  <xsl:text>"&gt;</xsl:text>&lf;&tab;
+    &li.end; &lf;
 
-  <xsl:text>&lt;/object&gt;&lt;/li&gt;</xsl:text>&lf;
+    <!-- iterate over the categories in document order -->
+    <xsl:for-each select="category">
+        &li.start;
+        <xsl:call-template name="folder">
+            <xsl:with-param name="name" select="normalize-space(title)" />
+        </xsl:call-template>&lf;&tab;
 
-<xsl:for-each select="category">
+        &ul.start; &lf;&tab;
+            <xsl:apply-templates select="page" />
+            <xsl:apply-templates select="modulefilelist" />
+        &ul.end; &lf;
+        &li.end; &lf;&tab;
+    </xsl:for-each>&lf;
 
-<xsl:text>&lt;li&gt;&lt;object type="text/sitemap"&gt;</xsl:text>&lf;&tab;&tab;
+&ul.end; &lf;
 
-  <xsl:text>&lt;param name="Name" value="</xsl:text>
-    <xsl:call-template name="filter.attval">
-      <xsl:with-param name="text" select="normalize-space(title)" />
-    </xsl:call-template>
-  <xsl:text>"&gt;</xsl:text>&lf;&tab;
-    <xsl:text>&lt;/object&gt;</xsl:text>&lf;&tab;
+<xsl:text>&lt;/body&gt;&lt;/html&gt;</xsl:text>&lf;
+</xsl:template>
+<!-- /sitemap -->
 
-    <xsl:text>&lt;ul&gt;</xsl:text>&lf;&tab;
 
-      <xsl:for-each select="page">
+<!-- ==================================================================== -->
+<!-- category/page                                                        -->
+<!-- ==================================================================== -->
+<xsl:template match="category/page">
+&li.start;
 
-        <xsl:variable name="local"><xsl:choose>
-          <xsl:when test="not(@href)">
+<!-- document entry, if not href attribute, assume it means "sitemap" -->
+<xsl:call-template name="object">
+    <xsl:with-param name="name">
+        <xsl:choose>
+        <xsl:when test="@href">
+            <xsl:value-of select="normalize-space(.)" />
+        </xsl:when>
+        <xsl:otherwise>
+            <xsl:value-of select="normalize-space($messages/message
+                                                  [@name='sitemap'])" />
+        </xsl:otherwise>
+        </xsl:choose>
+    </xsl:with-param>
+    <xsl:with-param name="href">
+        <xsl:choose>
+        <xsl:when test="not(@href)">
             <xsl:text>sitemap.html</xsl:text>
-          </xsl:when>
-
-          <xsl:when test="contains(@href, '#') and substring(@href, string-length(substring-before(@href, '#')), 1) = '/'">
+        </xsl:when>
+        <xsl:when test="contains(@href, '#')">
             <xsl:value-of select="substring-before(@href, '#')" />
-            <xsl:text>index.html</xsl:text>
-          </xsl:when>
-
-          <xsl:when test="substring(@href,string-length(@href),1) = '/'">
+        </xsl:when>
+        <xsl:otherwise>
             <xsl:value-of select="@href"/>
-            <xsl:text>index.html</xsl:text>
-          </xsl:when>
+        </xsl:otherwise>
+        </xsl:choose>
+    </xsl:with-param>
+    <xsl:with-param name="indent" select="'&#9;&#9;'" />
+</xsl:call-template>
 
-          <xsl:otherwise><xsl:value-of select="@href"/></xsl:otherwise></xsl:choose>
-        </xsl:variable>
+<!-- now try to index the sections of the document -->
+<xsl:apply-templates select="self::page" mode="index" />
 
-        <xsl:variable name="xmlfile-en" select="concat(substring-before($local, '.html'), '.xml')"/>
-        <xsl:variable name="xmlfile-exists" select="boolean(not(contains(concat(' ', normalize-space($not-existing), ' '), concat(' ', $xmlfile-en, ' '))))"/>
+&li.end; &lf;&tab;
+</xsl:template>
+<!-- /category/page -->
 
-        <xsl:text>&lt;li&gt;&lt;object type="text/sitemap"&gt;</xsl:text>&lf;&tab;&tab;
 
-          <xsl:text>&lt;param name="Name" value="</xsl:text>
-            <xsl:call-template name="filter.attval">
-              <xsl:with-param name="text">
-                <xsl:if test="@href">
-                  <xsl:value-of select="normalize-space(.)" />
-                </xsl:if>
-                <xsl:if test="not(@href)">
-                  <xsl:value-of select="normalize-space($messages/message[@name='sitemap'])" />
-                </xsl:if>
-              </xsl:with-param>
+<!-- ==================================================================== -->
+<!-- category/page, mode="index"                                          -->
+<!-- display all section headings of one page                             -->
+<!-- ==================================================================== -->
+<xsl:template match="category/page" mode="index">
+<xsl:variable name="href.offline">
+    <xsl:choose>
+    <xsl:when test="string-length(@href) = 0">
+        <xsl:text>sitemap.html</xsl:text>
+    </xsl:when>
+    <xsl:otherwise>
+        <xsl:call-template name="helper.href.offline">
+            <xsl:with-param name="href" select="@href" />
+        </xsl:call-template>
+    </xsl:otherwise>
+    </xsl:choose>
+</xsl:variable>
+<xsl:variable name="xml"
+    select="concat(substring-before($href.offline, '.html'), '.xml')" />
+
+<xsl:if test="not($xml = $not-exists)">
+    <xsl:variable name="xmlfile">
+        <xsl:variable name="metafile"
+            select="document(document(concat($basedir, $xml))/*/@metafile)
+                    /metafile" />
+        <xsl:choose>
+        <xsl:when test="$metafile/variants/variant[.=$messages/@lang] and not
+                        ($metafile/variants/variant[.=$messages/@lang]
+                         /@htmlonly = 'yes')">
+                <xsl:value-of select="concat($basedir,
+                                   substring-before($xml, '.xml'), $xml-ext)" />
+        </xsl:when>
+        <xsl:otherwise>
+            <xsl:value-of select="concat($basedir, $xml)" />
+        </xsl:otherwise>
+        </xsl:choose>
+    </xsl:variable>
+
+    <xsl:variable name="current" select="document($xmlfile)" />
+
+    <xsl:if test="count($current/*/*[local-name()='section' or
+                                     local-name()='category']) &gt; 1">
+        &lf;&tab;&tab;&tab;
+        &ul.start; &lf;&tab;&tab;&tab;
+
+        <xsl:for-each select="$current/*/*[local-name()='section' or
+                                           local-name()='category']">
+            &li.start;
+
+            <xsl:call-template name="object">
+                <xsl:with-param name="name" select="normalize-space(title)" />
+                <xsl:with-param name="href">
+                    <xsl:if test="@id">
+                        <xsl:value-of
+                            select="concat(substring-before($xml, '.xml'),
+                                           '.html#', @id)" />
+                    </xsl:if>
+                </xsl:with-param>
+                <xsl:with-param name="indent" select="'&#9;&#9;&#9;&#9;'" />
             </xsl:call-template>
-          <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;
-
-          <xsl:text>&lt;param name="Local" value="</xsl:text>
-            <xsl:choose>
-              <xsl:when test="not(@href)">
-                <xsl:text>sitemap.html</xsl:text>
-              </xsl:when>
-
-              <xsl:when test="contains(@href, '#') and substring(@href, string-length(substring-before(@href, '#')), 1) = '/'">
-                <xsl:value-of select="substring-before(@href, '#')" />
-                <xsl:text>index.html#</xsl:text>
-                <xsl:value-of select="substring-after(@href, '#')" />
-              </xsl:when>
-
-              <xsl:when test="substring(@href,string-length(@href),1) = '/'">
-                <xsl:value-of select="@href"/>
-                <xsl:text>index.html</xsl:text>
-              </xsl:when>
-
-              <xsl:otherwise><xsl:value-of select="@href"/></xsl:otherwise>
-            </xsl:choose>
-          <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;
-
-          <xsl:text>&lt;param name="ImageNumber" value="</xsl:text>
-            <xsl:choose>
-              <xsl:when test="$messages/@lang='en' or ($xmlfile-exists and document(document(concat($basedir, $xmlfile-en))/*/@metafile)/metafile/variants/variant[.=$messages/@lang and not(@htmlonly='yes')])">
-                <xsl:value-of select="$icon.document" />
-              </xsl:when>
-
-              <xsl:otherwise>
-                <xsl:value-of select="$icon.document.not-translated" />
-              </xsl:otherwise>
-            </xsl:choose>
-          <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;
-          <xsl:text>&lt;/object&gt;</xsl:text>
-
-          <xsl:if test="$xmlfile-exists">
-            <xsl:variable name="metafile" select="document(document(concat($basedir, $xmlfile-en))/*/@metafile)/metafile" />
-            <xsl:if test="not($metafile/variants/variant[.=$messages/@lang] and $metafile/variants/variant[.=$messages/@lang]/@htmlonly = 'yes')">
-              <xsl:variable name="xmlfile"><xsl:choose>
-                <xsl:when test="$metafile/variants/variant[.=$messages/@lang]">
-                    <xsl:value-of select="concat($basedir, substring-before($local, '.html'), $xml-ext)" />
-                </xsl:when>
-                <xsl:otherwise>
-                    <xsl:value-of select="concat($basedir, substring-before($local, '.html'), '.xml')" />
-                </xsl:otherwise></xsl:choose>
-              </xsl:variable>
-
-              <xsl:variable name="current" select="document($xmlfile)" />
-              <xsl:if test="count($current/*/*[local-name()='section' or local-name()='category']) > 1">&lf;&tab;&tab;&tab;
-
-                <xsl:text>&lt;ul&gt;</xsl:text>&lf;&tab;&tab;&tab;
-
-                  <xsl:for-each select="$current/*/*[local-name()='section' or local-name()='category']">
-                    <xsl:text>&lt;li&gt;&lt;object type="text/sitemap"&gt;</xsl:text>&lf;&tab;&tab;&tab;&tab;
-                      <xsl:text>&lt;param name="Name" value="</xsl:text>
-                        <xsl:call-template name="filter.attval">
-                          <xsl:with-param name="text" select="normalize-space(title)" />
-                        </xsl:call-template>
-                      <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;&tab;
-
-                      <xsl:if test="@id">
-                        <xsl:text>&lt;param name="Local" value="</xsl:text>
-                            <xsl:value-of select="$local" />
-                            <xsl:text>#</xsl:text>
-                            <xsl:value-of select="@id" />
-                        <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;&tab;
-                      </xsl:if>
-
-                      <xsl:text>&lt;param name="ImageNumber" value="</xsl:text>
-                          <xsl:if test="@id"><xsl:value-of select="$icon.section" /></xsl:if>
-                          <xsl:if test="not(@id)">9</xsl:if> <!-- "?" -->
-                      <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;
-                    <xsl:text>&lt;/object&gt;&lt;/li&gt;</xsl:text>&lf;&tab;&tab;
-                  </xsl:for-each>
-                <xsl:text>&lt;/ul&gt;</xsl:text>&lf;&tab;
-              </xsl:if> <!-- count() > 1 -->
-            </xsl:if> <!-- $xml-ext exists -->
-          </xsl:if> <!-- xml exists -->
-        <xsl:text>&lt;/li&gt;</xsl:text>&lf;&tab;
-      </xsl:for-each> <!-- / page -->
-
-      <xsl:apply-templates select="modulefilelist"/>
-    <xsl:text>&lt;/ul&gt;</xsl:text>&lf;
-  <xsl:text>&lt;/li&gt;</xsl:text>&lf;&tab;
-</xsl:for-each>&lf;
-
-<xsl:text>&lt;/ul&gt;</xsl:text>&lf;
 
-<xsl:text>&lt;/body&gt;&lt;/html&gt;</xsl:text>&lf;
+            &li.end; &lf;&tab;&tab;
+        </xsl:for-each>
 
+        &ul.end; &lf;&tab;
+    </xsl:if> <!-- count() > 1 -->
+</xsl:if> <!-- xml exists -->
 </xsl:template>
-  
-<xsl:template match="category/modulefilelist">
+<!-- /category/page, "index" -->
+
 
-  <!-- create our own translation list first -->
-  <xsl:variable name="translist">
+<!-- ==================================================================== -->
+<!-- category/modulefilelist                                              -->
+<!-- process all listed module files                                      -->
+<!-- ==================================================================== -->
+<xsl:template match="category/modulefilelist">
+<!-- create a module name translation list for sorting -->
+<xsl:variable name="translist">
     <xsl:text>-</xsl:text>
 
     <xsl:for-each select="modulefile">
-      <xsl:variable name="current" select="document(concat($basedir,'mod/',.))/modulesynopsis" />
+        <xsl:variable name="current"
+            select="document(concat($basedir,'mod/',.))/modulesynopsis" />
    
-      <xsl:text> </xsl:text>
-      <xsl:value-of select="$current/name"/>
-      <xsl:text> </xsl:text>
-      <xsl:call-template name="module-translatename">
-        <xsl:with-param name="name" select="$current/name"/>
-      </xsl:call-template>
-      <xsl:text> -</xsl:text>
+        <xsl:text> </xsl:text>
+        <xsl:value-of select="$current/name"/>
+        <xsl:text> </xsl:text>
+        <xsl:call-template name="module-translatename">
+            <xsl:with-param name="name" select="$current/name"/>
+        </xsl:call-template>
+        <xsl:text> -</xsl:text>
     </xsl:for-each>
-  </xsl:variable>
-
-  <!-- put core and mpm_common on top -->
-  <xsl:call-template name="toc-entry.mpm">
-    <xsl:with-param name="current" select="document(concat($basedir, 'mod/', modulefile[starts-with(.,'core.xml')]/text()))/modulesynopsis"/>
-    <xsl:with-param name="name" select="'core'"/>
-  </xsl:call-template>
-
-  <xsl:call-template name="toc-entry.mpm">
-    <xsl:with-param name="current" select="document(concat($basedir, 'mod/', modulefile[starts-with(.,'mpm_common.xml')]/text()))/modulesynopsis"/>
-    <xsl:with-param name="name" select="'common'"/>
-  </xsl:call-template>
-
-  <xsl:for-each select="modulefile">
-  <xsl:sort select="substring-before(substring-after($translist, concat('- ', document(concat($basedir,'mod/',.))/modulesynopsis/name, ' ')), ' -')"/>
-
-    <xsl:variable name="current" select="document(concat($basedir, 'mod/', .))/modulesynopsis" />
+</xsl:variable>
 
-    <xsl:if test="$current/status='MPM' and $current/name!='mpm_common'">
-      <xsl:call-template name="toc-entry.mpm">
-        <xsl:with-param name="current" select="$current"/>
-        <xsl:with-param name="name" select="substring-before(substring-after($translist, concat('- ', $current/name, ' ')), ' -')"/>
-      </xsl:call-template>
+<!-- put core and mpm_common on top -->
+<xsl:call-template name="toc-entry.mpm">
+    <xsl:with-param name="current"
+        select="document(concat($basedir, 'mod/', modulefile[starts-with(.,
+                         'core.xml')]/text()))/modulesynopsis" />
+    <xsl:with-param name="name" select="'core'" />
+</xsl:call-template>
+
+<xsl:call-template name="toc-entry.mpm">
+    <xsl:with-param name="current"
+        select="document(concat($basedir, 'mod/', modulefile[starts-with(.,
+                         'mpm_common.xml')]/text()))/modulesynopsis" />
+    <xsl:with-param name="name" select="'common'" />
+</xsl:call-template>
+
+<!-- remaining MPMs -->
+<xsl:for-each select="modulefile">
+<xsl:sort select="substring-before(substring-after($translist, concat('- ',
+    document(concat($basedir, 'mod/', .))/modulesynopsis/name, ' ')), ' -')" />
+
+    <xsl:variable name="current"
+        select="document(concat($basedir, 'mod/', .))/modulesynopsis" />
+
+    <xsl:if test="$current/status='MPM' and not($current/name='mpm_common')">
+        <xsl:call-template name="toc-entry.mpm">
+            <xsl:with-param name="current" select="$current" />
+            <xsl:with-param name="name" select="substring-before(
+                substring-after($translist, concat('- ', $current/name, ' ')),
+                ' -')" />
+        </xsl:call-template>
     </xsl:if>
-  </xsl:for-each> <!-- /mpm -->
+</xsl:for-each>
 
-  <xsl:for-each select="modulefile">
-  <xsl:sort select="substring-before(substring-after($translist, concat('- ', document(concat($basedir,'mod/',.))/modulesynopsis/name, ' ')), ' -')"/>
+<!-- normal modules -->
+<xsl:for-each select="modulefile">
+<xsl:sort select="substring-before(substring-after($translist, concat('- ',
+    document(concat($basedir, 'mod/', .))/modulesynopsis/name, ' ')), ' -')" />
 
-    <xsl:variable name="current" select="document(concat($basedir, 'mod/', .))/modulesynopsis" />
+    <xsl:variable name="current"
+        select="document(concat($basedir, 'mod/', .))/modulesynopsis" />
 
-    <xsl:if test="$current/status!='MPM' and $current/status!='Core'">
-      <xsl:call-template name="toc-entry.module">
-        <xsl:with-param name="current" select="$current"/>
-      </xsl:call-template>
+    <xsl:if test="not($current/status='MPM') and not($current/status='Core')">
+        <xsl:call-template name="toc-entry.module">
+            <xsl:with-param name="current" select="$current"/>
+        </xsl:call-template>
     </xsl:if>
-  </xsl:for-each> <!-- /modules -->
-
+</xsl:for-each>
 </xsl:template>
+<!-- /category/modulefilelist -->
+
 
+<!-- ==================================================================== -->
+<!-- toc-entry.mpm                                                        -->
+<!-- create entry (and initiate subsection entries) of an mpm             -->
+<!-- ==================================================================== -->
 <xsl:template name="toc-entry.mpm">
-<xsl:param name="current"/>
-<xsl:param name="name"/>
-
-  <xsl:text>&lt;li&gt;&lt;object type="text/sitemap"&gt;</xsl:text>&lf;&tab;&tab;&tab;
-    <xsl:text>&lt;param name="Name" value="</xsl:text>
-      <xsl:call-template name="filter.attval">
-        <xsl:with-param name="text"><xsl:choose>
-          <xsl:when test="$name='core'">
-            <xsl:value-of select="$messages/message[@name='apachecore']"/>
-          </xsl:when>
-
-          <xsl:when test="$name='common'">
-            <xsl:value-of select="$messages/message[@name='apachempmcommon']"/>
-          </xsl:when>
-
-          <xsl:otherwise>
-            <xsl:value-of select="$messages/message[@name='apachempm']"/>
-            <xsl:text> </xsl:text>
-            <xsl:value-of select="$name"/>
-          </xsl:otherwise></xsl:choose>
-        </xsl:with-param>
-      </xsl:call-template>
-    <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;
+<xsl:param name="current" />
+<xsl:param name="name" />
 
-    <xsl:text>&lt;param name="Local" value="</xsl:text>
-        <xsl:value-of select="concat('mod/', $current/name, '.html')" />
-    <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;
+&li.start;
 
-    <xsl:text>&lt;param name="ImageNumber" value="</xsl:text>
-      <xsl:choose>
-        <xsl:when test="$messages/@lang='en' or (document($current/@metafile)/metafile/variants/variant[.=$messages/@lang and not(@htmlonly='yes')])">
-          <xsl:value-of select="$icon.document" />
+<xsl:call-template name="object">
+    <xsl:with-param name="name">
+        <xsl:choose>
+        <xsl:when test="$name='core'">
+            <xsl:value-of select="$messages/message[@name='apachecore']" />
+        </xsl:when>
+        <xsl:when test="$name='common'">
+            <xsl:value-of select="$messages/message[@name='apachempmcommon']" />
         </xsl:when>
-
         <xsl:otherwise>
-          <xsl:value-of select="$icon.document.not-translated" />
+            <xsl:value-of select="$messages/message[@name='apachempm']" />
+            <xsl:text> </xsl:text>
+            <xsl:value-of select="$name" />
         </xsl:otherwise>
-      </xsl:choose>
-    <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;
-    <xsl:text>&lt;/object&gt;</xsl:text>
+        </xsl:choose>
+    </xsl:with-param>
+    <xsl:with-param name="href"
+        select="concat('mod/', $current/name, '.html')" />
+    <xsl:with-param name="indent" select="'&#9;&#9;&#9;'" />
+</xsl:call-template>
     
-    <xsl:call-template name="sections-and-directives">
-      <xsl:with-param name="current" select="$current" />
-    </xsl:call-template>
-  <xsl:text>&lt;/li&gt;</xsl:text>&lf;&tab;
+<xsl:call-template name="sections-and-directives">
+    <xsl:with-param name="current" select="$current" />
+</xsl:call-template>
+
+&li.end; &lf;&tab;
 </xsl:template>
+<!-- /toc-entry.mpm -->
   
+
+<!-- ==================================================================== -->
+<!-- toc-entry.module                                                     -->
+<!-- create entry (and initiate subsection entries) of a module           -->
+<!-- ==================================================================== -->
 <xsl:template name="toc-entry.module">
 <xsl:param name="current"/>
 
-  <xsl:text>&lt;li&gt;&lt;object type="text/sitemap"&gt;</xsl:text>&lf;&tab;&tab;&tab;
-    <xsl:text>&lt;param name="Name" value="</xsl:text>
-      <xsl:call-template name="filter.attval">
-        <xsl:with-param name="text">
-          <xsl:value-of select="$messages/message[@name='apachemodule']"/>
-          <xsl:text> </xsl:text>
-          <xsl:value-of select="$current/name"/>
-        </xsl:with-param>
-      </xsl:call-template>
-    <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;
-
-    <xsl:text>&lt;param name="Local" value="</xsl:text>
-        <xsl:value-of select="concat('mod/', $current/name, '.html')" />
-    <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;
-
-    <xsl:text>&lt;param name="ImageNumber" value="</xsl:text>
-      <xsl:choose>
-        <xsl:when test="$messages/@lang='en' or (document($current/@metafile)/metafile/variants/variant[.=$messages/@lang and not(@htmlonly='yes')])">
-          <xsl:value-of select="$icon.document" />
-        </xsl:when>
-
-        <xsl:otherwise>
-          <xsl:value-of select="$icon.document.not-translated" />
-        </xsl:otherwise>
-      </xsl:choose>
-    <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;
-    <xsl:text>&lt;/object&gt;</xsl:text>
+&li.start;
+
+<xsl:call-template name="object">
+    <xsl:with-param name="name">
+        <xsl:value-of select="$messages/message[@name='apachemodule']" />
+        <xsl:text> </xsl:text>
+        <xsl:value-of select="$current/name" />
+    </xsl:with-param>
+    <xsl:with-param name="href"
+        select="concat('mod/', $current/name, '.html')" />
+    <xsl:with-param name="indent" select="'&#9;&#9;&#9;'" />
+</xsl:call-template>
     
-    <xsl:call-template name="sections-and-directives">
-      <xsl:with-param name="current" select="$current" />
-    </xsl:call-template>
-  <xsl:text>&lt;/li&gt;</xsl:text>&lf;&tab;
+<xsl:call-template name="sections-and-directives">
+    <xsl:with-param name="current" select="$current" />
+</xsl:call-template>
+
+&li.end; &lf;&tab;
 </xsl:template>
+<!-- /toc-entry.module -->
 
+
+<!-- ==================================================================== -->
+<!-- sections-and-directives                                              -->
+<!-- process sections and directives of a module file                     -->
+<!-- ==================================================================== -->
 <xsl:template name="sections-and-directives">
 <xsl:param name="current" />
 
-  <xsl:if test="count($current/section) > 0 or count($current/directivesynopsis) > 0">
+<xsl:if test="count($current/section) &gt; 0 or
+              count($current/directivesynopsis) &gt; 0">
     &lf;&tab;&tab;
 
-    <xsl:text>&lt;ul&gt;</xsl:text>&lf;&tab;&tab;
+    &ul.start; &lf;&tab;&tab;
 
+    <!-- sections -->
     <xsl:for-each select="$current/section">
-      <xsl:text>&lt;li&gt;&lt;object type="text/sitemap"&gt;</xsl:text>&lf;&tab;&tab;&tab;&tab;
-        <xsl:text>&lt;param name="Name" value="</xsl:text>
-          <xsl:call-template name="filter.attval">
-            <xsl:with-param name="text" select="normalize-space(title)" />
-          </xsl:call-template>
-        <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;&tab;
-
-        <xsl:if test="@id">
-          <xsl:text>&lt;param name="Local" value="</xsl:text>
-              <xsl:value-of select="concat('mod/', $current/name, '.html')" />
-              <xsl:text>#</xsl:text>
-              <xsl:value-of select="@id" />
-          <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;&tab;
-        </xsl:if>
-
-        <xsl:text>&lt;param name="ImageNumber" value="</xsl:text>
-            <xsl:if test="@id"><xsl:value-of select="$icon.section"/></xsl:if>
-            <xsl:if test="not(@id)">9</xsl:if> <!-- "?" -->
-        <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;
-      <xsl:text>&lt;/object&gt;&lt;/li&gt;</xsl:text>&lf;&tab;&tab;
-    </xsl:for-each> <!-- sections -->
+        &li.start;
+
+        <xsl:call-template name="object">
+            <xsl:with-param name="name" select="normalize-space(title)" />
+            <xsl:with-param name="href">
+                <xsl:if test="@id">
+                    <xsl:value-of
+                        select="concat('mod/', $current/name, '.html#', @id)" />
+                </xsl:if>
+            </xsl:with-param>
+            <xsl:with-param name="indent" select="'&#9;&#9;&#9;&#9;'" />
+        </xsl:call-template>
+
+        &li.end; &lf;&tab;&tab;
+    </xsl:for-each>
 
+    <!-- directives within the current document -->
     <xsl:for-each select="$current/directivesynopsis[not(@location)]">
-    <xsl:sort select="name"/>
-
-      <xsl:variable name="lowername" select="translate(name, $uppercase, $lowercase)"/>
-
-      <xsl:text>&lt;li&gt;&lt;object type="text/sitemap"&gt;</xsl:text>&lf;&tab;&tab;&tab;&tab;
-        <xsl:text>&lt;param name="Name" value="</xsl:text>
-          <xsl:call-template name="filter.attval">
-            <xsl:with-param name="text">
-              <xsl:if test="@type='section'">&lt;</xsl:if>
-              <xsl:value-of select="name"/>
-              <xsl:if test="@type='section'">&gt;</xsl:if>
-              <xsl:choose>
-                <xsl:when test="$messages/message[@name='directive']/@replace-space-with">
-                  <xsl:value-of select="$messages/message[@name='directive']/@replace-space-with"/>
+    <xsl:sort select="name" />
+        &li.start;
+
+        <xsl:call-template name="object">
+            <xsl:with-param name="name">
+                <xsl:if test="@type='section'">&lt;</xsl:if>
+                <xsl:value-of select="name"/>
+                <xsl:if test="@type='section'">&gt;</xsl:if>
+                <xsl:choose>
+                <xsl:when test="$messages/message[@name='directive']
+                                /@replace-space-with">
+                    <xsl:value-of select="$messages/message[@name='directive']
+                                          /@replace-space-with" />
                 </xsl:when>
                 <xsl:otherwise>
-                  <xsl:text> </xsl:text>
+                    <xsl:text> </xsl:text>
                 </xsl:otherwise>
-              </xsl:choose>
-              <xsl:value-of select="$messages/message[@name='directive']"/>
+                </xsl:choose>
+                <xsl:value-of select="$messages/message[@name='directive']" />
             </xsl:with-param>
-          </xsl:call-template>
-        <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;&tab;
-
-        <xsl:text>&lt;param name="Local" value="</xsl:text>
-            <xsl:value-of select="concat('mod/',$current/name,'.html')" />
-            <xsl:text>#</xsl:text>
-            <xsl:value-of select="$lowername" />
-        <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;&tab;
-
-        <xsl:text>&lt;param name="ImageNumber" value="</xsl:text>
-            <xsl:value-of select="$icon.directive" />
-        <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;
-      <xsl:text>&lt;/object&gt;&lt;/li&gt;</xsl:text>&lf;&tab;&tab;
-    </xsl:for-each> <!-- directivesynopsis -->
+            <xsl:with-param name="href"
+                select="concat('mod/', $current/name, '.html#',
+                               translate(name, $uppercase, $lowercase))" />
+            <xsl:with-param name="indent" select="'&#9;&#9;&#9;&#9;'" />
+            <xsl:with-param name="icon" select="$icon.directive" />
+        </xsl:call-template>
+
+        &li.end; &lf;&tab;&tab;
+    </xsl:for-each>
 
+    <!-- directives described elsewhere -->
     <xsl:for-each select="$current/directivesynopsis[@location]">
-    <xsl:sort select="name"/>
-
-      <xsl:variable name="lowername" select="translate(name, $uppercase, $lowercase)"/>
-
-      <xsl:text>&lt;li&gt;&lt;object type="text/sitemap"&gt;</xsl:text>&lf;&tab;&tab;&tab;&tab;
-        <xsl:text>&lt;param name="Name" value="</xsl:text>
-          <xsl:call-template name="filter.attval">
-            <xsl:with-param name="text">
-              <xsl:if test="@type='section'">&lt;</xsl:if>
-              <xsl:value-of select="name"/>
-              <xsl:if test="@type='section'">&gt;</xsl:if>
-              <xsl:choose>
-                <xsl:when test="$messages/message[@name='directive']/@replace-space-with">
-                  <xsl:value-of select="$messages/message[@name='directive']/@replace-space-with"/>
+    <xsl:sort select="name" />
+        &li.start;
+
+        <xsl:call-template name="object">
+            <xsl:with-param name="name">
+                <xsl:if test="@type='section'">&lt;</xsl:if>
+                <xsl:value-of select="name"/>
+                <xsl:if test="@type='section'">&gt;</xsl:if>
+                <xsl:choose>
+                <xsl:when test="$messages/message[@name='directive']
+                                /@replace-space-with">
+                    <xsl:value-of select="$messages/message[@name='directive']
+                                          /@replace-space-with" />
                 </xsl:when>
                 <xsl:otherwise>
-                  <xsl:text> </xsl:text>
+                    <xsl:text> </xsl:text>
                 </xsl:otherwise>
-              </xsl:choose>
-              <xsl:value-of select="$messages/message[@name='directive']"/>
+                </xsl:choose>
+                <xsl:value-of select="$messages/message[@name='directive']" />
             </xsl:with-param>
-          </xsl:call-template>
-        <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;&tab;
-
-        <xsl:text>&lt;param name="Local" value="</xsl:text>
-            <xsl:value-of select="concat('mod/',@location,'.html')" />
-            <xsl:text>#</xsl:text>
-            <xsl:value-of select="$lowername" />
-        <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;&tab;
+            <xsl:with-param name="href"
+                select="concat('mod/', @location, '.html#',
+                               translate(name, $uppercase, $lowercase))" />
+            <xsl:with-param name="indent" select="'&#9;&#9;&#9;&#9;'" />
+            <xsl:with-param name="icon" select="$icon.commondirective" />
+        </xsl:call-template>
+
+        &li.end; &lf;&tab;&tab;
+    </xsl:for-each>
 
-        <xsl:text>&lt;param name="ImageNumber" value="</xsl:text>
-            <xsl:value-of select="$icon.commondirective" />
-        <xsl:text>"&gt;</xsl:text>&lf;&tab;&tab;&tab;
-      <xsl:text>&lt;/object&gt;&lt;/li&gt;</xsl:text>&lf;&tab;&tab;
-    </xsl:for-each> <!-- directivesynopsis -->
+    &ul.end; &lf;&tab;
+</xsl:if> <!-- sections or directives present -->
+</xsl:template>
+<!-- /sections-and-directives -->
+
+
+<!-- ==================================================================== -->
+<!-- object                                                               -->
+<!-- display an <object> and do some magic to select the right content    -->
+<!-- ==================================================================== -->
+<xsl:template name="object">
+<xsl:param name="name" select="'? unknown ?'" />
+<xsl:param name="href" />
+<xsl:param name="icon" select="$icon.section" />
+<xsl:param name="indent" />
+
+<xsl:variable name="href.offline">
+    <xsl:call-template name="helper.href.offline">
+        <xsl:with-param name="href" select="$href" />
+    </xsl:call-template>
+</xsl:variable>
 
-    <xsl:text>&lt;/ul&gt;</xsl:text>&lf;&tab;
-  </xsl:if> <!-- sections or directives present -->
+<!-- xml file is expected to have the same basename -->
+<xsl:variable name="xml"
+    select="concat(substring-before($href.offline, '.html'), '.xml')" />
 
-</xsl:template>
+<xsl:text>&lt;object type="text/sitemap"&gt;</xsl:text>&lf;
+<xsl:value-of select="$indent" />
 
-<xsl:template name="filter.attval">
-<xsl:param name="text"/>
+<xsl:text>&lt;param name="Name" value="</xsl:text>
+    <xsl:call-template name="filter.attval">
+        <xsl:with-param name="text" select="$name" />
+    </xsl:call-template>
+<xsl:text>"&gt;</xsl:text>&lf;
+<xsl:value-of select="$indent" />
 
+<xsl:if test="string-length($href.offline) &gt; 0">
+    <xsl:text>&lt;param name="Local" value="</xsl:text>
+        <xsl:call-template name="filter.attval">
+            <xsl:with-param name="text" select="$href.offline" />
+        </xsl:call-template>
+    <xsl:text>"&gt;</xsl:text>&lf;
+    <xsl:value-of select="$indent" />
+</xsl:if>
+
+<xsl:text>&lt;param name="ImageNumber" value="</xsl:text>
     <xsl:choose>
-        <xsl:when test="contains($text, '&amp;')">
-            <xsl:call-template name="filter.attval.special">
-              <xsl:with-param name="text" select="substring-before($text, '&amp;')"/>
-            </xsl:call-template>
-            <xsl:text>&amp;amp;</xsl:text>
-            <xsl:call-template name="filter.attval">
-                <xsl:with-param name="text"
-                              select="substring-after($text, '&amp;')"/>
-            </xsl:call-template>
+    <xsl:when test="string-length($href.offline) &gt; 0">
+        <xsl:choose>
+        <xsl:when test="contains($href, '#')">
+            <xsl:value-of select="$icon" />
+        </xsl:when>
+        <xsl:when test="$messages/@lang='en' or
+                        (not($xml = $not-exists) and
+                         (document(document(concat($basedir, $xml))
+                                   /*/@metafile)
+                          /metafile/variants/variant
+                          [.=$messages/@lang and not(@htmlonly='yes')]))">
+            <xsl:value-of select="$icon.document" />
         </xsl:when>
-
         <xsl:otherwise>
-          <xsl:call-template name="filter.attval.special">
-            <xsl:with-param name="text" select="$text"/>
-          </xsl:call-template>
+            <xsl:value-of select="$icon.document.not-translated" />
         </xsl:otherwise>
+        </xsl:choose>
+    </xsl:when>
+    <xsl:otherwise>
+        <xsl:value-of select="$icon.no-anchor" />
+    </xsl:otherwise>
     </xsl:choose>
+<xsl:text>"&gt;</xsl:text>&lf;
+<xsl:value-of select="substring($indent, 2)" />
+
+<xsl:text>&lt;/object&gt;</xsl:text>
 </xsl:template>
+<!-- /object -->
 
-<xsl:template name="filter.attval.special">
-<xsl:param name="text"/>
 
-    <xsl:choose>
-        <xsl:when test="contains($text, '&lt;')">
-            <xsl:value-of select="substring-before($text, '&lt;')"/>
-            <xsl:text>&amp;lt;</xsl:text>
-            <xsl:call-template name="filter.attval.special">
-                <xsl:with-param name="text"
-                              select="substring-after($text, '&lt;')"/>
-            </xsl:call-template>
-        </xsl:when>
+<!-- ==================================================================== -->
+<!-- folder                                                               -->
+<!-- ==================================================================== -->
+<xsl:template name="folder">
+<xsl:param name="name" select="'? unknown ?'" />
 
-        <xsl:when test="contains($text, '&gt;')">
-            <xsl:value-of select="substring-before($text, '&gt;')"/>
-            <xsl:text>&amp;gt;</xsl:text>
-            <xsl:call-template name="filter.attval.special">
-                <xsl:with-param name="text"
-                              select="substring-after($text, '&gt;')"/>
-            </xsl:call-template>
-        </xsl:when>
+<xsl:text>&lt;object type="text/sitemap"&gt;</xsl:text>&lf;&tab;&tab;
+<xsl:text>&lt;param name="Name" value="</xsl:text>
+    <xsl:call-template name="filter.attval">
+        <xsl:with-param name="text" select="$name" />
+    </xsl:call-template>
+<xsl:text>"&gt;</xsl:text>&lf;&tab;
+<xsl:text>&lt;/object&gt;</xsl:text>
+</xsl:template>
+<!-- /folder -->
+
+
+<!-- ==================================================================== -->
+<!-- helper.href.offline                                                  -->
+<!-- change uri reference to work offline (/ -> /index.html)              -->
+<!-- ==================================================================== -->
+<xsl:template name="helper.href.offline">
+<xsl:param name="href" />
+
+<xsl:choose>
+<xsl:when test="string-length($href) = 0" />
+<xsl:when test="contains($href, '#') and '/' = substring($href,
+                               string-length(substring-before($href, '#')), 1)">
+    <xsl:value-of select="substring-before($href, '#')" />
+    <xsl:text>index.html#</xsl:text>
+    <xsl:value-of select="substring-after($href, '#')" />
+</xsl:when>
+<xsl:when test="substring($href, string-length($href), 1) = '/'">
+    <xsl:value-of select="$href" />
+    <xsl:text>index.html</xsl:text>
+</xsl:when>
+<xsl:otherwise>
+    <xsl:value-of select="$href" />
+</xsl:otherwise>
+</xsl:choose>
+</xsl:template>
+<!-- /helper.href.offline -->
 
-        <xsl:when test="contains($text, '&quot;')">
-            <xsl:value-of select="substring-before($text, '&quot;')"/>
-            <xsl:text>&amp;quot;</xsl:text>
-            <xsl:call-template name="filter.attval.special">
-                <xsl:with-param name="text"
-                              select="substring-after($text, '&quot;')"/>
-            </xsl:call-template>
-        </xsl:when>
 
-        <xsl:otherwise>
-            <xsl:value-of select="$text"/>
-        </xsl:otherwise>
-    </xsl:choose>
+<!-- ==================================================================== -->
+<!-- filter.attval                                                        -->
+<!-- escape special characters for being valid within an attribute        -->
+<!-- ==================================================================== -->
+<xsl:template name="filter.attval">
+<xsl:param name="text" />
+
+<xsl:choose>
+<xsl:when test="contains($text, '&amp;')">
+    <xsl:call-template name="filter.attval.special">
+        <xsl:with-param name="text" select="substring-before($text, '&amp;')" />
+    </xsl:call-template>
+    <xsl:text>&amp;amp;</xsl:text>
+    <xsl:call-template name="filter.attval">
+        <xsl:with-param name="text" select="substring-after($text, '&amp;')" />
+    </xsl:call-template>
+</xsl:when>
+<xsl:otherwise>
+    <xsl:call-template name="filter.attval.special">
+        <xsl:with-param name="text" select="$text" />
+    </xsl:call-template>
+</xsl:otherwise>
+</xsl:choose>
 </xsl:template>
+<!-- /filter.attval -->
 
-</xsl:stylesheet>
 
+<!-- ==================================================================== -->
+<!-- filter.attval.special                                                -->
+<!-- accompanying template of filter.attval                               -->
+<!-- ==================================================================== -->
+<xsl:template name="filter.attval.special">
+<xsl:param name="text" />
+
+<xsl:choose>
+<xsl:when test="contains($text, '&lt;')">
+    <xsl:value-of select="substring-before($text, '&lt;')" />
+    <xsl:text>&amp;lt;</xsl:text>
+    <xsl:call-template name="filter.attval.special">
+        <xsl:with-param name="text" select="substring-after($text, '&lt;')" />
+    </xsl:call-template>
+</xsl:when>
+<xsl:when test="contains($text, '&gt;')">
+    <xsl:value-of select="substring-before($text, '&gt;')" />
+    <xsl:text>&amp;gt;</xsl:text>
+    <xsl:call-template name="filter.attval.special">
+        <xsl:with-param name="text" select="substring-after($text, '&gt;')" />
+    </xsl:call-template>
+</xsl:when>
+<xsl:when test="contains($text, '&quot;')">
+    <xsl:value-of select="substring-before($text, '&quot;')" />
+    <xsl:text>&amp;quot;</xsl:text>
+    <xsl:call-template name="filter.attval.special">
+        <xsl:with-param name="text" select="substring-after($text, '&quot;')" />
+    </xsl:call-template>
+</xsl:when>
+<xsl:otherwise>
+    <xsl:value-of select="$text" />
+</xsl:otherwise>
+</xsl:choose>
+</xsl:template>
+<!-- /filter.attval.special -->
+
+</xsl:stylesheet>