[docbook-apps] Olink error: cannot locate targetdoc in sitemap

["Joel Weeks" <joelw at cadence dot com>]

Hi,

I'm attempting to follow Bob's excellent description of modular files and olinking. Seems like I'm close to getting this to work, but I get an error during the final processing of the HTML.

Maybe the error text rings a bell about the possible cause, if not here are a few details.

XML dir structure is:

iccraft_xi
  |
  |
  |------cmd_gs  various XML files
  |
  |------journey various XML files


Output HTML dir structure:
 
some other place

iccraft_xi
  |
  |
  |------cmd_gs  various HTML files
  |
  |------journey various HTML files


I'm using <section> for the top-level elements in these files, and so set the section id and use this as the targetdoc value.

Part of onlinkdb.xml:

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE targetset SYSTEM "../../docbook-xsl-1.62.4/common/targetdatabase.dtd">
<targetset>
	<targetsetinfo> 
    Virtuoso Router Infinity prototype olink database.
  </targetsetinfo>
	<!-- Site map for generating relative paths between documents -->
	<sitemap>
		<dir name="iccraft_xi">
			<dir name="cmd_gs">
				<document targetdoc="split_bundle" baseuri="split_bundle.html">
					<xi:include href="cmd_gs/split_bundle.db" xmlns:xi="http://www.w3.org/2001/XInclude"/>
				</document>
					</dir>
	</sitemap>
</targetset>

cmd_gs/split_bundle.xml:

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE section SYSTEM "../../../docbook-xml-4.2/docbookx.dtd ">
<section id="split_bundle" lang="en">
	<title id="title">split_bundle</title>
	<para>When <command>on</command>, can split a defined bundle whose nets cannot all be globally routed with the same topology into two or more bundles with (possibly) some residual individual nets.</para>
	<para>The default is <command>off.</command>
	</para>
</section>


Part of onlinkdb.xml after xinclude resolutions via Xincluder:

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE targetset SYSTEM "../../docbook-xsl-1.62.4/common/targetdatabase.dtd">
<targetset>
	<targetsetinfo> 
    Virtuoso Router Infinity prototype olink database.
  </targetsetinfo>
	
	<sitemap>
		<dir name='iccraft_xi'>
			<dir name='cmd_gs'>
				<document targetdoc='split_bundle' baseuri='split_bundle.html'>
					<div element='chapter' href='#split_bundle' number='1' targetptr='split_bundle' lang='en' xml:base='file:/c:/cdn/cvs/infinity/home/docbook/help_xml/iccraft/cmd_gs/split_bundle.db'><ttl>split_bundle </ttl><xreftext>Chapter?1, <i>split_bundle </i></xreftext><obj element='title' href='#title' number='' targetptr='title'><ttl>split_bundle </ttl><xreftext>Chapter?1, <i>split_bundle </i></xreftext></obj></div>
				</document>
				<document targetdoc='auto_bundle_generation' baseuri='auto_bundle_generation.html'>
					<div element='section' href='#auto_bundle_generation' number='' targetptr='auto_bundle_generation' lang='en' xml:base='file:/c:/cdn/cvs/infinity/home/docbook/help_xml/iccraft/cmd_gs/auto_bundle_generation.db'><ttl>auto_bundle_generation</ttl><xreftext>the section called "auto_bundle_generation"</xreftext></div>
				</document>
				<document targetdoc='groute_cmd' baseuri='groute_cmd.html'>
					<div element='section' href='#groute_cmd' number='' targetptr='groute_cmd' lang='en ' xml:base='file:/c:/cdn/cvs/infinity/home/docbook/help_xml/iccraft/cmd_gs/groute_cmd.db'><ttl>groute </ttl><xreftext>the section called "groute "</xreftext><div element='section' href='#N1000F' number=''><ttl>Options (olink)</ttl><xreftext>the section called "Options (olink)"</xreftext></div><div element='section' href='#N1002B' number=''><ttl>Options (Xinlcude)</ttl><xreftext>the section called "Options (Xinlcude)"</xreftext><div element='section' href='#passes_key_groute' number='' targetptr='passes_key_groute' lang='en'><ttl>passes</ttl><xreftext>the section called "passes"</xreftext></div><div element='section' href='#auto_bundle_generation' number='' targetptr='auto_bundle_generation' lang='en'><ttl>auto_bundle_generation</ttl><xreftext>the section called "auto_bundle_generation"</xreftext></div><div element='chapter' href='#split_bundle' number='1' targetptr='split_bundle' lang='en'><ttl>split_bundle </ttl><xreftext>Chapter?1, <i>split_bundle </i></xreftext><obj element='title' href='#title' number='' targetptr='title'><ttl>split_bundle </ttl><xreftext>Chapter?1, <i>split_bundle </i></xreftext></obj></div></div><div element='section' href='#N11F65' number=''><ttl>Overview</ttl><xreftext>the section called "Overview"</xreftext></div><div element='section' href='#N11F8E' number=''><ttl>Multiple groute commands</ttl><xreftext>the section called "Multiple groute commands"</xreftext></div><div element='section' href='#N11FA6' number=''><ttl>Spine routing</ttl><xreftext>the section called "Spine routing"</xreftext><div element='section' href='#N11FB2' number=''><ttl>Notes</ttl><xreftext>the section called "Notes"</xreftext></div><div element='section' href='#N11FE5' number=''><ttl>See also</ttl><xreftext>the section called "See also"</xreftext></div></div></div>
				</document>

