[Epub V2] Footnote in-page also

Request new features or suggest modifications to existing features of Atlantis.
Post Reply
ElMaco
Posts: 3
Joined: Thu May 21, 2026 7:15 am

[Epub V2] Footnote in-page also

Post by ElMaco »

Image
Hello,
Thank you for confirming the upcoming EPUB3 support for epub:type="noteref" and epub:type="footnote" — that works perfectly.
I would also like to request a similar improvement for EPUB2 output, to ensure compatibility with KOReader's in-page footnote feature.
KOReader displays footnotes inline at the bottom of the page through two mechanisms:
1. EPUB3 semantic attributes (already planned):
- epub:type="noteref" on the call anchor
- epub:type="footnote" on the note element
2. CSS class names (for EPUB2 and generic EPUB3):
KOReader recognizes a set of standard class names on the note element to trigger in-page display. The simplest and most widely supported are:
.footnote, .footnote1, .footnotes, .fn, .note, .note1, .fnote (
The note element just needs one of these classes. For example:
<p id="a3" class="footnote">...</p>

Currently, Atlantis generates EPUB2 with proprietary class names (e.g. "p11", "p5") that KOReader does not recognize, so footnotes are not displayed inline.
The request is therefore: when exporting to EPUB2, please assign the class "footnote" (or "fn") to the paragraph elements that contain footnote content in the notes file.
This is a small change but it would make Atlantis-generated EPUB2 files immediately compatible with KOReader and other readers that follow the same convention.
Thank you for considering this request.
User avatar
admin
Site Admin
Posts: 3013
Joined: Wed Jun 05, 2002 10:48 pm
Contact:

Re: [Epub V2] Footnote in-page also

Post by admin »

Atlantis uses generic CSS style names for non-heading paragraphs in EPUB based on their formatting, not the role they play in the document.

Atlantis will save footnotes/endnotes with the "epub:type" attributes to the EPUB 3.0 eBooks because these attributes are part of the EPUB 3 format specification.

Sorry, but I don't think that what you suggest regarding the CSS class names for notes is a good idea. There is no standard suggesting how to name CSS styles for notes in EPUB. Atlantis can't generate EPUBs according to vague instructions briefly mentioned within the Wiki articles of KOReader. Atlantis needs a universal scheme for class names that fits any possible scenario. For example, how to name note classes if you have dozens of differently formatted notes in the document (this is highly unlikely, but this is possible)? Or, what to do if a note contains multiple paragraphs (this is more likely)? There is no "aside" element in EPUB 2.0 to group multiple paragraphs into one object.

Note that the EPUB 3.0 eBooks generated by Atlantis are forward-compatible. In theory, you should be able to view them on eReaders supporting EPUB 2 only.
ElMaco
Posts: 3
Joined: Thu May 21, 2026 7:15 am

Re: [Epub V2] Footnote in-page also

Post by ElMaco »

Yes you're right no rules on V2.
Post Reply