docbook-apps

Building one of our books in WebHelp format gives a fatal error:

No template for "/book/chapter/mediaobject/imageobject/imagedata" (or
any of its leaves) exists in the context named "title" in the "en"
localization.
XPath error : Invalid type xmlXPathCompiledEval: 1
objects left on the stack.

A took some investigation to boil down the issue to this:

A construct like this makes WebHelp builds fail:

<mediaobject>
<imageobject><imagedata .../>...</imageobject>
<textobject><programlisting>...</programlisting></textobject>
</mediaobject>

The failure doesn't occur when the construct is changed to either of these:

a) Replacing <programlisting> with <phrase>:

<mediaobject>
<imageobject><imagedata .../>...</imageobject>
<textobject><phrase>...</phrase></textobject>
</mediaobject>

b) Removing the <imageobject>:

<mediaobject>
<textobject><programlisting>...</programlisting></textobject>
</mediaobject>

Note that the construct that makes WebHelp fail is perfectly legal
according to the DocBook DTD. We don't get any errors when building
other formats (XHTML, FO, etc.). Since this is specific to WebHelp, I
wonder if we've simply hit a bug.

Let me know, and I'll file a bug report on SF.net.

--
Cheers,

Stefan Hinz <stefan.hinz@oracle.com>, MySQL Documentation Manager

Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc

ORACLE Deutschland B.V.& Co. KG
Registered Office: Riesstr. 25, 80992 Muenchen, Germany
Commercial Register: Local Court Of Munich, HRA 95603
Managing Director: Jürgen Kunz

General Partner: ORACLE Deutschland Verwaltung B.V.
Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697
Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher

On 02/25/2013 05:14 AM, Stefan Hinz wrote:
> Note that the construct that makes WebHelp fail is perfectly legal
> according to the DocBook DTD. We don't get any errors when building
> other formats (XHTML, FO, etc.). Since this is specific to WebHelp, I
> wonder if we've simply hit a bug.
>
> Let me know, and I'll file a bug report on SF.net.

It's very odd that this would affect only webhelp and not other outputs.
Have you tried with just chunked html and htmlhelp? There's nothing in
the webhelp directly related to those constructs.

Could you post a small test case that causes the problem? I just added
that construct to a test document and couldn't get it to fail (using
xsltproc or saxon).

David

Hi David,

Thanks for looking into this! Test case attached.

I should probably mention I'm using the 1.78.0 XSL style sheets, with a
mildly modified webhelp/template/ folder (just a couple of images
replaced with branded versions, such as logo and favicon).

Here again is the error I'm getting when trying to build WebHelp:

No template for "/book/chapter/mediaobject/imageobject/imagedata" (or
any of its leaves) exists in the context named "title" in the "en"
localization.
No template for "/book/chapter/mediaobject/imageobject" (or any of its
leaves) exists in the context named "title" in the "en" localization.
XPath error : Invalid type
xmlXPathCompiledEval: 1 objects left on the stack.

Building the following formats works fine, though:

- HTML (one file)
- HTML (chunked per chapter)
- HTML (chunked per section)*
- XHTML (one file)
- XHTML (chunked per chapter)
- XHTML (chunked per section)*
- EPUB
- FO
- PDF

* Per-section chunking doesn't make sense for the little test case, but
it works flawlessly, anyway.

Cheers,

Stefan

On 25.02.2013 17:02, David Cramer wrote:
> On 02/25/2013 05:14 AM, Stefan Hinz wrote:
>> Note that the construct that makes WebHelp fail is perfectly legal
>> according to the DocBook DTD. We don't get any errors when building
>> other formats (XHTML, FO, etc.). Since this is specific to WebHelp, I
>> wonder if we've simply hit a bug.
>>
>> Let me know, and I'll file a bug report on SF.net.
>
> It's very odd that this would affect only webhelp and not other outputs.
> Have you tried with just chunked html and htmlhelp? There's nothing in
> the webhelp directly related to those constructs.
>
> Could you post a small test case that causes the problem? I just added
> that construct to a test document and couldn't get it to fail (using
> xsltproc or saxon).
>
> David
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>


--
Cheers,

Stefan Hinz <stefan.hinz@oracle.com>, MySQL Documentation Manager

Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc

ORACLE Deutschland B.V.& Co. KG
Registered Office: Riesstr. 25, 80992 Muenchen, Germany
Commercial Register: Local Court Of Munich, HRA 95603
Managing Director: Jürgen Kunz

General Partner: ORACLE Deutschland Verwaltung B.V.
Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697
Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher

</stefan.hinz@oracle.com>

