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] olinks for epub?

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:


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.


Bob Stayton
Sagehill Enterprises

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?

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

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