DocBook 5 to Webhelp: problem with external entities

[Fran Pena]

Hi,

I am experiencing problems exporting a DocBook 5 book to webhelp, when that book include external entities as chapters. The first run of the ant converter seems to create a valid webhelp, but Oxygen automatically runs several times the converter, and the final webhelp only contains the last external entity (not the whole book). I have try with both DTD entities and XInclude.

The problem seems to disappear when I execute de ant converter from the command line, since the converter runs only once.

Thanks in advance,
Fran Pena

[mihaela]

Hello,

Do you use the Docbook WebHelp predefined transformation scenario when transforming the book?

Could you please send us a small book sample that reproduces your problem and the content of the ANT transformation tab?
You can contact us directly on the support@oxygenxml.com email address.

Thanks,
Mihaela

[mihaela]

Hello,

Thank you for the samples send on the support email address.
The book sample has no title specified, and it seems that this is what generates the problem.
I have registered this issue in our internal issue tracker and we will try to fix it.

What you can do is to specify a title element in your book. Please let us known if the you experience further problems.

Best regards,
Mihaela

[Fran Pena]

Thank you for your help, it worked!. For anyone who might be interested, I reproduce a valid example of a DocBook 5 book calling external entities with XInclude. I have successfully transformed this example into webhelp with Oxygen, using the DocBook 5 predefined scenario "Docbook Webhelp". This is the main file, main.xml:

Code: Select all

<?xml version="1.0" encoding="UTF-8"?>

<?xml-model href="http://www.oasis-open.org/docbook/xml/5.0/rng/docbookxi.rng" schematypens="http://relaxng.org/ns/structure/1.0"?>

<book xmlns="http://docbook.org/ns/docbook" 

      xmlns:xi="http://www.w3.org/2001/XInclude"

      xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">

    <title>kjehkuedheiu</title>

    <part>

        <title>First Part</title>

        <subtitle>Subtitle of First Part</subtitle>

        <xi:include href="intro.xml"/>

    </part>

    <part>

        <title>First ddPart</title>

        <subtitle>Subtitddle of First Part</subtitle>

        <xi:include href="intro2.xml"/>

    </part>

</book>

This is one of the external entity intro.xml (the other one, intro2.xml, can be equal to this):

Code: Select all

<?xml version="1.0" encoding="UTF-8"?>

<?xml-model href="http://www.oasis-open.org/docbook/xml/5.0/rng/docbookxi.rng" schematypens="http://relaxng.org/ns/structure/1.0"?>

<chapter xmlns="http://docbook.org/ns/docbook" 

    xmlns:xi="http://www.w3.org/2001/XInclude"

    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">    

    <title>Chapter Title</title>

    <subtitle>Subtitle of Chapter</subtitle>

    <sect1>

        <title>Section1 Title</title>

         <subtitle>Subtitle of Section 1</subtitle>

         <para>Text</para>

    </sect1>

</chapter>

Sincerely,
Fran Pena

[Radu]

Hi Fran,

In Oxygen 13.2 which was just released you will be able to produce Docbook WebHelp even if the title is missing from the Docbook XMLs.

Regards,
Radu