Re: [docbook-apps] Re: docbook-slides: footnote in title ?

["Bob Stayton" <bobs@sagehill.net>]

This error comes from a bug in the old slides stylesheet that fails to 
process the title in the correct mode for the headers and footers.  In fo, 
the title in its original location in the content can support links and 
footnotes.  But copies of that title in the TOC cannot support links because 
the title in the TOC is already a link into the body of the document, and 
you cannot nest links.  Similarly, footnote in a static-content area like 
header/footer is not supported in FO output.  For these reasons, when a 
title is processed anywhere but for its original location, it should be 
processed in mode="title.markup" without setting the template param 
allow-anchors=1, and that is what the FO stylesheets do. That will skip 
footnotes among other things.

The slides stylesheet processes the title for the header/footer in 
mode="titlepage.mode", which is the mode used for the original location of 
the title, and that mode uses allow-anchors=1, so it tries to include the 
footnote.  In slides/plain.xsl, in the template named "running.head.mode", 
it uses mode="itlepage.mode".  That should be changed to mode="title.markup" 
instead so that footnotes and links are ignored in the title.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

--------------------------------------------------
From: "Mathieu Malaterre" <mathieu.malaterre@gmail.com>
Sent: Monday, September 10, 2012 12:59 AM
To: "DocBook Apps" <docbook-apps@lists.oasis-open.org>
Subject: [docbook-apps] Re: docbook-slides: footnote in title ?

> Apparently this is something that was unexpected by fop:
>
> https://issues.apache.org/bugzilla/show_bug.cgi?id=53817#c3
>
> ...
> The NPE is thrown when foot-note is declared within the static-before 
> region.
> If I move the foot-note to the body, the NPE disappears.
>
> Note that FOP behaves in the same way whatever the version is (tried
> against v0.95, v1.0, latest trunk).
>
> That said, IMHO I don't think that a static region is the right place
> for a footnote declaration, so author should avoid to use that at this
> place, as a good practice/workaround.
> ...
>
> HTH
>
> On Sun, Sep 2, 2012 at 5:39 PM, Mathieu Malaterre
> <mathieu.malaterre@gmail.com> wrote:
> > Hi there,
> >
> >   Does anyone knows whether the following is valid:
> >
> > <?xml version="1.0" encoding="UTF-8"?>
> > <!DOCTYPE slides PUBLIC "-//Norman Walsh//DTD Slides XML V3.4.0//EN"
> > "http://docbook.sourceforge.net/release/slides/3.4.0/schema/dtd/slides-full.dtd";>
> > <slides>
> >   <foil>
> >   <title>My Title<footnote><para><ulink
> > url="http://www.example.com/"/></para></footnote></title>
> >   <para/>
> >   </foil>
> > </slides>
> >
> > it makes fop crash with a java.lang.NullPointerException exception.
> >
> > as a side note, the following is working nicely:
> >
> > <?xml version='1.0' encoding='UTF-8'?>
> > <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
> > "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd";>
> > <article>
> > <section>
> >   <title>My Title<footnote><para><ulink
> > url="http://www.example.com/"/></para></footnote></title>
> >   <para/>
> > </section>
> > </article>
> >
> > See also:
> > https://issues.apache.org/bugzilla/show_bug.cgi?id=53817
> >
> > Thanks for comments,
> > --
> > Mathieu
>
>
>
> --
> Mathieu
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org