Middle discourses - missing footnotes in the ePub formatted book.
pingssgp opened this issue · comments
Operating scenario:
- Product file name: "Middle-Discourses-sujato-2024-02-12.epub"
- Date downloaded: 2024-02-18
- Platform, hardware: MacBook Pro, 2023 version, Apple M2 Pro.
- Operating system: macOS Sonoma 14.3.1
- Software used to open & read the book: Apple Books version 6.2 (build 6030)
Problem description:
I downloaded the complete bundle editions-2024-02-12 from the releases on GitHub. This bundle contains the ePub versions of the publications.
From the ePub versions, I opened the file stated above ("Middle-Discourses-sujato-2024-02-12.epub") in the Apple Books application on my MacBook Pro.
Within the ePub book there are clickable links for each of the numbered footnotes.
Expected behaviour:
When a footnote number is clicked, the book reader application should take me to the footnote and show its contents on the screen.
Actual behaviour:
Nothing happens when the footnote link is clicked.
Other supporting information:
The PDF version of the book has the text of the footnotes on the same page as the footnote itself. None of these footnotes appear anywhere in the ePub version.
I have not checked the ePubs for the other texts.
As an example, I looked through the LaTeX source file for the Majjhima Nikaya. The source for MN1 starts on line 880 in the file "Middle-Discourses-sujato-2023-10-09-1.tex".
Take, for example, footnote (1). The source file does have the relevant markup for the footnote.
\scevam{So\marginnote{1.1} I have heard.\footnote{Just as the \textsanskrit{Dīghanikāya} begins with the complex and
...
...
However, there could be an issue when it was converted to ePub. Both the open source Calibre reader and Apple's books application fail to render the footnote.
Hovering over footnote (1) in Calibre shows an internal link.
(see the status line at the bottom of the window for details).
However, clicking on that link fails to render anything. See the screenshot below.
When opening the same file in the Apple Books application, the footnote (1) shows as a clickable link that does nothing.
![image](https://private-user-images.githubusercontent.com/7234966/305710731-62a5cfc1-a9fc-4c30-9a5d-eeadab07bd4a.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjE4ODE4MzYsIm5iZiI6MTcyMTg4MTUzNiwicGF0aCI6Ii83MjM0OTY2LzMwNTcxMDczMS02MmE1Y2ZjMS1hOWZjLTRjMzAtOWE1ZC1lZWFkYWIwN2JkNGEucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDcyNSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA3MjVUMDQyNTM2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MDA1OWQ5MmE5NDM5ZDg4OWFhNTllMzkyZDRkYzM2MTg4YmY3YjgwYzZkY2MzZjllMjdmNzg4YTU5Zjk5ZTVlYSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.DigWyPWI2KQhwbcP5y31PrKJzbeLSbZg2847gZL4avE)
You can see that the footnotes (1 ... onwards) are blue hyperlinks and are clickable.
As an example of working links, here's a book that has a clickable bit of text linking to another section in the same ePub.
Clicking on the link in the rectangle (above) takes you to the relevant section within the same book (below).
I looked further into the ePub file. As an ePub is simply a ZIP file with XHTML content and some markup, you can unzip it and look into the individual XHTML chapter files.
The link in question above is the first footnote from MN1. The XHTML file for this chapter is mn-mulapannasa.xhtml
. The reference to footnote (1) appears in line 17.
![image](https://private-user-images.githubusercontent.com/7234966/305856434-831f4e80-9084-4670-92f6-e85c937b1dff.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjE4ODE4MzcsIm5iZiI6MTcyMTg4MTUzNywicGF0aCI6Ii83MjM0OTY2LzMwNTg1NjQzNC04MzFmNGU4MC05MDg0LTQ2NzAtOTJmNi1lODVjOTM3YjFkZmYucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDcyNSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA3MjVUMDQyNTM3WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NGMxZjNjM2IzM2EyMTZhMmI4MTk3MjI1NDVmMDVlNzJkMWE5Mzk1ODE0N2U0MDg5MzBjM2QyNDQwNjNmM2Y0NyZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ._f8ZRl2_DyCR-JP2W_TanDuFbSwcFdcJsFNJjLgm5kk)
The footnote refers to an external file endnotes.xhtml
that does not appear in the ePub bundle. I'm guessing that this file was just not generated when creating the ePub package.