I never saw a recommendation for using article, so I don't know of the
advantages.  Would like to know if there are any.

First file is the first section as you thought.

I use <sect1>, <sect2>, etc.. for section tags and nesting.  As for
suppressing chunking of subsections, I have no need to do that, but I am
sure you could customize the stylesheet somewhere to do that.

I will have some sections (<sect1>) for which I will not want in my table of
contents.  I am thinking I will check the id for those sections I want
suppressed using a xsl customization so that a .hhc entry isn't generated
for it.  Haven't thought enough about that.  I'm pretty new to all of this
myself, so this is like the blind leading the blind.

Maggie

-----Original Message-----
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]
Sent: Tuesday, January 29, 2002 12:59 PM
To: [EMAIL PROTECTED]
Subject: RE: DOCBOOK-APPS: Help project structure


> -----Original Message-----
> From: Maggie Strevell [mailto:[EMAIL PROTECTED]]

>  I am using a section to represent each help topic.  The type
> of driver file (book|chapter|section).

This looks sensible to me. How come some people recommend article instead of
chapter? Is there some advantage I'm missing?

>  <!-- the file name for the first file in this chapter is
> generated using the id for the chapter -->

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


Reply via email to