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


Subject: Elements versus Attributes


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

Bonjour,

I take advantage of the ongoing topics discussion to start another
thread I wanted to start for a long time, it might help too.

When designing an XML grammar, an obvious rule seem to use different
element names if they have different content models. Attributes can be
used to further specialize elements.

However DocBook goes beyond this: the example of admonitions is
striking: 5 elements (db.caution | db.important | db.note | db.tip |
db.warning) with exact same content model.[1]

I wonder why not using a class or type attribute (what's the difference
between these btw?).

In short, is there a document somewhere that explains, even quickly, the
designing principles behind DocBook?


Before closing that message let me make something clear: I think Norm
and all the DocBook team is doing a remarkable work, I realize I perhaps
never thank you. All that to say I don't mean to sound criticizing, just
wish to bring my stone to the building.

Camille.

[1] For this specific example I'd suggest to use <note
type="caution|important|tip|warning"> or something like that.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (GNU/Linux)
Comment: Using GnuPG with Mandriva - http://enigmail.mozdev.org

iD8DBQFFQcgfjv9P65BfOUMRAtDkAJ4xJObiK92M/AfLTGlwQHL9D9+YzQCfdhS/
Fq/haSN9NWpCB2V6NUWVBxI=
=18Zr
-----END PGP SIGNATURE-----
begin:vcard
fn;quoted-printable:Camille B=C3=A9gnis
n;quoted-printable:B=C3=A9gnis;Camille
org:NeoDoc
adr:Domaine du petit Arbois BP 88;;CEEI;Aix en Provence Cedex 4;;13545;France
email;internet:camille@neodoc.biz
tel;work:+33.4.42.22.62.35 
tel;cell:+33.6.33.15.10.23
note;quoted-printable:Rejoignez mon r=C3=A9seau sur viaduc:=0D=0A=
	=0D=0A=
	http://www.viaduc.com/invitationpersonnelle/002lm14bc0jlkfk
x-mozilla-html:FALSE
url:http://neodoc.biz
version:2.1
end:vcard



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