Re: [docbook-apps] Please respond: adding generic sibling to high-levelbook components

From
=?JRN-8859-1?P?Damille_C=F9gnis?=
Date
2007-02-23T07:46:20+00:00
ID
Thread
Re: [docbook-apps] Please respond: adding generic sibling to high-levelbook components
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Scott Hudson a 嶰rit :
> Right. This element would be considered for addition in v5.0...
> 
> Question is: should these elements be collapsed with the intention of
> applying a class or type attribute (e.g. <bookmatter class="preface"
> label="Preface" /> or is it still semantically meaningful to leave the
> existing structures, but use the generic one for any additional needed
> sibling structures?

The less elements the happier Camille.

Rationale: When our clients come to docbook they are frightened by the
number of elements. So we provide them with a limited list so they can
get started. But while they start learning new elements they realize
they should have called that element <preface> rather than <chapter>.
And it's easier to add an attribute to specialize the element rather
than renaming it, possibly with content model issues.

My 2 euro cents.

Camille.

> Not that we want to go and "hack and slash" many of the elements in DB
> 5.0, but now would be the time to make any backward-incompatible changes...
> 
> Best regards,
> 
> --Scott
> 
> Keith Fahlgren wrote:
>> On 2/22/07, Scott Hudson <> wrote:
>>> Technically, Preface, Chapter and Appendix have the same content model.
>>
>> Yeah, to be explicit, in DocBook 4.4, they have the same children, but
>> not the same attributes. chapter/@label but no preface/@label :-(
>> [that's a big bummer for me] in DocBook 4.4. This is "fixed" in
>> DocBook 5, so that's why it's may be a moot point to differentiate
>> between chapter|preface|appendix anymore.
>>
>>
>>> What about calling this generic structure "bookmatter" (since we can't
>>> call it frontmatter or endmatter)?
>>
>> I like that.
>>
>>
>> Keith
>>
> 

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (GNU/Linux)
Comment: Using GnuPG with Mandriva - http://enigmail.mozdev.org

iD8DBQFF3pvSjv9P65BfOUMRAiHQAJ992PAy2G8mht7zjxO3myLViBF4BQCeNo79
lJC4TFkLayLL1m6Ftb7Zj1A=
=p/bz
-----END PGP SIGNATURE-----