The more basic question is, should <olink> be used in this case at all?
The description of olink is: "The olink element is the equivalent for linking outside the current document." (from Bob Stayton's book)
I think this is an extremely vague way to describe it because "document" is ambiguous and the author uses that term consistently throughout his book. To me, an XML file is a *document* but apparently what the author intends to say is "book" or, more verbosely, "...outside the document after it has been transformed."
How about if the same book is chunked? Will I then have to replace my <xref>s with <olink>s?
On 7/5/2010 1:59 PM, Steve Johnson wrote:
Currently we are not "chunking" documentation but at some point I would like to be able to do that. To that end, because currently there are no cross-references at all, I want to implement cross-references so they will work whether or not the documents are "chunked" at transformation. I had no luck with <olink> because when I did the transform I always got a failure to resolve the olinks. To start with I wanted to olink between two chapters in a book. I added an xml:id to each <chapter> tag and, because all chapter files are in the same directory, used the following as the olink.db: <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE targetset SYSTEM "targetdatabase.dtd" [ <!ENTITY SDKOverview SYSTEM "SDKOverview.db"> ]> <targetset> <document targetdoc="SDKIntroduction" baseuri="CAStorSDKOverview.html"> </document> <document targetdoc="SDKEnumeration"> </document> </targetset> Question: Does the name of "baseuri" have to correspond to anything? Should it correspond to the name of the chapter (SDKIntroduction) or to the book (CAStorSDKOverview)? Link: <olink targetdoc="SDKEnumeration" targetptr="StartMethod"/> Transform command line: xsltproc --output c:\<filename> / --stringparam collect.xref.targets "yes" / --stringparam target.database.document "olinkdb.xml" / --stringparam current.docid "CAStorSDKOverview" / --xinclude C:\<our-custom-xsl> C:\<book-file> Result: Writing target.db for book(CAStorSDKOverview) Error: unresolved olink: targetdoc/targetptr = 'SDKEnumeration/StartMethod'.
-- ------------ Steve Johnson, Senior Content Developer Caringo [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