Hi,
Usually that error message comes when trying to process the given element in
mode="title.markup" or mode="object.title.markup", which triggers using the
gentext templates. In this case, an imagedata element is likely being
processed in that mode (the imageobject error is an artifact of the
stylesheet trying to fall back to the title of the failing element). So
look for instances of that mode in the webhelp stylesheet that is not in the
other stylesheets.

The title.markup mode can also be used when resolving cross references.
Does your document contain an xref to an imagedata element?

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

--------------------------------------------------
From: "Stefan Hinz" <stefan.hinz@oracle.com>
Sent: Tuesday, February 26, 2013 3:31 AM
To: <docbook-apps@lists.oasis-open.org>
Subject: Re: [docbook-apps] WebHelp bug?

> Hi David,
>
> Thanks for looking into this! Test case attached.
>
> I should probably mention I'm using the 1.78.0 XSL style sheets, with a
> mildly modified webhelp/template/ folder (just a couple of images
> replaced with branded versions, such as logo and favicon).
>
> Here again is the error I'm getting when trying to build WebHelp:
>
> No template for "/book/chapter/mediaobject/imageobject/imagedata" (or
> any of its leaves) exists in the context named "title" in the "en"
> localization.
> No template for "/book/chapter/mediaobject/imageobject" (or any of its
> leaves) exists in the context named "title" in the "en" localization.
> XPath error : Invalid type
> xmlXPathCompiledEval: 1 objects left on the stack.
>
> Building the following formats works fine, though:
>
> - HTML (one file)
> - HTML (chunked per chapter)
> - HTML (chunked per section)*
> - XHTML (one file)
> - XHTML (chunked per chapter)
> - XHTML (chunked per section)*
> - EPUB
> - FO
> - PDF
>
> * Per-section chunking doesn't make sense for the little test case, but
> it works flawlessly, anyway.
>
> Cheers,
>
> Stefan
>
> On 25.02.2013 17:02, David Cramer wrote:
>> On 02/25/2013 05:14 AM, Stefan Hinz wrote:
>>> Note that the construct that makes WebHelp fail is perfectly legal
>>> according to the DocBook DTD. We don't get any errors when building
>>> other formats (XHTML, FO, etc.). Since this is specific to WebHelp, I
>>> wonder if we've simply hit a bug.
>>>
>>> Let me know, and I'll file a bug report on SF.net.
>>
>> It's very odd that this would affect only webhelp and not other outputs.
>> Have you tried with just chunked html and htmlhelp? There's nothing in
>> the webhelp directly related to those constructs.
>>
>> Could you post a small test case that causes the problem? I just added
>> that construct to a test document and couldn't get it to fail (using
>> xsltproc or saxon).
>>
>> David
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
>> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>>
>
>
> --
> Cheers,
>
> Stefan Hinz <stefan.hinz@oracle.com>, MySQL Documentation Manager
>
> Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc
>
> ORACLE Deutschland B.V.& Co. KG
> Registered Office: Riesstr. 25, 80992 Muenchen, Germany
> Commercial Register: Local Court Of Munich, HRA 95603
> Managing Director: Jürgen Kunz
>
> General Partner: ORACLE Deutschland Verwaltung B.V.
> Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
> Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697
> Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher
>



>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org

Hi Bob,

Thanks for the quick advice, and sorry for a belated reply. I'll
investigate what's going on/wrong in our WebHelp customization, and will
let the list know what it is once I find out.

Cheers,

Stefan

