diff --git a/content/posts/how-i-convert-pdfs-to-epub.adoc b/content/posts/how-i-convert-pdfs-to-epub.adoc index 44648a4..c85be81 100644 --- a/content/posts/how-i-convert-pdfs-to-epub.adoc +++ b/content/posts/how-i-convert-pdfs-to-epub.adoc @@ -25,6 +25,8 @@ toc: true :url-epub-spec: https://www.w3.org/publishing/epub/epub-contentdocs.html :url-ap-semantics: https://www.accessiblepublishing.ca/epub-semantic-aria-roles/ :url-epub3-rendering: http://idpf.org/forum/topic-623 +:url-epubcheck: https://github.com/w3c/epubcheck +:url-epubcheck-footnote: {url-epubcheck}/issues/1018#issuecomment-809385963 :wp-pdf: https://en.wikipedia.org/wiki/PDF :wp-epub: https://en.wikipedia.org/wiki/EPUB :wp-xhtml: https://en.wikipedia.org/wiki/XHTML @@ -204,15 +206,14 @@ Once you are done, copy the result into Calibre. Use the method from above to copy the footnotes into the now empty Emacs buffer and clean them up until you have 1 paragraph per line. Footnotes need to be hyperlink-able, so we can't just wrap them in plain `

` tags, they need IDs. I -like to use `

  • […]
  • ` if -the footnote numbers are increasing throughout the book or `
  • […]
  • ` if they start with -1 in each chapter. We are going to use a macro with a counter to generate -consecutively numbered IDs. First, set the counter to 1 with kbd:[C-x] kbd:[C-k] -kbd:[C-c] `1`. Then, record this macro: +like to use `
  • […]
  • ` if the footnote numbers +are increasing throughout the book or `
  • […]
  • ` if they start with 1 in each chapter. We are going to use a +macro with a counter to generate consecutively numbered IDs. First, set the +counter to 1 with kbd:[C-x] kbd:[C-k] kbd:[C-c] `1`. Then, record this macro: -`
  • ` kbd:[] `
  • ` kbd:[] kbd:[] kbd:[] +`
  • ` +kbd:[] `
  • ` kbd:[] kbd:[] kbd:[] [TIP] Use kbd:[M-x] `describe-key` (mapped to kbd:[C-h] kbd:[k] by default) to find @@ -252,6 +253,8 @@ copyright page, beginning of text and so on. Select menu:Tools[Check book] and fix the errors. +Use link:{url-epubcheck}[EPUBCheck] for a more thorough check. + You're done! Enjoy your cleanly formatted book. 😊 == Updates @@ -265,5 +268,8 @@ You're done! Enjoy your cleanly formatted book. 😊 `