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

["Bob Stayton" <bobs at sagehill dot net>]

Hi,
If this part of your command is not a typo, then that is the source of the
problem:

-param current.docid parameter "groute_cmd"

I think that should be:

-param current.docid "groute_cmd"

I think the stylesheet needs a check to make sure the
current.docid actually exists in the sitemap, so that
it gives a more clear error message.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


----- Original Message ----- 
From: "Joel Weeks" <joelw@cadence.com>
To: <docbook-apps@lists.oasis-open.org>
Sent: Monday, January 12, 2004 10:47 AM
Subject: [docbook-apps] Olink error: cannot locate targetdoc in sitemap


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/spl
it_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/aut
o_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/gro
ute_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.apach
e.xerces.xni.parser.XMLParserConfiguration=org.apache.xerces.parsers.XInclud
eParserConfiguration 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/.



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