Support subsections in HTML output

[exim-website.git] / templates / doc / chapter.xsl

diff --git a/templates/doc/chapter.xsl b/templates/doc/chapter.xsl
index 430a6d3bde2f79a3dc59919d7713f14b7fa0005f..03fa3485f9e97d4c44086ccbdfc6fc622eca71f4 100644 (file)
--- a/templates/doc/chapter.xsl
+++ b/templates/doc/chapter.xsl
@@ -16,7 +16,7 @@
    <xsl:variable name="html.head.append">
 
       <!-- CSS -->
-         <link rel="stylesheet" type="text/css" href="{$docroot}/doc/chapter.css"/>
+         <link rel="stylesheet" type="text/css" href="{$staticroot}/doc/chapter.css"/>
 
       <!-- Canonical -->
          <link rel="canonical" href="{/chapter/canonical_url}"/>
@@ -25,43 +25,101 @@
  
    <!-- JavaScript -->
       <xsl:variable name="html.body.append">
-         <script type="text/javascript" src="{$docroot}/doc/chapter.js"/>
+         <script type="text/javascript" src="{$staticroot}/doc/chapter.js"/>
+      </xsl:variable>
+
+   <!-- Table of Contents -->
+      <xsl:variable name="html.body.outer.append">
+         <div id="toc">
+            <ul class="hidden"/>
+            <img src="{$staticroot}/doc/contents.png" width="16" height="155"/>
+         </div>
       </xsl:variable>
 
    <!-- CONTENT -->
       <xsl:template match="/chapter">
 
          <!-- Navigation -->
-           <a class="previous_page" href="{prev_url}"><![CDATA[<-previous]]></a>
-           <a class="next_page"     href="{next_url}"><![CDATA[next->]]></a>
-
-         <!-- Chapter Title -->
-            <h2>
-               <xsl:value-of select="concat('Chapter ',chapter_id,' - ',title)"/>
+         <a class="previous_page" href="{prev_url}"><![CDATA[<-previous]]></a>
+         <xsl:if test="next_url">
+            <a class="next_page"  href="{next_url}"><![CDATA[next->]]></a>
+         </xsl:if>
+
+         <!-- Chapter Wrapper -->
+         <div id="chapter" class="chapter{@class}">
+
+            <xsl:if test="current_url">
+               <p id="old_version_warning">
+                  <span class="closebar"><a href="#" title="Close">X</a></span>
+                  <strong>WARNING:</strong>
+                  <xsl:text> This documentation is for an old version of Exim (</xsl:text>
+                  <a href="{current_url}">latest</a>
+                  <xsl:text>)</xsl:text>
+               </p>
+            </xsl:if>
+
+            <!-- Chapter Title -->
+            <h2 id="{@id}" class="{@class}">
+               <a href="{this_url}">
+                  <xsl:value-of select="concat('Chapter ',chapter_id,' - ',title)"/>
+               </a>
             </h2>
 
-         <!-- Chapter Info -->
-            <div id="chapter">
+            <!-- Chapter Info -->
                <xsl:apply-templates select="*[name()!='section']"/>
                <xsl:apply-templates select="section"/>
-            </div>
+         </div>
 
          <!-- Navigation -->
             <a class="previous_page" href="{prev_url}"><![CDATA[<-previous]]></a>
-            <a class="next_page"     href="{next_url}"><![CDATA[next->]]></a>
+            <a class="toc_page"      href="{toc_url}"><![CDATA[Table of Contents]]></a>
+            <xsl:if test="next_url">
+               <a class="next_page"  href="{next_url}"><![CDATA[next->]]></a>
+            </xsl:if>
 
       </xsl:template>
 
    <!-- Section -->
-      <xsl:template match="/chapter/section">
-
-         <!-- Section Title -->
-            <h3 id="{@id}">
-               <xsl:value-of select="concat(position(),'. ',title)"/>
-            </h3>
-
-         <!-- Section Paragraphs -->
+      <xsl:template match="*/section">
+
+        <!-- Add 2 to the "level" attr for the html header level; default h3 -->
+        <xsl:variable name="hlevel">
+          <xsl:choose>
+             <xsl:when test="@level!=''"><xsl:value-of select="@level + 2"/></xsl:when>
+             <xsl:otherwise>3</xsl:otherwise>
+          </xsl:choose>
+        </xsl:variable>
+
+        <!-- Take the "sectprefix" attr, default position() -->
+        <xsl:variable name="sectprefix">
+          <xsl:choose>
+             <xsl:when test="@sectprefix!=''"> <xsl:value-of select="@sectprefix"/> </xsl:when>
+             <xsl:otherwise>                   <xsl:value-of select="position()"/>  </xsl:otherwise>
+          </xsl:choose>
+        </xsl:variable>
+
+         <!-- Section Wrapper -->
+         <div class="section{@class}">
+
+            <!-- Section Title -->
+            <xsl:choose>
+               <xsl:when test="@class='index'">
+                  <h3 id="{@id}" class="{@class}">
+                     <xsl:value-of select="title"/>
+                  </h3>
+               </xsl:when>
+               <xsl:otherwise>
+                 <xsl:element name="h{$hlevel}">
+                   <xsl:attribute name="id">    <xsl:value-of select="@id"/>    </xsl:attribute>
+                   <xsl:attribute name="class"> <xsl:value-of select="@class"/> </xsl:attribute>
+                     <xsl:value-of select="concat($sectprefix,'. ',title)"/>
+                 </xsl:element>
+               </xsl:otherwise>
+            </xsl:choose>
+
+            <!-- Section Paragraphs -->
             <xsl:apply-templates select="*"/>
+         </div>
       </xsl:template>
 
    <!-- Section paragraph -->
@@ -73,6 +131,6 @@
       </xsl:template>
 
    <!-- Ignore -->
-      <xsl:template match="chapter_id|prev_url|next_url|canonical_url"/>
+      <xsl:template match="chapter_id|this_url|prev_url|next_url|toc_url|canonical_url|current_url|title_uri|old_versions"/>
 
 </xsl:stylesheet>