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: Re: DOCBOOK: 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/



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


Powered by eList eXpress LLC