docbook-apps

  • 1.  Abstract of set not in navigation when set is nested (DocBook 5.1 using Oxygen 18.0)

    Posted 06-22-2017 10:11
    I've found a reproducable error when nesting a set in another set (DocBook
    5.1 using Oxygen 18.0). I thought that it might be caused because the set
    contained articles (new for DocBook 5.1) but it appears again when the set
    contains books. I have reproduced both below.

    This affects chunked HTML and EPUB transforms. Both examples are a set (set
    A) containing one article/book and another set (set B) containing one
    article/book.

    After transform, the articles and books appear in the 'Previous'/'Next'
    links and EPUB transforms, but the abstract of Set B does not. You can
    reach the Set B abstract by the table of contents in the Set A (first chunk
    in HTML output) but not by moving through the document.

    The two examples are very similar. First example (articles)



    schematypens="http://relaxng.org/ns/structure/1.0"?>
    type="application/xml" schematypens="http://purl.oclc.org/dsdl/schematron"?>
    <set xmlns="http://docbook.org/ns/docbook" xmlns:xi="
    http://www.w3.org/2001/XInclude"
    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.1">
    <info>

    <abstract>

    <para>This is a set of two articles, one of which is in another
    set</para>
    </abstract>
    </info>



    <info>
    <abstract>

    <para>Text of abstract</para>
    </abstract>
    </info>
    <simplesect>


    <para>Text of simple section</para>
    </simplesect>



    <set>
    <info>

    <abstract>

    <para>Is this text visible?</para>
    </abstract>
    </info>



    <info>
    <abstract>

    <para>This article is in another set. Did you see the
    abstract of set B?</para>
    </abstract>
    </info>
    <simplesect>


    <para>Text of simple section</para>
    </simplesect>


    </set>

    </set>


    Second example (books):



    schematypens="http://relaxng.org/ns/structure/1.0"?>
    type="application/xml" schematypens="http://purl.oclc.org/dsdl/schematron"?>
    <set xmlns="http://docbook.org/ns/docbook" xmlns:xi="
    http://www.w3.org/2001/XInclude"
    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.1">
    <info>

    <abstract>

    <para>This is a set of two books, one of which is in another
    set</para>
    </abstract>
    </info>
    <book>

    <info>
    <abstract>

    <para>Text of abstract</para>
    </abstract>
    </info>
    <chapter>

    <simplesect>

    <para>Text of simple section</para>
    </simplesect>
    </chapter>
    </book>
    <set>
    <info>

    <abstract>

    <para>Is this text visible?</para>
    </abstract>
    </info>
    <book>

    <info>
    <abstract>

    <para>Text of abstract. Did you see the abstrract of
    set B?</para>
    </abstract>
    </info>
    <chapter>

    <simplesect>

    <para>Text of simple section</para>
    </simplesect>
    </chapter>
    </book>

    </set>

    </set>



  • 2.  Re: [docbook-apps] Abstract of set not in navigation when set is nested (DocBook 5.1 using Oxygen 18.0)

    Posted 06-23-2017 07:05
    Hi John,

    As nobody else seems to be answering this...
    Oxygen 19.0 comes bundled with the Docbook 1.79.2 XSLT stylesheets.
    Looking in the XSLT stylesheet:

    > OXYGEN_INSTALL_DIR\frameworks\docbook\xsl\html\chunk-common.xsl

    there are XSLT templates like "chunk-all-sections" and
    "chunk-first-section-with-parent" which have variables named "next"
    matching various Docbook elements. None of those "next" variables match
    the "set" elements. This is true probably also for the "prev" variable.
    So probably the XSLTs need to be slightly changed to also match the
    "d:set" element on the next and previous variables which are later used
    to generate the links.

    Regards,
    Radu

    Radu Coravu
    <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
    http://www.oxygenxml.com

    On 6/22/2017 1:10 PM, John Tait wrote:
    > I've found a reproducable error when nesting a set in another set
    > (DocBook 5.1 using Oxygen 18.0). I thought that it might be caused
    > because the set contained articles (new for DocBook 5.1) but it appears
    > again when the set contains books. I have reproduced both below.
    >
    > This affects chunked HTML and EPUB transforms. Both examples are a set
    > (set A) containing one article/book and another set (set B) containing
    > one article/book.
    >
    > After transform, the articles and books appear in the 'Previous'/'Next'
    > links and EPUB transforms, but the abstract of Set B does not. You can
    > reach the Set B abstract by the table of contents in the Set A (first
    > chunk in HTML output) but not by moving through the document.
    >
    > The two examples are very similar. First example (articles)
    >
    >
    >
    > > schematypens="http://relaxng.org/ns/structure/1.0"?>
    > > type="application/xml" schematypens="http://purl.oclc.org/dsdl/schematron"?>
    > <set xmlns="http://docbook.org/ns/docbook"
    > xmlns:xi="http://www.w3.org/2001/XInclude"
    > xmlns:xlink="http://www.w3.org/1999/xlink" version="5.1">
    > <info>
    >
    > <abstract>
    >
    > <para>This is a set of two articles, one of which is in
    > another set</para>
    > </abstract>
    > </info>
    >
    >

    >
    > <info>
    > <abstract>
    >
    > <para>Text of abstract</para>
    > </abstract>
    > </info>
    > <simplesect>
    >
    >
    > <para>Text of simple section</para>
    > </simplesect>
    >

    >
    >
    > <set>
    > <info>
    >
    > <abstract>
    >
    > <para>Is this text visible?</para>
    > </abstract>
    > </info>
    >
    >

    >
    > <info>
    > <abstract>
    >
    > <para>This article is in another set. Did you see
    > the abstract of set B?</para>
    > </abstract>
    > </info>
    > <simplesect>
    >
    >
    > <para>Text of simple section</para>
    > </simplesect>
    >

    >
    > </set>
    >
    > </set>
    >
    >
    > Second example (books):
    >
    >
    >
    > > schematypens="http://relaxng.org/ns/structure/1.0"?>
    > > type="application/xml" schematypens="http://purl.oclc.org/dsdl/schematron"?>
    > <set xmlns="http://docbook.org/ns/docbook"
    > xmlns:xi="http://www.w3.org/2001/XInclude"
    > xmlns:xlink="http://www.w3.org/1999/xlink" version="5.1">
    > <info>
    >
    > <abstract>
    >
    > <para>This is a set of two books, one of which is in another
    > set</para>
    > </abstract>
    > </info>
    > <book>
    >
    > <info>
    > <abstract>
    >
    > <para>Text of abstract</para>
    > </abstract>
    > </info>
    > <chapter>
    >
    > <simplesect>
    >
    > <para>Text of simple section</para>
    > </simplesect>
    > </chapter>
    > </book>
    > <set>
    > <info>
    >
    > <abstract>
    >
    > <para>Is this text visible?</para>
    > </abstract>
    > </info>
    > <book>
    >
    > <info>
    > <abstract>
    >
    > <para>Text of abstract. Did you see the abstrract of
    > set B?</para>
    > </abstract>
    > </info>
    > <chapter>
    >
    > <simplesect>
    >
    > <para>Text of simple section</para>
    > </simplesect>
    > </chapter>
    > </book>
    >
    > </set>
    >
    > </set>





  • 3.  Re: [docbook-apps] Abstract of set not in navigation when set is nested (DocBook 5.1 using Oxygen 18.0)

    Posted 06-23-2017 16:33
    Hi Radu,
    Thanks for tracking down the cause. Indeed, when the DocBook schema was
    changed to allow nesting of set elements, this XSL template was not
    updated. I see that you filed an issue on the github site for DocBook
    XSL, so that will get this in the queue to be fixed for the next release.

    Bob Stayton
    Sagehill Enterprises
    bobs@sagehill.net

    On 6/23/2017 12:04 AM, Radu Coravu wrote:
    > Hi John,
    >
    > As nobody else seems to be answering this...
    > Oxygen 19.0 comes bundled with the Docbook 1.79.2 XSLT stylesheets.
    > Looking in the XSLT stylesheet:
    >
    >> OXYGEN_INSTALL_DIR\frameworks\docbook\xsl\html\chunk-common.xsl
    >
    > there are XSLT templates like "chunk-all-sections" and
    > "chunk-first-section-with-parent" which have variables named "next"
    > matching various Docbook elements. None of those "next" variables match
    > the "set" elements. This is true probably also for the "prev" variable.
    > So probably the XSLTs need to be slightly changed to also match the
    > "d:set" element on the next and previous variables which are later used
    > to generate the links.
    >
    > Regards,
    > Radu
    >
    > Radu Coravu
    > <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
    > http://www.oxygenxml.com
    >
    > On 6/22/2017 1:10 PM, John Tait wrote:
    >> I've found a reproducable error when nesting a set in another set
    >> (DocBook 5.1 using Oxygen 18.0). I thought that it might be caused
    >> because the set contained articles (new for DocBook 5.1) but it appears
    >> again when the set contains books. I have reproduced both below.
    >>
    >> This affects chunked HTML and EPUB transforms. Both examples are a set
    >> (set A) containing one article/book and another set (set B) containing
    >> one article/book.
    >>
    >> After transform, the articles and books appear in the 'Previous'/'Next'
    >> links and EPUB transforms, but the abstract of Set B does not. You can
    >> reach the Set B abstract by the table of contents in the Set A (first
    >> chunk in HTML output) but not by moving through the document.
    >>
    >> The two examples are very similar. First example (articles)
    >>
    >>
    >>
    >> >> schematypens="http://relaxng.org/ns/structure/1.0"?>
    >> >> type="application/xml"
    >> schematypens="http://purl.oclc.org/dsdl/schematron"?>
    >> <set xmlns="http://docbook.org/ns/docbook"
    >> xmlns:xi="http://www.w3.org/2001/XInclude"
    >> xmlns:xlink="http://www.w3.org/1999/xlink" version="5.1">
    >> <info>
    >>
    >> <abstract>
    >>
    >> <para>This is a set of two articles, one of which is in
    >> another set</para>
    >> </abstract>
    >> </info>
    >>
    >>

    >>
    >> <info>
    >> <abstract>
    >>
    >> <para>Text of abstract</para>
    >> </abstract>
    >> </info>
    >> <simplesect>
    >>
    >>
    >> <para>Text of simple section</para>
    >> </simplesect>
    >>

    >>
    >>
    >> <set>
    >> <info>
    >>
    >> <abstract>
    >>
    >> <para>Is this text visible?</para>
    >> </abstract>
    >> </info>
    >>
    >>

    >>
    >> <info>
    >> <abstract>
    >>
    >> <para>This article is in another set. Did you see
    >> the abstract of set B?</para>
    >> </abstract>
    >> </info>
    >> <simplesect>
    >>
    >>
    >> <para>Text of simple section</para>
    >> </simplesect>
    >>

    >>
    >> </set>
    >>
    >> </set>
    >>
    >>
    >> Second example (books):
    >>
    >>
    >>
    >> >> schematypens="http://relaxng.org/ns/structure/1.0"?>
    >> >> type="application/xml"
    >> schematypens="http://purl.oclc.org/dsdl/schematron"?>
    >> <set xmlns="http://docbook.org/ns/docbook"
    >> xmlns:xi="http://www.w3.org/2001/XInclude"
    >> xmlns:xlink="http://www.w3.org/1999/xlink" version="5.1">
    >> <info>
    >>
    >> <abstract>
    >>
    >> <para>This is a set of two books, one of which is in another
    >> set</para>
    >> </abstract>
    >> </info>
    >> <book>
    >>
    >> <info>
    >> <abstract>
    >>
    >> <para>Text of abstract</para>
    >> </abstract>
    >> </info>
    >> <chapter>
    >>
    >> <simplesect>
    >>
    >> <para>Text of simple section</para>
    >> </simplesect>
    >> </chapter>
    >> </book>
    >> <set>
    >> <info>
    >>
    >> <abstract>
    >>
    >> <para>Is this text visible?</para>
    >> </abstract>
    >> </info>
    >> <book>
    >>
    >> <info>
    >> <abstract>
    >>
    >> <para>Text of abstract. Did you see the abstrract of
    >> set B?</para>
    >> </abstract>
    >> </info>
    >> <chapter>
    >>
    >> <simplesect>
    >>
    >> <para>Text of simple section</para>
    >> </simplesect>
    >> </chapter>
    >> </book>
    >>
    >> </set>
    >>
    >> </set>
    >
    >
    >
    > ---------------------------------------------------------------------
    > To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
    > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >
    >
    >