docbook-apps

Hello,

I'm stumped getting the sitemap right to resolve Olinks in chunked HTML. The Olinks between different files of the same document seem to come out fine. But Olinks between documents are broken.

Bob Stayton's book, DocBook XSL: The Complete Guide, has solved lots of the DocBook XSL problems between my keyboard and chair. So I'm probably misreading the chapter on Olinks or missing something in the section about sitemaps, http://www.sagehill.net/docbookxsl/OlinkDetails.html#UsingSitemap

Would one of you have a working, open source example of Olinks between docs in chunked HTML that I could read through to perhaps understand?

If not, an example that demonstrates the problem is at https://github.com/markcraig/olink-test (with the problem showing up for example in target/docbkx/html/bogus-guide/index/ch01.html#olink-checks after you `mvn pre-site`; first link in the section works and it's inside the document; second link in the section fails to make it to the other document).

Thanks for your time and your advice.

Regards,
Mark

Here's an example of a map that I am using for chunked HTML.

It can be a little tricky to figure out what the relative path to
other documents is. It all depends on how you are packaging the HTML
files. Mine are grouped in directories for the product, then the
document, and then a directory named "html." So my links from one
document to another have to go up three directories in the hierarchy
and then back down the path to the directory that holds the chunked
files for each specific document.

<targetset>
<sitemap>

<document targetdoc="ERDSupportingInfo"

baseuri="../../../platform/documentfoo/html/">&documentfooTargetswebhelp;</document>
<document targetdoc="ERDSupportingInfo"

baseuri="../../../otherproduct/bardocument/html/">&bardocumentTargetswebhelp;</document>

</sitemap>
</targetset>

Peter

On Thu, Mar 22, 2012 at 2:07 PM, Mark Craig

Aha! Thanks very much, Peter.

I got confused, thinking I only needed the baseuri attribute for
single-page HTML output.

That fixes it the problem completely.

Before (and broken):

<sitemap>



<document targetdoc='another-doc'>
&another-doc;
</document>




<document targetdoc='bogus-guide'>
&bogus-guide;
</document>



</sitemap>

After (and fixed):

<sitemap>



<document targetdoc='another-doc'
baseuri='../../another-doc/index/'>
&another-doc;
</document>




<document targetdoc='bogus-guide'
baseuri='../../bogus-guide/index/'>
&bogus-guide;
</document>



</sitemap>

Thanks again.

Regards,
Mark

On Thu, Mar 22, 2012 at 7:35 PM, Peter Desjardins
<peter.desjardins.us@gmail.com> wrote:
> Here's an example of a map that I am using for chunked HTML.
>
> It can be a little tricky to figure out what the relative path to
> other documents is. It all depends on how you are packaging the HTML
> files. Mine are grouped in directories for the product, then the
> document, and then a directory named "html." So my links from one
> document to another have to go up three directories in the hierarchy
> and then back down the path to the directory that holds the chunked
> files for each specific document.
>
> <targetset>
>   <sitemap>
>      
>         <document targetdoc="ERDSupportingInfo"
>
> baseuri="../../../platform/documentfoo/html/">&documentfooTargetswebhelp;</document>
>         <document targetdoc="ERDSupportingInfo"
>
> baseuri="../../../otherproduct/bardocument/html/">&bardocumentTargetswebhelp;</document>
>      
>   </sitemap>
> </targetset>
>
> Peter
>
> On Thu, Mar 22, 2012 at 2:07 PM, Mark Craig