docbook-apps

hi, I have one particular section in which I would like to omit the
table of contents.
I want the section to appear in the chapter table of contents, just
not have a toc generated on this section.

The section has the attribute userlevel='syntax'. I tried the
following template but it had no effect I could see (the toc showed up
on the section). I thought it would not generate the toc in the
specified section and produce a single level toc for chapters (i.e. a
toc of the top-level sections in the chapter):

<xsl:template match="d:section[@userlevel='syntax']" mode="toc">
<xsl:param name="toc-context" select="." />
<xsl:if test="local-name($toc-context) = 'chapter'">
<xsl:call-template name="subtoc">
<xsl:with-param name="toc-context" select="$toc-context"/>
<xsl:with-param name="nodes" select="foo"/>
</xsl:call-template>
</xsl:if>
</xsl:template>

How can I omit the toc for section[@userlevel='syntax'] and still have
the section listed in the chapter toc?

thanks,
--Tim

Tim,

I'm not 100% sure what you're trying to do, but it looks like you're trying to control what levels in the structure get TOCs. This is controlled through a parameter called generate.toc, and you shouldn't need to customize any templates to assign TOCs at various levels in the structure.

You can find a description of how to set generate.toc in Bob Stayton's book. Here is a link to the pertinent section:

http://www.sagehill.net/docbookxsl/TOCcontrol.html

If I'm missing something, and you need to do something more, you will find a complete description of TOC customization in that same section.

I hope that helps.

Best Regards,
Dick Hamilton
-------
XML Press
XML for Technical Communicators
http://xmlpress.net
hamilton@xmlpress.net



On May 31, 2012, at 1:42 PM, Tim Arnold wrote:

> hi, I have one particular section in which I would like to omit the
> table of contents.
> I want the section to appear in the chapter table of contents, just
> not have a toc generated on this section.
>
> The section has the attribute userlevel='syntax'. I tried the
> following template but it had no effect I could see (the toc showed up
> on the section). I thought it would not generate the toc in the
> specified section and produce a single level toc for chapters (i.e. a
> toc of the top-level sections in the chapter):
>
> <xsl:template match="d:section[@userlevel='syntax']" mode="toc">
> <xsl:param name="toc-context" select="." />
> <xsl:if test="local-name($toc-context) = 'chapter'">
> <xsl:call-template name="subtoc">
> <xsl:with-param name="toc-context" select="$toc-context"/>
> <xsl:with-param name="nodes" select="foo"/>
> </xsl:call-template>
> </xsl:if>
> </xsl:template>
>
> How can I omit the toc for section[@userlevel='syntax'] and still have
> the section listed in the chapter toc?
>
> thanks,
> --Tim
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>

Hi Dick,
Thanks, I have been reading that section, but it's not that I want to
control the toc on every section, just one section that has a
particular attribute. My question wasn't clear that I do want section
tocs, just not for this particular section.

As far as I can tell, I can't put selectors in the generate.toc
parameter. Here is what I have:
<xsl:param name="generate.toc">book toc
part toc
preface toc
chapter toc
appendix toc
section toc
</xsl:param>

And if it were possible I would do this:
<xsl:param name="generate.toc">book toc
part toc
preface toc
chapter toc
appendix toc
section[not(@userlevel='syntax')] toc
</xsl:param>

so that all sections except that particular one gets the toc
generated. That's the reason for my attempt to override the template
for that section with mode='toc' (in my previous message).

I don't understand why my override template is not having an effect.
thanks,
--Tim


On Thu, May 31, 2012 at 9:24 PM, Richard Hamilton <hamilton@xmlpress.net> wrote:
> Tim,
>
> I'm not 100% sure what you're trying to do, but it looks like you're trying to control what levels in the structure get TOCs. This is controlled through a parameter called generate.toc, and you shouldn't need to customize any templates to assign TOCs at various levels in the structure.
>
> You can find a description of how to set generate.toc in Bob Stayton's book. Here is a link to the pertinent section:
>
> http://www.sagehill.net/docbookxsl/TOCcontrol.html
>
> If I'm missing something, and you need to do something more, you will find a complete description of TOC customization in that same section.
>
> I hope that helps.
>
> Best Regards,
> Dick Hamilton
> -------
> XML Press
> XML for Technical Communicators
> http://xmlpress.net
> hamilton@xmlpress.net
>
>
>
> On May 31, 2012, at 1:42 PM, Tim Arnold wrote:
>
>> hi, I have one particular section in which I would like to omit the
>> table of contents.
>> I want the section to appear in the chapter table of contents, just
>> not have a toc generated on this section.
>>
>> The section has the attribute userlevel='syntax'. I tried the
>> following template but it had no effect I could see (the toc showed up
>> on the section). I thought it would not generate the toc in the
>> specified section and produce a single level toc for chapters (i.e. a
>> toc of the top-level sections in the chapter):
>>
>> <xsl:template match="d:section[@userlevel='syntax']" mode="toc">
>>    <xsl:param name="toc-context" select="." />
>>    <xsl:if test="local-name($toc-context) = 'chapter'">
>>      <xsl:call-template name="subtoc">
>>        <xsl:with-param name="toc-context" select="$toc-context"/>
>>        <xsl:with-param name="nodes" select="foo"/>
>>      </xsl:call-template>
>>    </xsl:if>
>>  </xsl:template>
>>
>> How can I omit the toc for section[@userlevel='syntax'] and still have
>> the section listed in the chapter toc?
>>
>> thanks,
>> --Tim
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
>> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>>
>

On 06/01/2012 09:18 AM, Tim Arnold wrote:
> Hi Dick,
> Thanks, I have been reading that section, but it's not that I want to
> control the toc on every section, just one section that has a
> particular attribute. My question wasn't clear that I do want section
> tocs, just not for this particular section.

Allow me to jump in with a somewhat related request:

I have run into other situations where I'd like to be able to control
ToC generation explicitly. For example: In DocBook Slides, I'd like to
generate a ToC for each foilgroup (and highlight the current position).
So far I have done this by customizing the appropriate xsl templates.
However, I think it would be very convenient for authors to be able to
explicitly request a toc at a given place, for example using a "<toc>"
element, akin to "<index>". (This could be further tuned by adding
attributes to indicate whether this should be a toc for the local
subtree, or a global one.)

Does this sound reasonable ? I will cross-post this to the docbook list,
too, as it is essentially a request for the DB grammar itself.

Thanks,
Stefan

--

...ich hab' noch einen Koffer in Berlin...