Re: [docbook-apps] bibliography title in TOC

["Bob Stayton" <bobs@sagehill.net>]

Thanks for the summary. I understand what you are trying to do, but getting a 
bibliography to format like a sect1 is going to require many customizations of the 
stylesheet.  That's because all the hierarchical elements are processed in several 
different modes such as for the table of contents, numbering, Next and Previous (in 
HTML output), etc..  Basically everywhere that sect1 appears in the stylesheet, you'll 
need to use 'sect1 | chapter/bibliography', and that could be a lot of places.

Instead, you might try this markup using bibliolist, a workaround that is mostly 
semantically correct:

<chapter>
  <title>Literature</title>
  <sect1>
    <title>Conference Presentations</title>
    ...
  </sect1>
  <sect1>
    <title>Theses</title>
    ...
  </sect1>
  <sect1>
    <title>Bibliography</title>
    <bibliolist>
      <biblioentry>
      ...
    </bibliolist>
  </sect1>
</chapter>

That will format the Bibliography like a section (because it is a section) including 
numbering and TOC support.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


----- Original Message ----- 
From: <markus.hoenicka@mhoenicka.de>
To: <docbook-apps@lists.oasis-open.org>
Sent: Thursday, July 07, 2011 12:30 PM
Subject: Re: [docbook-apps] bibliography title in TOC


> Bob Stayton writes:
> > Hi Markus,
> > Apparently Niels suggestions were sent off list, so we are not clear what has 
> > already
> > been suggested.
> >
>
> Hi Bob,
>
> let me summarize the current status real quick. For what I want to
> express, the logical sequence is this:
>
> <chapter>
>  <title>Literature</title>
>  <sect1>
>    <title>Conference Presentations</title>
>    ...
>  </sect1>
>  <sect1>
>    <title>Theses</title>
>    ...
>  </sect1>
>  <bibliography>
>    <title>Bibliography</title>
>    ...
>  </bibliography>
> </chapter>
>
> However, the fo stylesheets treat the bibliography title specially,
> resulting in some unwanted (for me, that is) effects. First the book
> TOC:
>
> 9. Literature
>  1. Conference Presentations
>  2. Theses
>      <---- bibliography missing here
>
> The "Literature" chapter TOC looks like this:
>
> 1. Conference Presentations
> 2. Theses
> Bibliography  <---- bibliography shows up here but without numbering
>
> Along the same lines, the "Bibliography" heading in the text lacks the
> number that the true "sect1" titles carry.
>
> Now, Niels' suggestion was to move the bibliography element out to the
> level of a chapter. This is what I regard as my fallback option:
>
> <chapter>
>  <title>Literature</title>
>  <sect1>
>  ...
>  </sect1>
>  <sect1>
>  ...
>  </sect1
> </chapter>
> <bibliography>
>  <title>Bibliography</title>
>  ...
> </bibliography>
>
> I assume this will render as this in the book TOC:
>
> 9. Literature
>  1. Conference Presentations
>  2. Theses
> Bibliography
>
> I'd like to make clear that this doesn't mean there is something wrong
> with the stylesheets. I assume 99% of the documents use the latter
> option and we all feel fine with it. However, in my particular case I
> feel that treating the bibliography as a section in a chapter better
> matches the contents.
>
> regards,
> Markus
>
>
> -- 
> Markus Hoenicka
> http://www.mhoenicka.de
> AQ score 38
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>
>