OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [docbook-apps] Olink sitemap for chunked HTML?


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>
      <dir name="documentation">
         <document targetdoc="ERDSupportingInfo"

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

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

Peter

On Thu, Mar 22, 2012 at 2:07 PM, Mark Craig <mark.craig@gmail.com> wrote:
> 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
>


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]