[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: <qandaset> list of questions not working



At 23:11 13/05/2004, Karsten Wade wrote:

> I've seen the pi's being used, but have you tried
>
> <toc/>
> >     <qandaset defaultlabel="qanda" id="selinux-faq-list">
> >+     <?dbhtml toc="1"?>
> >       <qandaentry>
>
>
> instead? That normally causes the toc insertion.
> Its not valid (the toc element) where you have the pi, must it be there?

I'm still not understanding completely.  The processing instructions
(PIs) are a valid way of tackling this, yes?

Ambivalent about that, since there are no pi's in the dtd :-)


 Or is the problem that
this one is only really good for HTML output?

I'm saying docbook provides a way of automatically generating a toc itself?

If you use a toc element, try validating it
with the toc element in place, or read about it in tdg?


http://www.docbook.org/tdg/en/html/toc.html




I also didn't have success with the <toc />.  In my <article>, the only
place I can validly insert a <toc></toc> block is inside of the
<sect1>.


Parents

These elements contain toc: <http://www.docbook.org/tdg/en/html/appendix.html>appendix, <http://www.docbook.org/tdg/en/html/article.html>article, <http://www.docbook.org/tdg/en/html/book.html>book, <http://www.docbook.org/tdg/en/html/chapter.html>chapter, <http://www.docbook.org/tdg/en/html/part.html>part, <http://www.docbook.org/tdg/en/html/preface.html>preface, <http://www.docbook.org/tdg/en/html/sect1.html>sect1, <http://www.docbook.org/tdg/en/html/sect2.html>sect2, <http://www.docbook.org/tdg/en/html/sect3.html>sect3, <http://www.docbook.org/tdg/en/html/sect4.html>sect4, <http://www.docbook.org/tdg/en/html/sect5.html>sect5, <http://www.docbook.org/tdg/en/html/section.html>section, <http://www.docbook.org/tdg/en/html/set.html>set.



 Doing so doesn't make it appear in the rendered HTML, probably
because of the stylesheet again, although I can't see why.  'sect1 nop'
in main-html.xsl disables ToCs for the sections, and a ToC is generated
and enabled via 'article toc'.

Read up on where/when you want tocs in the doco for the stylesheets.



I also discovered that the mere inclusion of 'qandadiv toc'  in the
<xsl:param name="generate.toc"> section of fedora-docs/xsl/main-html.xsl
is enough to generate the ToC that appear after the title of each
<qandadiv>.

Yep, that's your 'control' aspect of where and when you want a toc.



 The only way I have successfully created the entire 'table
of questions' for the <qandaset> is with the PI <?dbhtml toc="1"?>.

/me scratches his head

I'm happy with my hack for the moment, but I'm not happy with not fully
understanding _why_ it works as it does.  Back to the books ...


If you want one, and its not supported,
put in the request at sourceforge,
or mail it to the docbook-apps list?

HTH DaveP




[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]