This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
RFE 480957: Proposal: Improve name and address markup
- From: Norman Walsh <ndw at nwalsh dot com>
- To: docbook at lists dot oasis-open dot org
- Date: Tue, 05 Feb 2002 17:04:52 -0500
- Subject: DOCBOOK: RFE 480957: Proposal: Improve name and address markup
RFE 480957: Proposal: Improve name and address markup
Phase I, backwards compatible changes for DocBook V4.x
Associating an email address with, for example, an author in DocBook
requires the following tedious markup:
<author>
<firstname>Norman</firstname>
<surname>Walsh</surname>
<affiliation>
<address><email>ndw@nwalsh.com</email></address>
</affiliation>
</author>
This markup has at least two flaws:
* It incorrectly associates email addresses with affiliations. Email
addresses are now almost as common as phone numbers and people may
have several that are independent of any affiliation.
* The additional wrapper of address around email is cumbersome,
especially when you consider that address is a linespecific
element.
I propose:
1. Create a new element, personname:
<!ENTITY % personname.module "INCLUDE">
<![%personname.module;[
<!ENTITY % local.personname.attrib "">
<!ENTITY % personname.role.attrib "%role.attrib;">
<!ENTITY % personname.element "INCLUDE">
<![%personname.element;[
<!ELEMENT personname %ho; ((honorific|firstname|surname|lineage|othername)+)>
<!--end of personname.element-->]]>
<!ENTITY % personname.attlist "INCLUDE">
<![%personname.attlist;[
<!ATTLIST personname
%common.attrib;
%personname.role.attrib;
%local.personname.attrib;
>
<!--end of personname.attlist-->]]>
<!--end of personname.module-->]]>
2. Allow personname everywhere that (honorific|firstname|...) is currently
allowed. That would be: address, author, biblioentry, bibliomixed, bibliomset,
biblioset, editor, othercredit, and *info.
3. Create personblurb (identical to authorblurb)
4. Allow personblurb in author, editor, and othercredit
5. Allow email and address in author, editor, and othercredit
6. Add personname to gen.char.class (effectively allowing personname everywhere
emphasis is currently allowed).
Phase II, backwards incompatible changes for DocBook V6.x
1. Remove (honorific|firstname|...) from everywhere except personname.
2. Remove authorblurb. (Note that authorblurb is allowed in *tons* of places
where personblurb is not (because authorblurb is part of descobj.mix and
I don't propose to put personblurb there).)
Be seeing you,
norm
--
Norman Walsh <ndw@nwalsh.com> | Everything is temporary.
http://www.oasis-open.org/docbook/ |
Chair, DocBook Technical Committee |