This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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-----


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]