OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: RE: [docbook] should I use section or sect1, sect2, sect3 etc?

I've found numbered sections to be useful when modifying the DocBook DTD
so that you can use it to create documents similar to those created by
the commercial Information Mapping system.

In such a system, you build documents from the bottom up, rather than
from the top down.

All text goes within the lowest level, say, a Sect3, and a Chapter would
be made up of a group of Sect2 elements. I call this a topic-point
structure, in which the Sect2 elements are the Topics within the
chapter, and the Sect3 elements are the Points containing the text.

If, as you develop the document, you find you have too many Sect2
elements (Topics), you group them under new Sect1 elements.

It seems to me to be a natural way to write because the structure
develops out of the material as you discover it.

And there's no problem with reuse because the lowest level is always the
one containing the text.

If you wanted a somewhat deeper hierarchy, you could start with a Sect4
(Point) at the bottom, and it would be possible to have a Sect3 (Topic)
immediately under the Chapter. As you developed the book, you could add
Sect2 and Sect1 levels as necessary.

Of course, all this requires some (rather small) modifications to the
DocBook DTD.

Dave Nilsson

-----Original Message-----
From: Rock Lobster [mailto:email@christian-gleinser.de] 
Sent: Friday, April 13, 2007 4:56 AM
To: docbook@lists.oasis-open.org
Subject: [docbook] should I use section or sect1, sect2, sect3 etc?


I'm somehow confused on whether I should use nested <section> tags, or
the "predefined" <sect1> to <sect5>.
Are there any benefits in using the latter? Are there any reasons why
one way should be avoided in certain situations?

Thanks in advance!
View this message in context:
Sent from the docbook General mailing list archive at Nabble.com.

To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]