This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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 |


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]