From: Norman Walsh <ndw@nwalsh.com>
Date: Thu, 5 Jul 2001 09:53:25 +0000 (+0000)
Subject: SR #431040, added generate.section.toc.level parameter to control depth of sections... 
X-Git-Tag: release/1.79.1~6^2~6430
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=b531b33c86edd7949ad24d015b5f0ca3db25093d;p=docbook-dsssl

SR #431040, added generate.section.toc.level parameter to control depth of sections which get a TOC
---

diff --git a/xsl/html/param.xsl b/xsl/html/param.xsl
index 6da9ae556..5abf9be7a 100644
--- a/xsl/html/param.xsl
+++ b/xsl/html/param.xsl
@@ -932,13 +932,35 @@ in the CALS table.
 </doc:param>
 
 <!-- ==================================================================== -->
-<xsl:param name="generate.section.toc" select='0' doc:type='boolean'/>
+<xsl:param name="generate.section.toc" select='1' doc:type='boolean'/>
 
 <doc:param name="generate.section.toc" xmlns="">
-<refpurpose>FIXME:</refpurpose>
+<refpurpose>Generate TOCs inside Sections?</refpurpose>
 <refdescription>
-<para>FIXME:
+<para>If non-zero, a Table of Contents will be generated inside section
+elements. If <parameter>generate.section.toc.level</parameter> is non-zero,
+it may suppress some section TOCs.
+</para>
+</refdescription>
+</doc:param>
+
+<!-- ==================================================================== -->
+<xsl:param name="generate.section.toc.level" select='3' doc:type='integer'/>
+
+<doc:param name="generate.section.toc.level" xmlns="">
+<refpurpose>Control depth of TOC generation in sections</refpurpose>
+<refdescription>
+<para>If non-zero, <parameter>generate.section.toc.level</parameter> controls
+the depth of section in which TOCs will be generated. Note that this is
+related to, but not the same as <parameter>toc.section.depth</parameter>,
+which controls the depth to which TOC entries will be generated in a given
+TOC.</para>
+<para>If, for example, <parameter>generate.section.toc.level</parameter>
+is <literal>3</literal>, TOCs will be generated in first, second, and third
+level sections, but not in fourth level sections.
 </para>
+<para>If <parameter>generate.section.toc.level</parameter> is zero, it has
+no effect.</para>
 </refdescription>
 </doc:param>
 
diff --git a/xsl/html/sections.xsl b/xsl/html/sections.xsl
index 608ef8457..2c89eebd9 100644
--- a/xsl/html/sections.xsl
+++ b/xsl/html/sections.xsl
@@ -15,14 +15,15 @@
 <!-- ==================================================================== -->
 
 <xsl:template match="section">
-  <xsl:variable name="id">
-    <xsl:call-template name="object.id"/>
-  </xsl:variable>
+  <xsl:variable name="id"><xsl:call-template name="object.id"/></xsl:variable>
+  <xsl:variable name="depth" select="count(ancestor::section)+1"/>
 
   <div class="{name(.)}">
     <a name="{$id}"/>
     <xsl:call-template name="section.titlepage"/>
-    <xsl:if test="$generate.section.toc != '0'
+    <xsl:if test="($generate.section.toc != '0'
+                   and ($generate.section.toc.level = 0
+                        or $depth &lt;= $generate.section.toc.level))
                   or refentry">
       <xsl:call-template name="section.toc"/>
     </xsl:if>
@@ -68,7 +69,9 @@
   <div class="{name(.)}">
     <a name="{$id}"/>
     <xsl:call-template name="sect1.titlepage"/>
-    <xsl:if test="$generate.section.toc != '0'
+    <xsl:if test="($generate.section.toc != '0'
+                   and ($generate.section.toc.level = 0
+                        or $generate.section.toc.level &gt;= 1))
                   or refentry">
       <xsl:call-template name="section.toc"/>
     </xsl:if>
@@ -89,7 +92,9 @@
   <div class="{name(.)}">
     <a name="{$id}"/>
     <xsl:call-template name="sect2.titlepage"/>
-    <xsl:if test="$generate.section.toc != '0'
+    <xsl:if test="($generate.section.toc != '0'
+                   and ($generate.section.toc.level = 0
+                        or $generate.section.toc.level &gt;= 2))
                   or refentry">
       <xsl:call-template name="section.toc"/>
     </xsl:if>
@@ -109,8 +114,9 @@
   <div class="{name(.)}">
     <a name="{$id}"/>
     <xsl:call-template name="sect3.titlepage"/>
-
-    <xsl:if test="$generate.section.toc != '0'
+    <xsl:if test="($generate.section.toc != '0'
+                   and ($generate.section.toc.level = 0
+                        or $generate.section.toc.level &gt;= 3))
                   or refentry">
       <xsl:call-template name="section.toc"/>
     </xsl:if>
@@ -130,7 +136,9 @@
   <div class="{name(.)}">
     <a name="{$id}"/>
     <xsl:call-template name="sect4.titlepage"/>
-    <xsl:if test="$generate.section.toc != '0'
+    <xsl:if test="($generate.section.toc != '0'
+                   and ($generate.section.toc.level = 0
+                        or $generate.section.toc.level &gt;= 4))
                   or refentry">
       <xsl:call-template name="section.toc"/>
     </xsl:if>
@@ -150,7 +158,9 @@
   <div class="{name(.)}">
     <a name="{$id}"/>
     <xsl:call-template name="sect5.titlepage"/>
-    <xsl:if test="$generate.section.toc != '0'
+    <xsl:if test="($generate.section.toc != '0'
+                   and ($generate.section.toc.level = 0
+                        or $generate.section.toc.level &gt;= 5))
                   or refentry">
       <xsl:call-template name="section.toc"/>
     </xsl:if>