docbook-apps

  • 1.  Re: [docbook-apps] Saxon 6 or 9 ? And extensions - extensions/saxon65 or use docbook-xsl-saxon

    Posted 07-23-2012 17:58
    Hi Richard,
    The DocBook XSL stylesheets that are the most solid are written in XSL 1.0 (version 1.77.1 is the latest distribution), for which Saxon 6 is most compatible. Saxon 9 is an XSL 2.0 processor that can fall back to 1.0 behavior if you use those stylesheets, but you may run into compatibility issues.

    The XSL 1.0 stylesheets are available in two versions: docbook-xsl-1.77.1 is for non-namespaced DocBook (DocBook version 4 and earlier), and docbook-xsl-ns-1.77.1 is for namespaced DocBook (version 5). I would recommend the latter for you.

    There are also new XSL 2.0 stylesheets for DocBook, and some people are starting to use them, but they are still under development and I personally can't speak to their current status and any extensions.

    The current Saxon extensions are indeed for version 6. They are included with the docbook-xsl distribution in the extensions directory, so I'm not clear why anyone would need a separate docbook-xsl-saxon-1.0 distribution?

    Bob Stayton
    Sagehill Enterprises
    bobs@sagehill.net





  • 2.  Re: [docbook-apps] Saxon 6 or 9 ? And extensions - extensions/saxon65 or use docbook-xsl-saxon

    Posted 07-23-2012 18:56
    Hi Richard,

    Am Montag, 23. Juli 2012, 10:58:21 schrieb Bob Stayton:
    > The DocBook XSL stylesheets that are the most solid are written in XSL 1.0
    > (version 1.77.1 is the latest distribution), for which Saxon 6 is most
    > compatible. Saxon 9 is an XSL 2.0 processor that can fall back to 1.0
    > behavior if you use those stylesheets, but you may run into compatibility
    > issues.

    I tried to run Saxon9 with the XSLT 1.0 stylesheets and it didn't work due to
    EXSLT extension(s). Saxon9 doesn't support the exsl:document, saxon:output,
    and exsl:node-set extensions anymore, because XSLT 2 has already a similar
    element or it's not needed anymore.

    See also my thread last year about this topic (originally with Calabash):
    https://lists.oasis-open.org/archives/docbook-apps/201112/msg00086.html

    --
    Gruß/Regards
    Thomas Schraitle




  • 3.  RE: [docbook-apps] Saxon 6 or 9 ? And extensions - extensions/saxon65 or use docbook-xsl-saxon

    Posted 07-30-2012 09:38

    Bob,

    Thanks for this; it is pretty much as I thought.
    I'll use Saxon6 then, and the namespaced 1.77 stylesheets.


    If the docbook-xsl-saxon-1.0 is deprecated perhaps it could be removed from SourceForge, or something be put in its README to that effect.


    Regards,
    Richard.



    ________________________________
    From: Bob Stayton [mailto:bobs@sagehill.net]
    Sent: 23 July 2012 18:58
    To: Kerry, Richard; docbook-apps@lists.oasis-open.org
    Subject: Re: [docbook-apps] Saxon 6 or 9 ? And extensions - extensions/saxon65 or use docbook-xsl-saxon

    Hi Richard,
    The DocBook XSL stylesheets that are the most solid are written in XSL 1.0 (version 1.77.1 is the latest distribution), for which Saxon 6 is most compatible. Saxon 9 is an XSL 2.0 processor that can fall back to 1.0 behavior if you use those stylesheets, but you may run into compatibility issues.

    The XSL 1.0 stylesheets are available in two versions: docbook-xsl-1.77.1 is for non-namespaced DocBook (DocBook version 4 and earlier), and docbook-xsl-ns-1.77.1 is for namespaced DocBook (version 5). I would recommend the latter for you.

    There are also new XSL 2.0 stylesheets for DocBook, and some people are starting to use them, but they are still under development and I personally can't speak to their current status and any extensions.

    The current Saxon extensions are indeed for version 6. They are included with the docbook-xsl distribution in the extensions directory, so I'm not clear why anyone would need a separate docbook-xsl-saxon-1.0 distribution?

    Bob Stayton
    Sagehill Enterprises
    bobs@sagehill.net<mailto:bobs@sagehill.net>