[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: AW: [dita] Missing <address> elements in DITA 1.1 bookmap <organization> and<person>
Hi Chris, I think that this would require the following changes - is this correct? 1. Add a new <contactdetail> element to base topic and map metadata, as a child of <author> and <publisher>. 2. In the XNal domain, change <authorinformation> to <contactinformation>, and specialize it from contactdetail instead of from author. 3. Modify the bookmap module to allow contactdetail inside publisherinformation 4. Modify the bookmap DTD to change the xnal specialization (replacement for contactdetail instead of for author) 5. Documentation changes - * New base element * Update content models for existing elements * Revise description of XNAL domain, and change the new elements This would still not allow the contact information to be inside of <editor>, <reviewer>, etc. Those are specializations of the <data> element, which would not allow the new contactdetail. So, there is still no way for the XNAL domain to add elements to those locations. Technically, of course, this is all possible - though it still misses many of the elements that had address information in the demo bookmap. However, I'm not sure that we can do this without delaying the release of 1.1. In order to stay on the current schedule, we would need to get agreement on a new element, its attributes, and content model at next Tuesday's meeting. We would then need to complete all of the updates and have them tested by the end of the week. My own inclination is to stick with the current schedule for 1.1, and look for an appropriate solution in 1.2 based on the domain integration capabilities planned for that release. Robert D Anderson IBM Authoring Tools Development Chief Architect, DITA Open Toolkit (507) 253-8787, T/L 553-8787 "SeicoDyne DITA" <dita@seicodyne.c h> To Robert D 05/04/2007 01:51 Anderson/Rochester/IBM@IBMUS, PM <dita@lists.oasis-open.org> cc Subject AW: [dita] Missing <address> elements in DITA 1.1 bookmap <organization> and <person> Hi Robert, I still like to find a way to get address information into <publisherinformation> and maybe also into <editor>, <reviewer> etc. In the current solution we have an authorinformation element derived from author. May I propose to add as topic specialization one new child element into <publisherinformation>, <author>, <editor> etc e.g. a <contactdetail> element. The <contactdetail> element can be used as a general container for any type of name or addressinformation without needing the xnal domain, and as well of course for the xnal domain specialization. Example: use of <contactdetail> without xnal <publisherinformation> <contactdetail type="organizationname">Kone Oy</contactdetail> <contactdetail type="location">Hyvinkää</contactdetail> <contactdetail type="country">Finland</contactdetail> </publisherinformation> The xnal domain might then be specialized from the <contactdetail> element instead of the <author> element. Bookmap.dtd: <!ENTITY % contactdetail "contactdetail | %xnal-d-contactdetail;" > xnalDomain.ent: <!ENTITY % xnal-d-contactdetail "contactinformation" > xnalDomain.mod <!ELEMENT contactinformation ((%personinfo; | %organizationinfo;)*) > Example: use of <contactinformation> as part of xnal <publisherinformation> <contactinformation> <organizationinfo> <namedetails> <organizatinnamedetails> <organizationname>Kone Oy</organizationname> </organizationnamedetails> </namedetails> <addressdetails> <locality>Hynikää</locality> <country>Finland</country> <oranizationinfo> <contactinformation> </publisherinformation> What do you think, might that be a reasonable solution. Best regards Chris -----Ursprüngliche Nachricht----- Von: Robert D Anderson [mailto:robander@us.ibm.com] Gesendet: Freitag, 27. April 2007 20:55 An: dita@lists.oasis-open.org Betreff: Re: [dita] Missing <address> elements in DITA 1.1 bookmap <organization> and <person> Hi Chris, I found the proposal for this change [1] and the minutes from the meeting where we discussed it [2], but the minutes do not record any of the actual discussion. I'm pretty sure this side effect was raised at the time, but I can't find a record of it. The authorinformation element is based off of <author>. This line in bookmap says that any place we allow author, we should also allow XNAL specializations of author: <!ENTITY % author "author | %xnal-d-author;" > The personinfo and organizationinfo elements are specializations of <data>. So, the only way to add them directly to bookmap outside of the authorinformation container would be as a domain replacement for data. The personinfo and organizationinfo tags would then show up virtually everywhere in bookmap, re-creating the problem that forced our original change. Given that both person and organization are defined in bookmap, it is not possible to specialize them directly in the XNAL domain. There are still proposals for DITA 1.2 that would make it easier to integrate bookmap and a domain, but that won't help with 1.1. The person and organization elements are allowed in the following contexts: publisherinformation, published, reviewed, edited, tested, approved, maintainer, bookowner All of these have an href attribute. Would it be possible for you to define a full set of information in the authorinformation tag, and then reference it with an href? I know many of my users are using this method to provide more information about the maintainer: <authorinformation id="maint"> ... </authorinformation> ... <maintainer href="#maint"/> I think that the only other options are 1) to allow personinfo and organizationinfo anywhere we allow data, which is a big usability hit, or 2) remove publisherinformation from bookmap and move it entirely to the XNAL domain. Both of these seem like very large changes at this point in the review cycle. What do you think? Robert D Anderson IBM Authoring Tools Development Chief Architect, DITA Open Toolkit (507) 253-8787, T/L 553-8787 [1] http://lists.oasis-open.org/archives/dita/200606/msg00084.html [2] http://lists.oasis-open.org/archives/dita/200606/msg00119.html dita@seicodyne.ch wrote on 04/27/2007 04:32:54 AM: > For DITA 1.1 we invented xNAL to describe addresses and names. > > While upgrading a customers environment from DITA 1.0 to DITA 1.1 we > recognized that the address definitions e.g. in publisherinformation > of bookmap have not been replaced with xNAL, they have been completely > removed. > > I guess that removal happend by accident. Indeed, it is a shame that I > have not noticed that earlier, and needed a cutomer notified us, but > at least it can just in time. > > Correcting it might be a minor issue, as we may have to change > > bookmap.dtd > <!ENTITY % author "author | %xnal-d-author;" > into <!ENTITY % author > "author | %xnal-d-author;" > <!ENTITY % person "person | > %xnal-d-personinfo;" > <!ENTITY % organization "organization | > %xnal-d-organizationinfo;" > > > and in xNAL.ent > <!ENTITY % xnal-d-author "authorinformation" > into <!ENTITY % > xnal-d-author "authorinformation" > <!ENTITY % xnal-d- person " > personinfo " > <!ENTITY % xnal-d- organization " organizationinfo " > > > Best regards > > Chris
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]