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] | [Elist Home]


Subject: DOCBOOK: Re: Am I using DocBook appropriately?


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

/ Joachim Ziegler <ziegler@mpi-sb.mpg.de> was heard to say:
| Tobias Reif wrote:
|>> I think numbered sections (like sect1) aren't as common now as
|>> they once were, with nested sections being used more, but that's
|>> just an impression I have.  I don't know how accurate it is.
|> I see; I could simply use section elements and none of sect[1-5].
|>
|
| That's news to me, too. I wonder when and why I should use sect1-sect5
| at all. (?)

You have to use the sectN hierarchy if you want to control the section
depths used by your authors. For example, you could write a
customization layer that allowed chapters to contain sect1, sect3, and
sect3 but nothing deeper. That would limit authors to three levels of
sections in each chapter. Some publications enforce strict rules about
things like that.

If you allow section to be recursive at all, it's infinitely recursive.

                                        Be seeing you,
                                          norm

- -- 
Norman Walsh <ndw@nwalsh.com>      | Mankind are always happy for
http://www.oasis-open.org/docbook/ | having been happy; so that if you
Chair, DocBook Technical Committee | make them happy now, you make them
                                   | happy twenty years hence by the
                                   | memory of it.--Sydney Smith
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.7 <http://mailcrypt.sourceforge.net/>

iD8DBQE+UVWcOyltUcwYWjsRAg4EAJ9PiXwijddW5Hh/VcRr2eEnQuwngQCggjRu
+VD4p8fqCEnTpC2VFdAviRo=
=9d9R
-----END PGP SIGNATURE-----


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


Powered by eList eXpress LLC