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] Fw: olink not working


Hi,
The problem is the mismatch in targetdoc.

In the document:

<olink targetdoc="book" targetptr="synop"></olink>

In the olinkdb.xml file:

<document targetdoc="chapter1">

That should be:

<document targetdoc="book">

The id attribute on the book element is not automatically used as the 
targetdoc for a document.  That's because id values are not necessarily 
unique between documents, and targetdoc values must be unique between 
documents.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


----- Original Message ----- 
From: <Tom_Towle@bcbsil.com>
To: "Bob Stayton" <bobs@sagehill.net>
Cc: <docbook-apps@lists.oasis-open.org>
Sent: Wednesday, October 22, 2008 9:38 AM
Subject: Re: [docbook-apps] Fw: olink not working


> Actually I got it working in my sandbox but cannot in my main program for
> the love of me get it working. I will send those errors. but what is weird
> is that links work. I guess that is an undocumented feature?
>
>
>
>             Tom Towle/IL/HCSC
>
>             10/17/2008 03:43                                           To
>             PM                        Tom_Towle@bcbsil.com
>                                                                        cc
>
>                                                                   Subject
>                                       Re: [docbook-apps] Fw: olink not
>                                       working(Document link: Tom Towle)
>
>
>
>
>
>
>
>
>
> Here is my build file/ book file/ and olinkdb.xml file in that order. The
> odd thing is that the olinks don't work yet the links work fine which
> causes me some concern as I don't understand how  the link is working and
> not the olink which was what I stared out trying to accomplish when the
> link did not work between files. so at this point I am spooked. Let me add
> that I am basically using DITA for half our documentation needs and 
> Docbook
> for the other half just to try them both out. Linking between files in 
> Dita
> works fine so I am hoping Docbook will work out too. xincludes has been
> working fine for us. I got this example from an earlier post in this group
> and tried to duplicate it but no success
>
>
> build file
> -------------------
> <?xml version="1.0" encoding="UTF-8"?>
> <project name="docbook-src" default="generate-html-user-manual" 
> basedir="."
>>.
>      <path id="classpath">
>            <fileset dir="lib" includes="*.jar" />.
>      </path>
>
>      <target name="init">
>            <copy todir="sandbox/images">
>                  <fileset dir="images">
>                        <include name="*.gif" />.
>                        <include name="*.bmp" />.
>                        <include name="*.jpg" />.
>                        <include name="*.png" />.
>                        <include name="*.swf" />.
>                  </fileset>
>            </copy>
>      </target>>
>
>                  <target name="Olink HTML" depends="init">
>                  <echo message="Generating olinktest" />
>                  <java classname="org.apache.xalan.xslt.Process" fork=
> "true" failonerror="true">
>                        <sysproperty key=
> "org.apache.xerces.xni.parser.XMLParserConfiguration" value=
> "org.apache.xerces.parsers.XIncludeParserConfiguration" />
>                        <arg. line="-in sandbox/book.xml" />
>                        <arg line="-xsl
> docs/docbook-xsl-1.73.2/html/docbook.xsl" />
>                        <arg line="-out sandbox/sand_output/book.html" />
>                      <arg line="-param collect.xref.targets yes" />
>                      <arg line="-param target.database.document
> 'olinkdb.xml' "/>
>                              </java>
>            </target>
>
>
> container file for xincludes
> -------------------------------------
> <?xml version="1.0" encoding="UTF-8"?>
> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
> "..\docbook\docbookx.dtd">
> <book id="book">
>  <title>Command Reference</title>
>  <reference>
>    <title>Commands</title>
>    <xi:include href="command1.xml"
>     xmlns:xi="http://www.w3.org/2001/XInclude"; />:
>    <xi:include href="command2.xml"
>     xmlns:xi="http://www.w3.org/2001/XInclude"; />:
>      </reference>
>  </book>
>
> other files with olink
> -----------------------------
> <?xml version="1.0" encoding="UTF-8"?>
> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
> "..\docbook\docbookx.dtd">
> <chapter id="chapter1">
>  <refentry id="cmd1">>
>  <refnamediv>
>     <refname>cmd1</refname>
>     <refpurpose>starts the client</refpurpose>
>  </refnamediv>
>  <refsection>>
>    <title>cmd2 ref section</title>
>    <para>Test olink from tom towle: refer to the <olink targetdoc="book"
>    targetptr="synop"></olink> section of the command 2 page.</para>
>  </refsection>
> </refentry>
> </chapter>>
>
>
> ---------
> <?xml version="1.0" encoding="UTF-8"?>
> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
> "..\docbook\docbookx.dtd">
> <chapter id="chapter2">
>  <refentry id="cmd2">>
>  <refnamediv>
>    <refname>cmd2</refname>
>    <refpurpose>determines compiler and linker flags</refpurpose>
>  </refnamediv>>
>  <refsection id="synop">
>    <title>SYNOPSIS</title>
>    <cmdsynopsis>
>      <command>sb-config</command>
>      <arg rep="norepeat"><replaceable>option</replaceable></arg>
>    </cmdsynopsis>
>  </refsection>
> </refentry>
> </chapter>>
>
> olinkdb.xml>
> ------------------
> <?xml version="1.0" encoding="utf-8"?>
> <targetset>
>  <targetsetinfo>info </targetsetinfo>
>  <sitemap>
>    <dir name="sandbox/sand_output">
>      <document targetdoc="chapter1">>
>        <xi:include href="target.db">>
>             xmlns:xi="http://www.w3.org/2003/XInclude"/>
>      </document>
>    </dir>
>  </sitemap>
> </targetset>
>
> Here is the error message.
> _____excerpt____________________
> Buildfile: C:\Data\rad7\workspace\XMLdocs\EASFrameworkDocs\sandbox
> \buildhtml_test.xml
> init:
> Olink HTML:
>     [echo] Generating olinktest
>     [java]
> file:///C:/Data/rad7/workspace/XMLdocs/EASFrameworkDocs/docs/docbook-xsl-1.73.2/html/chunker.xsl
>
> ; Line #98; Column #18; Writing target.db for book(book)
>     [java]
> file:///C:/Data/rad7/workspace/XMLdocs/EASFrameworkDocs/docs/docbook-xsl-1.73.2/html/xref.xsl
>
> ; Line #1070; Column #22; Error: unresolved olink: targetdoc/targetptr =
> 'book/synop'.
> BUILD SUCCESSFUL
> Total time: 5 seconds
>
>
>
>
>
>
>
>
>
>
>
> **********
>
> The information contained in this communication is confidential, private, 
> proprietary, or otherwise privileged and is intended only for the use of 
> the addressee.  Unauthorized use, disclosure, distribution or copying is 
> strictly prohibited and may be unlawful.  If you have received this 
> communication in error, please notify the sender immediately at 
> (312)653-6000 in Illinois; (800)835-8699 in New Mexico; (918)560-3500 in 
> Oklahoma; or (972)766-6900 in Texas.
>
> **********
>
>
> 



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]