OASIS Darwin Information Typing Architecture (DITA) TC

 View Only

RE: [dita] Book title in bookmap

  • 1.  RE: [dita] Book title in bookmap

    Posted 04-09-2006 14:15
     MHonArc v2.5.0b2 -->
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    dita message

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


    Subject: RE: [dita] Book title in bookmap


    Hmf, reading further down the thread I see I answered in the middle... My
    take is let's do the minimum now to get bookmap working in 1.1, and move
    translatable attributes to elements in 1.2.
    
    
    Best Regards,
    Gershon
    
    
    -----Original Message-----
    From: Gershon L Joseph [mailto:gershon@tech-tav.com] 
    Sent: Sunday, April 09, 2006 4:42 PM
    To: 'Farwell, Kevin'; 'Robert D Anderson'; dita@lists.oasis-open.org
    Subject: RE: [dita] Book title in bookmap
    
    Since we want to minimize the changes needed for 1.1, I also vote for option
    1. Having elements for the map titles will also bring joy to those who
    convert non-DITA XML documents to DITA (since the title attributes in the
    map often inherit characters and markup that's not valid in XML attributes).
    
    
    Best Regards,
    Gershon
    
    
    -----Original Message-----
    From: Farwell, Kevin [mailto:Kevin.Farwell@lionbridge.com]
    Sent: Wednesday, April 05, 2006 6:36 PM
    To: Robert D Anderson; dita@lists.oasis-open.org
    Subject: RE: [dita] Book title in bookmap
    
    Hello,
    
    I'd vote for option 1. I'm not in favor of having any translatable content
    in the book map. That just makes one more file to translate, one more place
    to manage terminology, one more file to version, and one more place mistakes
    can be made. If the book file is only a collection of references to external
    content, the efficiency of the map is preserved.
    
    
    The conflict is unavoidable. People using book maps now, with their titles
    in attributes, will have to rework their files either way.
    
    Kevin
    
    -----Original Message-----
    From: Robert D Anderson [mailto:robander@us.ibm.com]
    Sent: Monday, April 03, 2006 2:09 PM
    To: dita@lists.oasis-open.org
    Subject: [dita] Book title in bookmap
    
    
    Don and I were working on the bookmap DTD, and ran in to a problem. When we
    originally put the proposal together, we were planning for one large release
    rather than the current 1.1 and 1.2 releases. As part of the design, we
    counted on proposed feature number 11, which had already been
    approved:
    http://www.oasis-open.org/committees/download.php/13734/IssueNumber11.ht
    ml
    
    This is the proposal to make translatable attributes into elements. One of
    the items in that proposal is to add a <title> element to map, to be used
    instead of the title attribute. The book model really needs this title
    element in order to allow for more structured book titles, such as title +
    library information. Unfortunately, feature #11 was moved to 1.2, so it will
    not be released with bookmap. I see three possibilities:
    1. We force the title into the bookmeta element. This could work, but will
    cause conflicts with the title element once 1.2 is released (and bookmap is
    updated for the change).
    2. We do that one part of #11 in 1.1 -- we just allow the title element
    inside map. Leave the others for 1.2.
    3. We let the 1.1 scope creep to include all of #11
    
    I would vote for #2 - the partial implementation that brings the title
    element into maps. Any other thoughts?
    
    Robert D Anderson
    IBM Authoring Tools Development
    Chief Architect, DITA Open Toolkit
    (507) 253-8787, T/L 553-8787
    
    
    
    
    
    
    
    


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