[oXygen-user] Following links through xinclude in docbook

[Lee, David]

Hi ! I'm new to Oxygen and am trying it out to see how it works with Docbook editing.
First impression, very nice !

I have a docbook which is a master docbook with lots of xincludes like this :

   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="HomePage.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CommandXpwd.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CommandXpath.xml"/>


Then in each child xml file is a chapter like this 

<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
         xmlns:xi="http://www.w3.org/2001/XInclude"
         version="5.0"
         xml:id="HomePage">


Then in those pages can have links like this 

  	<para>
         <xref linkend="QuickStart"/>
      </para>
      <para>
         <link linkend="BasicSyntax"> Basic Syntax</link>
      </para>

And the associated XML pages also have xml:id that matches these.

First off, Im VERY impressed that opening the master document with the xincludes works in Oxygen and in Author mode I can see all the child documents .  Nice !!

But now for the fun.  When I click on the link symbol in a link in the child document, it doesnt jump to the target page.  Rather it just jumps to the top of the current page.

But ...
If I run xinclude externally to Oxygen then open up the combined document, then the jump to link feature works great, I click on the link icon and it jumps to the chapter correctly.


So my question is, is this a known limitation ?  Maybe I am doing something wrong ?
Should I be able to use the link navigation in Author mode across files which are xinclude'd from the master document ?

Thank you !


----------------------------------------
David A. Lee
Senior Principal Software Engineer
Epocrates, Inc.

812-482-5224