This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
RE: Help project structure
- From: David Cramer <dcramer at broadjump dot com>
- To: denisb at rational dot com, docbook-apps at lists dot oasis-open dot org
- Date: Tue, 29 Jan 2002 13:50:00 -0600
- Subject: RE: DOCBOOK-APPS: Help project structure
Actually, unless you're using 1.48, subsections don't chunk. Norm added
a chunk.section.depth parameter to let you control that between 1.47 and
1.48. I'm not sure about making "See also..." a <section>. I think of it
more as an itemizedlist (which someday might be picked up and put into
the topic's header as a javascript drop-down or something):
<section>
introductory content
<section>Subsection 1... (new chunk)
<itemizedlist role="relatedtopics">
</section>
<section>Subsection 2... (new chunk)
<itemizedlist role="relatedtopics">
</section>
</section>
Not using recursive sections limits you to a fairly flat help system.
Btw., there was a discussion on the docbook list on what changes should
be made to the dtd to accomodate a help system, but I fell behind around
that time and never have made it back to glean wisdom from those
threads.
David
> -----Original Message-----
> From: denisb@rational.com [mailto:denisb@rational.com]
> Sent: Tuesday, January 29, 2002 12:59 PM
> To: docbook-apps@lists.oasis-open.org
> Subject: RE: DOCBOOK-APPS: Help project structure
> Does 'first file' mean the first section? With recursive
> sections, you could
> have a topic with subsections like this, right?
>
> <section>
> content...
> <section>Subsection 1...</section>
> <section>Subsection 2...</section>
> <section>See also...</section>
> </section>
>
> The problem with this scenario is that I don't see how to
> control chunking:
> I'd want the whole structure above to be one topic, chunking
> only the top
> section. Do you know how one would suppress chunking in the
> subsections?
>
> Thanks,
> Denis