OASIS DocBook TC2

 View Only

Re: [docbook-tc] DocBook V5.0 spec

  • 1.  Re: [docbook-tc] DocBook V5.0 spec

    Posted 06-29-2005 19:14
     MHonArc v2.5.0b2 -->
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    docbook-tc message

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


    Subject: Re: [docbook-tc] DocBook V5.0 spec


    Norman Walsh wrote:
    
    > At long last, here's a draft of the DocBook V5.0 specification.
    
    Thanks Norm, good work.
    
    > Comments most welcome.
    
    I found one typo in appendix B. There is "Hewlett-Packardn" with "n" at 
    the end.
    
    I think that there should be reference to Schematron specification 
    (http://xml.ascc.net/resource/schematron/Schematron2000.html). Probably 
    in non-normative section because DocBook 5.0 is not using ISO Schematron 
      (which is neither yet final standard).
    
    The next comment is not related to specification itself but to DocBook 
    V5.0 in general. I got several questions about DocBook V5.0 and XInclude 
    in past weeks. I think that many users would want to use DocBook V5.0 
    together with XInclude. Current Relax NG grammar doesn't define XInclude 
    element and each user must create his/her own customization that adds 
    XInclude element to appropriate (read all) places.
    
    I think that we should either add xi:include into schema, or define 
    empty named pattern that will be part of all content models. It will be 
    then very easy to redefine this pattern to xi:include to allow it occur 
    everywhere.
    
    I don't know which from those two approaches is better. Adding 
    xi:include directly into grammar would be good for users, but I don't 
    feel it is right thing to define XInclude elements inside DocBook 
    schema. Maybe we could provide two schemas -- pure and XInclude-aware. 
    The later one will be just small customization of the former one.
    
    I would like to know your opinion about level of XInclude support. I 
    think that this is the question that will be raised after we officaly 
    release DocBook 5.0.
    
    Take care,
    
    					Jirka
    
    -- 
    ------------------------------------------------------------------
       Jirka Kosek     e-mail: jirka@kosek.cz     http://www.kosek.cz
    ------------------------------------------------------------------
       Profesionální školení a poradenství v oblasti technologií XML.
          Podívejte se na náš nově spuštěný web http://DocBook.cz
            Podrobný přehled školení http://xmlguru.cz/skoleni/
    ------------------------------------------------------------------
    
    

    S/MIME Cryptographic Signature



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