Skip to content

DanteDT/pmd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Power lit

Moby-Dick annotated ebook, based on the great efforts of Power Moby-Dick, The Online Annotation.

With front/back material from a scanned, signed first-edition from the Internet Archive.

Notes about this ebook

  • The copyrighted notes in this ebook are used by permission of their author.
    • The resulting ebook is for your personal use. Resale is forbidden.
  • The page images in this ebook from Harper & Brothers' 1851 edition are in the public domain.
  • The Rockwell Kent illustrations in this ebook from Lakeside Press' 1930 edition are in the public domain.
  • The fonts included in this ebook, Dante MT and Charis_SIL, are in the public domain.

Very brief overview of the ebook assembly workflow

  1. Scrape PMD TOC and Chapters
  2. Clean up HTML, then organize and markup to improve the e-reader experience (Popup footnotes! See below.)
  3. Prep the EPUB content, XHTML chapters
  4. Build the EPUB - an edition that uses epub footnotes, and an edition that uses hyperlinks. See below.
  5. Check preiodically for updated annotations

I test on ebook readers that I have used for a long time, without trying harder for more common devices or apps :

Why two ebook variations? What's the difference?

Unfortunately, ebook readers (devices and apps) support TOC Navigation and Footnotes/Endnotes in different ways (or, too often, do not).

To keep this overview minimal, I address these technical topics in:

Due to unreliable support for these two essential ebook features by device manufacturers and app developers, your ebook reader may work better with

  • the footnote release (popup footnotes and endnotes 😃), or
  • the hyperlink release (functional yet disruptive links back-and-forth between main text and insightful notes 😒)

Why is it so hard for device manufacturers and app developers to get this right? I don't know. People get hard stuff right all the time, when they want to.

Use and Contribute

Suggestions are welcome to improve the annotated Moby-Dick reading experience. Something not work on your device? Please report it.

If you can demonstrate WORKING, or WORKING/CONFORMANT Popup Footnotes or TOC Navigation for a particular scenario, please consider submitting that. See examples that:

  • conform ... popups work, and syntax conforms to a recognized standard, and
  • work ... popups work, although syntax may not conform to any spec.
  • no copyrighted content, please. just simple examples of working syntax, like the ones in those folders.

Customize your own edition for your personal use (see above). Consider the config.yaml setting debugging: True to debug modifications. The setting epub_ref: "foot" produces the Footnote editions; epub_ref: "link" produces the hyperlink edition.

Recognize, attribute, and appreciate

With respect and gratitude for Herman and Margaret. ❤️

  • Moby-Dick by Herman Melville is in the public domain.
  • All notes in Power Moby-Dick: The Online Annotation copyright 2008 by Margaret Guroff.
  • The software I created to clean up and assemble that book requires attribution. See the MIT license.

Standard Ebooks share a beautiful, inspiring sentiment:

"The public domain is a priceless resource for all of us, and for the generations after us. It’s a free repository of our culture going back centuries—a way for us to see where we came from and to chart where we’re going. It represents our collective cultural heritage."

This workflow and software to clean up and assemble an ebook with popup notes is what I can offer.

-- DDT

About

Ebook built with permission from copyrighted Power Moby-Dick Online Annotation edition, with public-domain illustrations

Resources

License

Stars

Watchers

Forks

Contributors