[docbook-apps] olinking and sitemap

["Andreas Lalloo" <andreas dot lalloo at appmind dot com>]

Hello list!

I am fighting to get cross-document references to work for .pdf output. I've been reading Bob Stayton's excellent book but still have some questions.

 

1) When reading chapter 23 I get the impression the sitemap element is necessary only if the (html) output is in different directories, to get relative links correct (last paragraph of section "Setting up PDF olinking" hints about that). But if all my .pdf files are in the same directory, do I still need to specify a sitemap? If not, what shall I use to refer to the document in the very olink (targetdoc)? In the html example there's an association in the document element targetdoc/baseuri - does that mean I need a sitemap structure after all? Or is it just the directory specification of the sitemap I can omit?

 

2) If all output pdfs are in the same directory, do I still need to specify current.docid?

 

3) Currently my biggest problem is that I get the error
Olink error: cannot locate targetdoc a-devguide in sitemap
although the master database file has an entry like
<sitemap>
  <document targetdoc="a-devguide" baseuri="file://a-devguide.pdf"> &a-devguide_targets;</document>

when processing 

<olink targetdoc="a-devguide" targetptr="chref_devg_mmf" />
  
If I remove all of the <sitemap> element, I get another error (Error: unresolved olink: targetdoc/targetptr = 'a-devguide/chref_devg_mmf'.) so obviously the sitemap is seen by processing step.
 
I use DTD V4.3 and xsl 1.67.2, xsltproc and XEP by the way.

 

Thanks in advance
  Andreas