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 Bob,
That is interesting reading. It looks like the situation will
eventually get solved.
I only have the calibre ereader on my desktop, and plain href links
work even with anchors.

One wrinkle in my own processing is that I use olinks throughout these
books with prefer.internal.olink set to 1.

So if I override the make.olink.href template I lose all links
(including the internal ones) in the epub.

 Given the state of epub links maybe that is the correct thing to do,
but once ereaders standardize on the CFI structure, I'm guessing I'll
still have a problem to differentiate between local and
cross-reference links.


On Wed, Oct 3, 2012 at 12:25 PM, Bob Stayton <bobs@sagehill.net> wrote:
> 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

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