tastytea
/
blog
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

PDF→EPUB: Add epub:type to examples.

This commit is contained in:
tastytea 2021-03-21 22:21:52 +01:00
parent a8b9c51b7d
commit b26895aa88
Signed by: tastytea
GPG Key ID: CFC39497F1B26E07
1 changed files with 25 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
content/posts/how-i-convert-pdfs-to-epub.adoc
View File

@ -20,6 +20,9 @@ toc: true
:url-calibre-convert: https://manual.calibre-ebook.com/conversion.html#pdfconversion :url-calibre-convert: https://manual.calibre-ebook.com/conversion.html#pdfconversion
:url-emacs: https://www.gnu.org/software/emacs/ :url-emacs: https://www.gnu.org/software/emacs/
:url-emacs-key-notation: https://www.emacswiki.org/emacs/EmacsKeyNotation :url-emacs-key-notation: https://www.emacswiki.org/emacs/EmacsKeyNotation
:url-helicon-type: https://www.heliconbooks.com/?id=blog&postid=EPUB3Footnotes
:url-epub-spec: https://www.w3.org/publishing/epub/epub-contentdocs.html
:url-ap-semantics: https://www.accessiblepublishing.ca/epub-semantic-aria-roles/
:wp-pdf: https://en.wikipedia.org/wiki/PDF :wp-pdf: https://en.wikipedia.org/wiki/PDF
:wp-epub: https://en.wikipedia.org/wiki/EPUB :wp-epub: https://en.wikipedia.org/wiki/EPUB
:wp-xhtml: https://en.wikipedia.org/wiki/XHTML :wp-xhtml: https://en.wikipedia.org/wiki/XHTML
@ -68,7 +71,7 @@ Your files should look similar to this:
[source,html] [source,html]
-------------------------------------------------------------------------------- --------------------------------------------------------------------------------
<?xml version='1.0' encoding='utf-8'?> <?xml version='1.0' encoding='utf-8'?>
<html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" lang="en">
<head> <head>
<title>Meine zwei Jahre in Russland</title> <title>Meine zwei Jahre in Russland</title>
@ -175,20 +178,21 @@ elisp function:
Once you are done, copy the result into Calibre. Once you are done, copy the result into Calibre.
== Add footnotes [#_add_footnotes]
== Add endnotes
Use the method from above to copy the footnotes into the now empty Emacs buffer Use the method from above to copy the endnotes into the now empty Emacs buffer
and clean them up until you have 1 paragraph per line. Footnotes need to be and clean them up until you have 1 paragraph per line. Endnotes need to be
hyperlink-able, so we can't just wrap them in plain `<p>` tags, they need IDs. I hyperlink-able, so we can't just wrap them in plain `<p>` tags, they need IDs. I
like to use `<span>1</span><p id="fn1">[…]</p>` if there is only one like to use `<span>1</span><aside epub:type="endnote" id="fn1">[…]</aside>` if there
footnote-section or `<span>1</span><p id="fn1_1">[…]</p>` for is only one footnote-section or `<span>1</span><aside epub:type="endnote"
chapter-footnotes. We are going to use a macro with a counter to generate id="fn1_1">[…]</aside>` for chapter-endnotes. We are going to use a macro with a
consecutively numbered IDs. First, set the counter to 1 with kbd:[C-x] counter to generate consecutively numbered IDs. First, set the counter to 1 with
kbd:[C-k] kbd:[C-c] `1`. Then, record this macro: kbd:[C-x] kbd:[C-k] kbd:[C-c] `1`. Then, record this macro:
`<span>` kbd:[C-x] kbd:[C-k] kbd:[<tab>] kbd:[C-u] `-1` kbd:[C-x] kbd:[C-k] `<span>` kbd:[C-x] kbd:[C-k] kbd:[<tab>] kbd:[C-u] `-1` kbd:[C-x] kbd:[C-k]
kbd:[C-a] `</span><p id="fn` kbd:[C-x] kbd:[C-k] kbd:[<tab>] `">` kbd:[<end>] kbd:[C-a] `</span><aside epub:type="endnote" id="fn` kbd:[C-x] kbd:[C-k]
`</p>` kbd:[<down>] kbd:[<down>] kbd:[<home>] kbd:[<tab>] `">` kbd:[<end>] `</aside>` kbd:[<down>] kbd:[<down>] kbd:[<home>]
[NOTE] [NOTE]
kbd:[C-u] `-1` kbd:[C-x] kbd:[C-k] kbd:[C-a] “adds” -1 to the counter, so that kbd:[C-u] `-1` kbd:[C-x] kbd:[C-k] kbd:[C-a] “adds” -1 to the counter, so that
@ -200,7 +204,8 @@ out what a key combination does.
Call the macro until every footnote is wrapped and copy them to Calibre. Call the macro until every footnote is wrapped and copy them to Calibre.
=== Add references to footnotes [#_add_references_to_footnotes]
=== Add references to endnotes
The footnotes are probably superscript numbers in the PDF but normal numbers in The footnotes are probably superscript numbers in the PDF but normal numbers in
the EPUB right now. I found that the footnote-numbers are usually preceded by a the EPUB right now. I found that the footnote-numbers are usually preceded by a
@ -208,7 +213,7 @@ space and followed by a space or `<`. I use the find & replace function in
Calibre in Regex-mode to convert them to hyperlinks. Calibre in Regex-mode to convert them to hyperlinks.
Find: ``&nbsp;([0-9]{1,3})([ <])`` (note the leading space) + Find: ``&nbsp;([0-9]{1,3})([ <])`` (note the leading space) +
Replace: `<sup><a href="#fn\1">\1</a></sup>\2` Replace: `<sup><a epub:type="noteref" href="#fn\1">\1</a></sup>\2`
Press kbd:[<f3>] to search through the text and kbd:[C-r] to replace. Press kbd:[<f3>] to search through the text and kbd:[C-r] to replace.
@ -225,5 +230,12 @@ Select menu:Tools[Check book] and fix the errors.
You're done! Enjoy your cleanly formatted book. 😊 You're done! Enjoy your cleanly formatted book. 😊
== Updates
* [2021-02-21] Added ``epub:type``s to examples. See
link:{url-helicon-type}[Helicon Books: Footnotes in EPUB3],
link:{url-epub-spec}#sec-epub-type-attribute[the EPUB specification] and
link:{url-ap-semantics}[AccessiblePublishing: EPUB Semantics, ARIA Roles, &
Metadata] for more information.
// LocalWords: Calibre // LocalWords: Calibre