search

kobolabs / epub-spec

Details on the elements of the ePub spec that Kobo supports, as well as other information on the Kobo reading platforms.
Other
191 stars 20 forks source link

endnotes/footnotes issue #45

Closed spajak closed 5 years ago

spajak commented 5 years ago

On my Clara HD reader (latest soft), links to notes don't work:

I have a reference:

<a epub:type="noteref" href="przypisy.xhtml#endnote-8-1" class="noteref">*1</a>

And a note in przypisy.xhtml:

<aside epub:type="endnote" id="endnote-8-1">*1. Francisco López de Gómara, Cortés: The Life of the Conqueror by His Secretary, przeł. i oprac. Lesley Byrd Simpson, Berkeley-Los Angeles 1964, s. 8.</aside>

Issue: Touching/clicking anchor link does nothing on my ereader.

wareid commented 5 years ago

Hi @spajak!

Please check the section here on footnotes and endnotes: https://github.com/kobolabs/epub-spec#footnotesendnotes-are-fully-supported-across-kobo-platforms

I don't believe we're supporting epub:type="noteref" but I can run a test to double check that. If you change noteref to footnote or endnote it should work.

spajak commented 5 years ago

I see. I was thinking noteref is an anchor and foot(end)note is the content of a note.. According to 3.2 spec:

noteref - a reference to a note, typically appearing as a superscripted number or symbol in the main body of text.

And only <span> is allowed, and not <a>?

wareid commented 5 years ago

No the element itself should not matter, that was just for the purposes of illustrating the example.

wareid commented 5 years ago

Can you retest the file on the device by changing the extension to [file].kepub.epub?

https://github.com/kobolabs/epub-spec#sideloading-for-testing-purposes

spajak commented 5 years ago

Yeap. foot(end)notes are working now. But other thinks are broken.. See #46

rriemann commented 4 years ago

Can you please clarify: noterefis generally not supported, but works on iOS devices (https://github.com/kobolabs/epub-spec/issues/8)?

The problem is that pandoc generates all epub3 files with noteref references in the next.

wareid commented 4 years ago

@rriemann For all endnotes/footnotes? If you could provide an example we can test it, but otherwise the recommendation in the document still stands.

I would also advise even if something is supported on one platform, it's best to have a solution that's cross-platform.

rriemann commented 4 years ago

OK for testing.

So I translated with pandoc the following text:

---
title: Test Title
author: Test Author
date: 22 June 2020
---

Here is some text. [^1] Here is again much more text with some extra footnote. [^2]

[^1]: Footnote 1
[^2]: Footnote 2

epub3: test-epub3.zip epub2: test-epub2.zip

pandoc 2.9.2.1 Compiled with pandoc-types 1.20, texmath 0.12.0.1, skylighting 0.8.3.2