This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: Am I using DocBook appropriately?
Jeff Biss wrote:
Numbered sections permit a person to identify subsections easier because
of the hierarchical numbering.
That might go for the DocBook author, but not for the transformation tool.
And the reader of the generated presentational format (eg web, book)
doesn't care if the DocBook source utilized numbered or unnumbered
sections AFAICS.
I'm sure you've had problems figuring out
where in a book you were from the format of heading, numbering sections
let's a reader know where they are at all times.
AFAICS, that does depend on the output, not on the input. I mean, you
are describing features of the output, which could stay the same when
switching from numbered to unnumbered section elements.
Forget about trends and current styles useage, use numbered sections
where they help your reader.
But isn't that clearly the job of the transformer?
eg in XSLT, count(ancestor::section) will return the level, so the
output for
<section>
<section>
and
<sect1>
<sect2>
could be the same.
Tobi
--
http://www.pinkjuice.com/