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: 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 |


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


Powered by eList eXpress LLC