Re: [docbook-apps] olinks for epub?

["Bob Stayton" <bobs@sagehill.net>]

Hi Tim,
In the current epub3 stylesheets, olinks will form but they won't work 
because the syntax of the href is wrong for epub.  I was waiting to see how 
the Epub standard evolved before trying to change anything.

There is now an ePub standard for such linking called "EPUB Canonical 
Fragment Identifier (epubcfi) Specification" which was finalized in October 
2011:

http://idpf.org/epub/linking/cfi/epub-cfi.html

This standard has not yet been implemented in DocBook XSL, and I don't know 
what the state of support is in Epub readers for it.  I have not had a 
chance to try it out in readers.

For now, it would be best to turn off the hot links while retaining the 
olink text.  To do that, it is not necessary to modify your olink database 
files.  Instead, just define this template as empty:

 <xsl:template name="make.olink.href"/>

The template named "olink.hottext" will still operate to generate the text 
from the olink database, but it will be rendered without a link element in 
the output.  To avoid confusion for your readers, you probably want to turn 
on the stylesheet param 'olink.doctitle' to append the other document's 
title.

http://www.sagehill.net/docbookxsl/OlinkGentext.html#AddDocTitle

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

--------------------------------------------------
From: "Tim Arnold" <jtim.arnold@gmail.com>
Sent: Wednesday, October 03, 2012 8:18 AM
To: "DocBook Apps" <docbook-apps@lists.oasis-open.org>
Subject: [docbook-apps] olinks for epub?

> hi,
> I have a set of books that I normally render as html using the 1.77
> docbook stylesheets; I use an olink database to handle cross
> references. That works great.
>
> Now I need to render the individual books as epub3 and I'm not sure
> how to handle these cross-book references. I would like them to
> resolve to their textual representation (e.g., "Chapter 13: My Chapter
> (User's Guide)") but not have it them rendered as hot links since the
> links cannot work in an epub doc.
>
> Has anyone encountered this situation? Maybe I could create a copy of
> my olinkdb.xml file and remove the href attributes?
>
> thanks for any ideas,
> --Tim Arnold
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org