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]

[docbook] Marking up corporate bodies address, division, etc. in corpauthor


Hello list,

We have the need to clearly identify the name, the abbreviation, the
division and the address of corporate bodies which are corpauthors and
contractsponsors of books.

Example:

  orgname: World Wide Web Consortium
  orgabbrev: W3C
  orgdiv: QA
  address (pob): xxx
  address (city): xxx
  etc.
  

At the moment there seems to be a lack of markup in corpauthor,
corpcredit, contractsponsor and confsponsor to clearly set this
information.

Have some people face the same needs, and how have they marked up such
data?

Since the next DocBook Technical Committee Meeting is very close (Dec
15th) I've also filled a RFE:

  Add address, orgname, orgdiv, orgabbrev to corpauthor,
  corpcredit, contractsponsor, confsponsor.
 
  http://sourceforge.net/tracker/index.php?func=detail&aid=1084491&group_id=21935&atid=384107

  Add address, orgname, orgdiv, orgabbrev to corpauthor,
  corpcredit, contractsponsor, confsponsor.
  
  Just like author, editor and publisher have address, it
  would
  be very useful to have address for corpauthor,
  corpcredit, contractsponsor, consponsor.
  
  Having an address element is the most needed
  structuring element but adding an address element calls
  to add other structuring elements such as orgname and
  orgdiv. Adding an orgabbrev would be a nice extra.
  
  Propositions
  =========
  
  corpauthor ::=
  (#PCDATA|orgname|orgdiv|orgabbrev|address|link|olink|ulink|emphasis|trademark|replaceable|remark|
  subscript|superscript|inlinegraphic|inlinemediaobject|indexterm)*
  
  corpcredit ::=
  (#PCDATA|orgname|orgdiv|orgabbrev|address|link|olink|ulink|emphasis|trademark|replaceable|remark|
  subscript|superscript|inlinegraphic|inlinemediaobject|indexterm)*
  
  contractsponsor ::=
  (#PCDATA|orgname|orgdiv|orgabbrev|address|link|olink|ulink|emphasis|trademark|replaceable|remark|
  subscript|superscript|inlinegraphic|inlinemediaobject|indexterm)*
  
  confsponsor ::=
  (#PCDATA|orgname|orgdiv|orgabbrev|address|link|olink|ulink|emphasis|trademark|replaceable|remark|
  subscript|superscript|inlinegraphic|inlinemediaobject|indexterm)*
  
  
  Rationale and Use Case:
  
  a. The proposed change is within the scope of the TC's
  charter.
  
  b. The proposed change is consistent with the existing
  DocBook model, especially with the author and editor
  elements. Actually the current situation is not
  consistent at the moment with what is done in the
  author element. The proposed change does not break
  anything, is backward
  compatible and only allows more flexibility.
  
  c. The proposed change is beneficial to a wide
  community of users, especially corp authors and authors
  from administrations where the corporate bodies needs
  to be clearly identified and their division and address
  semantically marked up.
  

Thanks a lot for any help,

-- 
Marc-Aurèle DARCHE  <http://www.cynode.org/>
AFUL <http://www.aful.org/>
Association Francophone des Utilisateurs de Linux/Logiciels Libres
French speaking Linux and Libre Software Users' Association


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