OASIS Darwin Information Typing Architecture (DITA) TC

 View Only
  • 1.  FW: RNG to DTD

    Posted 02-04-2019 23:05




    Hi Scott,
     
    Here is discussion from last summer about why no amendments in booklists.  Part of it is a technical issue.
     

    Ãric Sirois
    DITA Toolsmith
     
    IXIASOFT 
    825 Querbes, Suite 200, MontrÃal, QuÃbec, Canada, H2V 3X1
    tel  + 1 514 279-4942  /  toll free + 1 877 279-4942
    mobile + 1 647 462-3620
    eric.sirois@ixiasoft.com
    /
    www.ixiasoft.com  

     


     


    From: Eliot Kimber <ekimber@contrext.com>

    Sent: August 13, 2018 10:53 AM
    To: Ãric Sirois <eric.sirois@ixiasoft.com>
    Cc: Kristen James Eberlein <kris@eberleinconsulting.com>
    Subject: Re: RNG to DTD


     
    The RNG must conform to DTD constraints, unfortunately, so a given element must have the same content model everywhere it is used. That means booklists has to be a union of everything that would be wanted at the front
    or back of a manual or you would need two different booklist element types in order to have different content models. That seems like a reasonable solution, e.g. booklists-frontmatter , booklists-backmatter . Ideally we would have a domain that defines the
    abstract base type from which specific booklist specializations would be derived (i.e., move current booklists to a domain and then use that domain as the basis for whatever specialized booklists you need). But I realize that goes beyond the current remit
    for BookMap 2.0.
     
    Cheers,
     
    E.
     



    --


    Eliot Kimber


    http://contrext.com


     



     
     

    From:
    Eric Sirois < eric.sirois@ixiasoft.com >
    Date: Monday, August 13, 2018 at 9:35 AM
    To: Eliot Kimber < ekimber@contrext.com >
    Cc: Kristen James Eberlein < kris@eberleinconsulting.com >
    Subject: RNG to DTD


     

    Hi Eliot,
     
    I m working on the changes to bookmap for DITA 2.0 and one change we wanted to do was to move <amendments> into <booklists>.  That s easily doable with RNG and XSD, but no so much with DTDs and likely the reason why it's
    designed that way in the current DTDs.  The concern that I have at the moment is that when we do an RNG to DTD conversion, we are going to run into the same issue again because it s not technically feasible in the DTD world unless I m missing something. 

     
    The technical issue is that the content model for booklists front matter would be different than the content model for booklists in the backmatter.  If we can t get the design we want to work in the DTD world, then I
    think we should leave things as is for DITA 2.0.
     
    Thoughts?
     
    Ãric Sirois
    DITA Toolsmith
     
    IXIASOFT 
    825 Querbes, Suite 200, MontrÃal, QuÃbec, Canada, H2V 3X1
    tel  + 1 514 279-4942  /  toll free + 1 877 279-4942
    mobile + 1 647 462-3620
    eric.sirois@ixiasoft.com
    /
    www.ixiasoft.com  

     

     






  • 2.  Re: RNG to DTD

    Posted 02-04-2019 23:11




    Given that, I think we should withdraw
    https://github.com/oasis-tcs/dita/issues/83
     
    Thanks,
     
    --Scott
     

    From:
    Ãric Sirois <eric.sirois@ixiasoft.com>
    Date: Monday, February 4, 2019 at 4:05 PM
    To: Scott Hudson <scott.hudson@jeppesen.com>
    Cc: DITA TC <dita@lists.oasis-open.org>
    Subject: FW: RNG to DTD


     

    Hi Scott,
     
    Here is discussion from last summer about why no amendments in booklists.  Part of it is a technical issue.
     

    Ãric Sirois
    DITA Toolsmith
     
    IXIASOFT 
    825 Querbes, Suite 200, MontrÃal, QuÃbec, Canada, H2V 3X1
    tel  + 1 514 279-4942  /  toll free + 1 877 279-4942
    mobile + 1 647 462-3620
    eric.sirois@ixiasoft.com
    /

    www.ixiasoft.com  

     


     


    From: Eliot Kimber <ekimber@contrext.com>

    Sent: August 13, 2018 10:53 AM
    To: Ãric Sirois <eric.sirois@ixiasoft.com>
    Cc: Kristen James Eberlein <kris@eberleinconsulting.com>
    Subject: Re: RNG to DTD


     
    The RNG must conform to DTD constraints, unfortunately, so a given element must have the same content model everywhere it is used. That means booklists has to be a union of everything that would be wanted at the
    front or back of a manual or you would need two different booklist element types in order to have different content models. That seems like a reasonable solution, e.g. booklists-frontmatter , booklists-backmatter . Ideally we would have a domain that defines
    the abstract base type from which specific booklist specializations would be derived (i.e., move current booklists to a domain and then use that domain as the basis for whatever specialized booklists you need). But I realize that goes beyond the current remit
    for BookMap 2.0.
     
    Cheers,
     
    E.
     



    --


    Eliot Kimber


    http://contrext.com


     



     
     

    From:
    Eric Sirois < eric.sirois@ixiasoft.com >
    Date: Monday, August 13, 2018 at 9:35 AM
    To: Eliot Kimber < ekimber@contrext.com >
    Cc: Kristen James Eberlein < kris@eberleinconsulting.com >
    Subject: RNG to DTD


     

    Hi Eliot,
     
    I m working on the changes to bookmap for DITA 2.0 and one change we wanted to do was to move <amendments> into <booklists>.  That s easily doable with RNG and XSD, but no so much with DTDs and likely the reason
    why it's designed that way in the current DTDs.  The concern that I have at the moment is that when we do an RNG to DTD conversion, we are going to run into the same issue again because it s not technically feasible in the DTD world unless I m missing something. 

     
    The technical issue is that the content model for booklists front matter would be different than the content model for booklists in the backmatter.  If we can t get the design we want to work in the DTD world, then
    I think we should leave things as is for DITA 2.0.
     
    Thoughts?
     
    Ãric Sirois
    DITA Toolsmith
     
    IXIASOFT 
    825 Querbes, Suite 200, MontrÃal, QuÃbec, Canada, H2V 3X1
    tel  + 1 514 279-4942  /  toll free + 1 877 279-4942
    mobile + 1 647 462-3620
    eric.sirois@ixiasoft.com
    /

    www.ixiasoft.com