On 26.02.2013 17:03, Bob Stayton wrote:
> Hi,
> Usually that error message comes when trying to process the given
> element in mode="title.markup" or mode="object.title.markup", which
> triggers using the gentext templates. In this case, an imagedata
> element is likely being processed in that mode (the imageobject error is
> an artifact of the stylesheet trying to fall back to the title of the
> failing element). So look for instances of that mode in the webhelp
> stylesheet that is not in the other stylesheets.
>
> The title.markup mode can also be used when resolving cross references.
> Does your document contain an xref to an imagedata element?
>
> Bob Stayton
> Sagehill Enterprises
> bobs@sagehill.net
>
> --------------------------------------------------
> From: "Stefan Hinz" <stefan.hinz@oracle.com>
> Sent: Tuesday, February 26, 2013 3:31 AM
> To: <docbook-apps@lists.oasis-open.org>
> Subject: Re: [docbook-apps] WebHelp bug?
>
>> Hi David,
>>
>> Thanks for looking into this! Test case attached.
>>
>> I should probably mention I'm using the 1.78.0 XSL style sheets, with a
>> mildly modified webhelp/template/ folder (just a couple of images
>> replaced with branded versions, such as logo and favicon).
>>
>> Here again is the error I'm getting when trying to build WebHelp:
>>
>> No template for "/book/chapter/mediaobject/imageobject/imagedata" (or
>> any of its leaves) exists in the context named "title" in the "en"
>> localization.
>> No template for "/book/chapter/mediaobject/imageobject" (or any of its
>> leaves) exists in the context named "title" in the "en" localization.
>> XPath error : Invalid type
>> xmlXPathCompiledEval: 1 objects left on the stack.
>>
>> Building the following formats works fine, though:
>>
>> - HTML (one file)
>> - HTML (chunked per chapter)
>> - HTML (chunked per section)*
>> - XHTML (one file)
>> - XHTML (chunked per chapter)
>> - XHTML (chunked per section)*
>> - EPUB
>> - FO
>> - PDF
>>
>> * Per-section chunking doesn't make sense for the little test case, but
>> it works flawlessly, anyway.
>>
>> Cheers,
>>
>> Stefan
>>
>> On 25.02.2013 17:02, David Cramer wrote:
>>> On 02/25/2013 05:14 AM, Stefan Hinz wrote:
>>>> Note that the construct that makes WebHelp fail is perfectly legal
>>>> according to the DocBook DTD. We don't get any errors when building
>>>> other formats (XHTML, FO, etc.). Since this is specific to WebHelp, I
>>>> wonder if we've simply hit a bug.
>>>>
>>>> Let me know, and I'll file a bug report on SF.net.
>>>
>>> It's very odd that this would affect only webhelp and not other outputs.
>>> Have you tried with just chunked html and htmlhelp? There's nothing in
>>> the webhelp directly related to those constructs.
>>>
>>> Could you post a small test case that causes the problem? I just added
>>> that construct to a test document and couldn't get it to fail (using
>>> xsltproc or saxon).
>>>
>>> David
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
>>> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>>>
>>
>>
>> --
>> Cheers,
>>
>> Stefan Hinz <stefan.hinz@oracle.com>, MySQL Documentation Manager
>>
>> Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc
>>
>> ORACLE Deutschland B.V.& Co. KG
>> Registered Office: Riesstr. 25, 80992 Muenchen, Germany
>> Commercial Register: Local Court Of Munich, HRA 95603
>> Managing Director: Jürgen Kunz
>>
>> General Partner: ORACLE Deutschland Verwaltung B.V.
>> Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
>> Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697
>> Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher
>>
>
>
>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
>> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>

--
Cheers,

Stefan Hinz <stefan.hinz@oracle.com>, MySQL Documentation Manager

Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc

ORACLE Deutschland B.V.& Co. KG
Registered Office: Riesstr. 25, 80992 Muenchen, Germany
Commercial Register: Local Court Of Munich, HRA 95603
Managing Director: Jürgen Kunz

General Partner: ORACLE Deutschland Verwaltung B.V.
Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697
Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher

Hi guys,

Ages ago (February actually) I reported a WebHelp bug:


Original Message --------
Subject: WebHelp bug?
Date: Mon, 25 Feb 2013 12:14:46 +0100
From: Stefan Hinz <stefan.hinz@oracle.com>
To: DocBook Apps <docbook-apps@lists.oasis-open.org>

Building one of our books in WebHelp format gives a fatal error:

No template for "/book/chapter/mediaobject/imageobject/imagedata" (or
any of its leaves) exists in the context named "title" in the "en"
localization.
XPath error : Invalid type xmlXPathCompiledEval: 1
objects left on the stack.

A took some investigation to boil down the issue to this:

A construct like this makes WebHelp builds fail:

<mediaobject>
<imageobject><imagedata .../>...</imageobject>
<textobject><programlisting>...</programlisting></textobject>
</mediaobject>

(...)

This turned out to be a fairly tricky problem, which we've eventually
created a workaround for in our customization layer, but I thought I'd
share what our implementer found (and fixed) on this forum. So here goes ...

We had problems with two templates:

(1) <xsl:template name="write.longdesc"> in xhtml/graphics.xsl
(used to write out long descriptions for accessibility, for images and
for tables)

(2) <xsl:template match="legalnotice" mode="titlepage.mode"> in
xhtml/titlepage.xsl
(used to write out legal notices into separate files if the
generate.legalnotice.link parameter is set to 1)

The default templates still work (just) but the resulting output has not
been changed/customized for webhelp and so the files look a little odd.
So these probably need to be looked at by the webhelp folks.

Also both of the above templates call the template user.head.content to
insert a