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?


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>
  <dir name='html'>
   <dir name='another-doc'>
    <dir name='index'>
     <document targetdoc='another-doc'>
      &another-doc;
     </document>
    </dir>
   </dir>
   <dir name='bogus-guide'>
    <dir name='index'>
     <document targetdoc='bogus-guide'>
      &bogus-guide;
     </document>
    </dir>
   </dir>
  </dir>
 </sitemap>

After (and fixed):

 <sitemap>
  <dir name='html'>
   <dir name='another-doc'>
    <dir name='index'>
     <document targetdoc='another-doc'
               baseuri='../../another-doc/index/'>
      &another-doc;
     </document>
    </dir>
   </dir>
   <dir name='bogus-guide'>
    <dir name='index'>
     <document targetdoc='bogus-guide'
               baseuri='../../bogus-guide/index/'>
      &bogus-guide;
     </document>
    </dir>
   </dir>
  </dir>
 </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>
>      <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]