MobileRead Forums - View Single Post

enuddleyarbl · 10-05-2022, 10:31 AM

I am not an expert in this. I just dabble. But, the first thing is that I'm pretty sure the epub:type attribute is only for epub3. So, in that book, go to the content.opf file and check that it says version="3.0" up at the top. If not, don't use epub:type attributes (or convert it with Tools > Upgrade Book Internals -- but that will limit where you can use the book to readers supporting epub3).

Next, if you use epub:type attributes, you'll need to add the "http://www.idpf.org/2007/ops" namespace to the files where they are used. So, if you use epub:type in a file, the html line near the top will have to look something like:

Code:

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" lang="en-US" xml:lang="en-US">

The book I'm pulling that from uses US English and the one you're looking at uses GB English, so don't worry about that.

As to where the epub:type attributes go, there should be a "noteref" in the <a> element where you refer to the footnote and a "footnote" or "endnote" in the block where the actual footnote is. So, working with what you posted, I'd say the source of the footnote should start with:

Code:

<a id="ich03fn1" class="calibre7"></a><a class="calibre7" href="part0078.html#ch03fn1" epub:type="noteref">...

and, if I'm seeing this right, the very last line of your code chunk is the actual footnote, so it should start:

Code:

<p class="footnote" epub:type="footnote">...

I'll throw in some references here so you can look them up:

Footnote is at: https://www.w3.org/TR/epub-ssv/#footnote
Noteref is at the bottom of this section: https://www.w3.org/TR/epub-ssv/#links

I've never used the endnote tag, so even if I've got an endnote "chapter" at the end of the book, I still use the footnote tag in each footnote.

As to the structure of the footnotes I see in what you posted, I'm not very happy with that. But, outside of esthetics, I don't think it'll make much difference and I doubt you'll want to re-do the footnotes. But, for reference, up where the footnote is called (in the text of the document), my footnote call looks like:

Code:

<a id="fn1" href="#fn1a" epub:type="noteref"><sup>n</sup></a>...</p>

So, it consists of the <a> tag where it's given an id to come back to, the href where the actual footnote is and the noteref attribute, then the simple, superscripted note number and then the close of the <a> tag.

I use <aside> tags to block off the actual footnote text, but I'm pretty sure any other type of block (<p>, <div>) will do. In my case, they look like:

Code:

<aside id="fn1a" class="footnote" epub:type="footnote">
<p><a href="#fn1"><sup>n</sup></a>.thenote.</p>
</aside>

So, it starts with the <aside> (or whatever) tag where the footnote is given its id, a styling class and the footnote attribute.
Then an <a> tag with the return address of the calling source which is applied to a superscripted note number (and its closing </a>). Then, the actual note. And, finally, the closing <aside> (or whatever) tag.

A couple of totally extraneous comments. First, the id attached to the <body> in what you posted starts with a digit. I'm pretty sure they can't start with a digit and Calibre will complain about that. Run, Tools > Check Book to confirm that. I'm pretty sure the Calibre editor will find and fix that. Second, I'm not sure how the forum mods will react to those screenshots of the actual book text. I'd think that one tiny bit of text would fall under fair use. But, they might complain.

10-05-2022, 10:31 AM	#5
enuddleyarbl Guru Posts: 781 Karma: 1538394 Join Date: Sep 2013 Device: Kobo Sage	I am not an expert in this. I just dabble. But, the first thing is that I'm pretty sure the epub:type attribute is only for epub3. So, in that book, go to the content.opf file and check that it says version="3.0" up at the top. If not, don't use epub:type attributes (or convert it with Tools > Upgrade Book Internals -- but that will limit where you can use the book to readers supporting epub3). Next, if you use epub:type attributes, you'll need to add the "http://www.idpf.org/2007/ops" namespace to the files where they are used. So, if you use epub:type in a file, the html line near the top will have to look something like: Code: <html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" lang="en-US" xml:lang="en-US"> The book I'm pulling that from uses US English and the one you're looking at uses GB English, so don't worry about that. As to where the epub:type attributes go, there should be a "noteref" in the <a> element where you refer to the footnote and a "footnote" or "endnote" in the block where the actual footnote is. So, working with what you posted, I'd say the source of the footnote should start with: Code: <a id="ich03fn1" class="calibre7"></a><a class="calibre7" href="part0078.html#ch03fn1" epub:type="noteref">... and, if I'm seeing this right, the very last line of your code chunk is the actual footnote, so it should start: Code: <p class="footnote" epub:type="footnote">... I'll throw in some references here so you can look them up: Footnote is at: https://www.w3.org/TR/epub-ssv/#footnote Noteref is at the bottom of this section: https://www.w3.org/TR/epub-ssv/#links I've never used the endnote tag, so even if I've got an endnote "chapter" at the end of the book, I still use the footnote tag in each footnote. As to the structure of the footnotes I see in what you posted, I'm not very happy with that. But, outside of esthetics, I don't think it'll make much difference and I doubt you'll want to re-do the footnotes. But, for reference, up where the footnote is called (in the text of the document), my footnote call looks like: Code: <a id="fn1" href="#fn1a" epub:type="noteref"><sup>n</sup></a>...</p> So, it consists of the <a> tag where it's given an id to come back to, the href where the actual footnote is and the noteref attribute, then the simple, superscripted note number and then the close of the <a> tag. I use <aside> tags to block off the actual footnote text, but I'm pretty sure any other type of block (<p>, <div>) will do. In my case, they look like: Code: <aside id="fn1a" class="footnote" epub:type="footnote"> <p><a href="#fn1"><sup>n</sup></a>.thenote.</p> </aside> So, it starts with the <aside> (or whatever) tag where the footnote is given its id, a styling class and the footnote attribute. Then an <a> tag with the return address of the calling source which is applied to a superscripted note number (and its closing </a>). Then, the actual note. And, finally, the closing <aside> (or whatever) tag. A couple of totally extraneous comments. First, the id attached to the <body> in what you posted starts with a digit. I'm pretty sure they can't start with a digit and Calibre will complain about that. Run, Tools > Check Book to confirm that. I'm pretty sure the Calibre editor will find and fix that. Second, I'm not sure how the forum mods will react to those screenshots of the actual book text. I'd think that one tiny bit of text would fall under fair use. But, they might complain.