Popup Footnotes/Endnotes on Kobo

[jeff47]

I apologize... I feel like this has been asked a million times, and the answer is out there. But I am baffled why this isn't working.

I have a test epub. The popup endnotes and footnotes work as expected in the macOS Books desktop app. From reading the Kobo Lab documentation, I think I've added the correct tags.

However, after I convert to kepub (either with Calibre or using the CLI kepubify version 4.0.4), instead of popups I either get full jumps or non-functional links on my Kobo Libra H2O.

Can someone please help? I've tried every permutation I can think of and the various tips on the web I've seen to no avail. With spans, without spans... etc. I have an epub where the endnotes do work after converting to kepub -- so I don't think it is a device thing. But even after looking at the code from that book in Sigil, I still can't figure out why it works in that book and not in mine.

I would deeply appreciate your help. (And so, hopefully, will the readers of the book I'm converting!)

I've attached the whole epub, but in case it is easier, here are the code snippets:
Here's an example place I want an endnote:

...
<p class="body">Lorem ipsum dolor sit amet, consectetur adipiscing elit, 
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Vel risus 
commodo viv maecenas accumsan. Odio pellentesque diam volutpat suc poc
como sed egestas egestas. Lorem ipsum dolor sit amet consectetur. Leo vitae 
turpis massa.<a href="endnotes.xhtml#massa" epub:type="noteref">[1]</a>
...

And in endnotes.xhtml:

...
<p id="massa" epub:type="endnote"><span class="endnote">[1] Lorem 
ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor 
incididunt ut labore et dolore magna aliqua. Vel risus commodo viverra 
maecenas accumsan. Odio pellentesque diam volutpat commodo sed egestas 
egestas.</span></p>
...

[Aleron Ives]

This is what a functional footnote looks like in one of my books. The footnotes are part of the chapter itself and not a separate file. Tapping on the asterisk in the body text will open the footnote pop-up window, and tapping on the asterisk next to the footnote will jump to the page that references the footnote.

<a class="hlink" href="#c03-ftn3" id="c03-ftn3a"><sup class="frac">*</sup></a>

<p class="footnote" id="c03-ftn3"><a class="hlink" href="#c03-ftn3a">*</a>Shiny footnote text</p>

[jeff47]

Originally Posted by Aleron Ives

This is what a functional footnote looks like in one of my books. The footnotes are part of the chapter itself and not a separate file. Tapping on the asterisk in the body text will open the footnote pop-up window, and tapping on the asterisk next to the footnote will jump to the page that references the footnote.

Sorry, misread your post in my first reply. I'll try this -- you have it working on a Kobo?

As an aside - don't ids have to be unique?

[DNSB]

His IDs are unique. However, if you are going outside the current file, you have to include the filename. Looking at your sample, I added back1a and back3a for the back links.

<a href="endnotes.xhtml#massa" epub:type="footnote" id="back1a">[1]</a>

<p><a id="massa" epub:type="endnote" href="Section0001.xhtml#back1a">[1]</a><span class="endnote"> Shiny footnote text here.</span></p>

You will need to add the epub:type and aside directives as needed.

[jeff47]

Originally Posted by DNSB

His IDs are unique. However, if you are going outside the current file, you have to include the filename. Looking at your sample, I added back1a and back3a for the back links.

<a href="endnotes.xhtml#massa" epub:type="footnote" id="back1a">[1]</a>

<p><a id="massa" epub:type="endnote" href="Section0001.xhtml#back1a">[1]</a><span class="endnote"> Shiny footnote text here.</span></p>

You will need to add the epub:type and aside directives as needed.

This did not produce popup footnotes or endnotes in my test using Books on MacOS, Kobo Desktop, or my Libra H2O.

Doesn't it need to be "noteref" in the epub:type, based on Apple's documentation? (https://help.apple.com/itc/booksasse...cf8ecf5c8.html)

In case it isn't clear, I've attached a screenshot of my Kobo on a book where this works. My problem is I don't understand why it works in the book I'm looking at, and not when I try it!

[Doitsu]

I experimented with pop-up footnotes some time ago and created an epub3 test file with footnotes formatted according to the Apple Books Asset Guide recommendations. On my iPad, they were displayed as pop-up footnotes. Try to kepubify it. If my footnotes aren't shown as pop-up footnotes either, you'll have to reverse-engineer a KEPUB book with working pop-up footnotes to find out the correct syntax.

[jeff47]

Originally Posted by Doitsu

I experimented with pop-up footnotes some time ago and created an epub3 test file with footnotes formatted according to the Apple Books Asset Guide recommendations. On my iPad, they were displayed as pop-up footnotes. Try to kepubify it. If my footnotes aren't shown as pop-up footnotes either, you'll have to reverse-engineer a KEPUB book with working pop-up footnotes to find out the correct syntax.

Well, I'm utterly baffled. Your example works in Calibre and on my Kobo after conversion to kepub. My example, attached here, doesn't. And I can't see the difference for the life of me.

I think I'll take this over to the kobo github and see if they have any clues.