Next is cmd_gs/groute_cmd.xml with the olinks (such as <olink targetdoc="split_bundle" targetptr="title">split_bundle</olink>)

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE section SYSTEM "../../../docbook-xml-4.2/docbookx.dtd " [
	<!ENTITY % xinclude SYSTEM "../../../docbook-xml-4.2/xinclude.mod">
	%xinclude;
	<!ENTITY % cctents SYSTEM "../../../docbook-xml-4.2/ent/cct.ent">
	%cctents;
]>
<section id="groute_cmd" lang="en ">
	<title>groute </title>
	<?dbhtml filename="groute_cmd.html"?>
	<para>The groute command initiates global routing passes.</para>
	<mediaobject>
		<imageobject>
			<imagedata format="GIF" fileref="../images/groute_shg.gif"/>
		</imageobject>
	</mediaobject>
	<section>
		<title>Options (olink)</title>
		<itemizedlist>
			<listitem>
				<para>
					<olink targetdoc="passes_key_groute" targetptr="passes_key_groute">passes</olink>
				</para>
			</listitem>
			<listitem>
				<para>
					<olink targetdoc="split_bundle" targetptr="title">split_bundle</olink>
				</para>
			</listitem>
			<listitem>
				<para>
					<olink targetdoc="auto_bundle_generation" targetptr="auto_bundle_generation">auto_bundle_generation</olink>
				</para>
			</listitem>
		</itemizedlist>
	</section>


And when processing cmd_gs/groute_cmd.xml this command:

java -Djava.endorsed.dirs="C:\xerces-2_6_0;C:\xalan-j_2_5_2\bin" -Dorg.apache.xerces.xni.parser.XMLParserConfiguration=org.apache.xerces.parsers.XIncludeParserConfiguration org.apache.xalan.xslt.Process -IN file:///c:/cdn/cvs/infinity/home/docbook/help_xml/iccraft_xi/cmd_gs/groute_cmd.xml -XSL file:///c:/cdn/cvs/infinity/home/docbook/docbook-xsl-1.62.4/html/docbook.xsl  -OUT c:/cdn/cvs/infinity/home/docbook/html_out/iccraft_xi/cmd_gs/groute_cmd.html -param html.stylesheet "../ic-craft.css" -param target.database.document "../olinkdb.xml" -param current.docid parameter "groute_cmd" -V -HTML -DIAG

I get an error for each olink, such as:

Olink error : cannot locate targetdoc split_bundle in sitemap.

It creates links in the HTML, but using the current directory. So, when processing files in the cmd_gs directory, the links work only for files in that directory, but not for other directories, such as journey.

Thanks for any hints on what is amiss.


Joel Weeks
joelw@cadence.com
650.359.4088

To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.