docbook-apps

  • 1.  issue with olinks, sitemaps, and fo stylesheets ?

    Posted 05-29-2009 21:00
    Hello,

    recently I have started using sitemaps with my documentation. We are
    generating HTML and FO, so I set up two sitemaps: one that xincludes
    html xref files (produced via html stylesheets), and one xincluding fo
    xref files (produced via fo stylesheets).

    The HTML version of the process works very well, all my documents
    cross-link nicely.
    However, I get errors in the PDF (FO) generation process:

    Error: unresolved olink: targetdoc/targetptr =
    'UsersGuide/custom_expr_evaluation'.

    I'm not sure what is wrong here. The same xml sources work fine when
    generating HTML. Also, quickly browsing the generated fo target database
    shows a toplevel element with targetptr="UsersGuide", and a (nested)
    child with targetptr="custom_expr_evaluation".

    Any idea what may cause the above failure ? Or, how I may debug this ?

    I'm using docbook-xsl 1.73.2, FWIW.

    Thanks,
    Stefan

    --

    ...ich hab' noch einen Koffer in Berlin...




  • 2.  Re: [docbook-apps] issue with olinks, sitemaps, and fo stylesheets ?

    Posted 05-30-2009 18:48
    Stefan Seefeld wrote:
    >
    > Any idea what may cause the above failure ? Or, how I may debug this ?
    >
    > I'm using docbook-xsl 1.73.2, FWIW.
    I have debugged this a bit, and got a little closer to the cause of the
    failure:

    It turns out the target.database.file was opened fine. It contains a
    <sitemap>, where all individual target db documents are pulled in via
    xi:include. However, if I process with the fo stylesheets, those
    xi:includes aren't processed, thus no targetptr could be found.

    Any idea what may have caused this ? I'm using xsltproc --xinclude (and
    xinclude processing of the docbook sources works fine, only the target
    db files aren't read in.

    Has anybody seen similar failures in the past ? Am I doing something
    wrong ? Could it be an error in the stylesheets ? A bug in xsltproc ?

    Thanks for any help !

    Stefan

    --

    ...ich hab' noch einen Koffer in Berlin...




  • 3.  Re: [docbook-apps] issue with olinks, sitemaps, and fo stylesheets ?

    Posted 05-30-2009 23:59
    On Sat, 30 May 2009 20:48:29 +0200, Stefan Seefeld <seefeld@sympatico.ca>
    wrote:

    > Any idea what may have caused this ? I'm using xsltproc --xinclude (and
    > xinclude processing of the docbook sources works fine, only the target
    > db files aren't read in.

    Try to add the option --xincludestyle.

    Regards,
    BG



  • 4.  Re: [docbook-apps] issue with olinks, sitemaps, and fo stylesheets ?

    Posted 05-31-2009 12:38
    ben.guillon wrote:
    > On Sat, 30 May 2009 20:48:29 +0200, Stefan Seefeld
    > <seefeld@sympatico.ca> wrote:
    >
    >> Any idea what may have caused this ? I'm using xsltproc --xinclude
    >> (and xinclude processing of the docbook sources works fine, only the
    >> target db files aren't read in.
    >
    > Try to add the option --xincludestyle.

    Thanks, that seems to have worked. I'm still confused, though. Why did
    it work with the HTML stylesheets without that option, but not with the
    FO stylesheets ? It seems the behavior is influenced by something in the
    stylesheets, as my processing from XML to HTML is very similar to XML to FO.

    (I had gone back and replaced the xincludes by system entities to work
    around the bug, but I do prefer using xincludes.)

    Thanks,
    Stefan

    --

    ...ich hab' noch einen Koffer in Berlin...