epub.js is a epub reader to allow annotation through hypothes.is

https://web.archive.org/web/20240106090941/https://web.hypothes.is/blog/ebook-partnership/

Hypothes.is announced a partnership to bring annotation to epub e-books in 2017, but after 2018 no mention of it on their blog. Mailed them to ask about any progress since. Read someone's msg on Masto that they have trouble keeping epub annotations connected to the book (unlike e.g. my kindle annotations that reside in the book, but also are linked back to the location by my obsidian kindle plugin, maintaining the connection and reference. epub is xhtml so it should be doable.

epub is part of w3c standards (cause xhtml)

The W3C standard for Epub ebooks. Nav [[How Standard Ebooks serves millions of requests per month with a 2GB VPS; or, a paean to the classic web - Alex Cabal]]

https://web.archive.org/web/20240104082611/https://alexcabal.com/posts/standard-ebooks-and-classic-web-tech

first published #2022/02/11

Apart from the framing of this post more as an apology than as a show of strength of keeping things simple and sturdy, interesting nuggets: Epub ebooks are xhtml and static so rapidly served without the need for a fancy framework or even a database. Flat texts are small, and their current collection fits in RAM entirely. PHP is used without frills. All in all a strong call to keep things simple, and to embrace my current use of php for local tools too: it's very fast.

Also makes me wonder: #openvraag what can one do with Epub books outside an ebook reader, in terms of excerpting e.g. and ripping things out for re-use elsewhere. I've got loads of them on my laptop

https://standardebooks.org/

<small><cite class='h-cite via'>ᔥ <span class='p-author h-card'>awarm.space</span> in Making a modern ebook with Standard Ebooks (<time class='dt-published'>08/02/2021 12:08:19</time>)</cite></small>

Q.: How can users access the OPDS catalogue?

A.: OPDS catalogue URL http://yoursite.com/feed/opds.

```js const axios = require('axios'); const epub = require('epub-gen');

axios.get('http://www.gutenberg.org/files/2701/2701-0.txt'). then(res => res.data). then(text => { text = text.slice(text.indexOf('EXTRACTS.')); text = text.slice(text.indexOf('CHAPTER 1.'));

const lines = text.split('\r\n');
const content = [];
for (let i = 0; i < lines.length; ++i) {
  const line = lines[i];
  if (line.startsWith('CHAPTER ')) {
    if (content.length) {
      content[content.length - 1].data = content[content.length - 1].data.join('\n');
    }
    content.push({
      title: line,
      data: ['<h2>' + line + '</h2>']
    });
  } else if (line.trim() === '') {
    if (content[content.length - 1].data.length > 1) {
      content[content.length - 1].data.push('</p>');
    }
    content[content.length - 1].data.push('<p>');
  } else {
    content[content.length - 1].data.push(line);
  }
}

const options = {
  title: 'Moby-Dick',
  author: 'Herman Melville',
  output: './moby-dick.epub',
  content
};

return new epub(options).promise;

}). then(() => console.log('Done')); ```

This appendix is informative

All examples use the same hypothetical publication of Alice in Wonderland, and are given in the collection structure with a single annotation.

• Commentary Annotation on Publication with URI json-ld { "@context": "http://www.idpf.org/epub/oa/1.0/context.json", "@id": "http://example.org/epub/annotations.json", "@type": "epub:AnnotationCollection", "annotations": [ { "@id": "urn:uuid:E7E3799F-3CD5-4F69-87C6-5478B22873D6", "@type": "oa:Annotation", "hasTarget": { "@type": "oa:SpecificResource", "hasSource": { "@id": "http://www.example.org/ebooks/A1B0D67E-2E81-4DF5/v2.epub", "@type": "dctypes:Text" } }, "hasBody": { "@type": "dctypes:Text", "format": "application/xhtml+xml", "chars": "<div xml:lang='en' xmlns='http://www.w3.org/1999/xhtml'>I love Alice in Wonderland</div>", "language": "en" }, "motivatedBy": "oa:commenting" } ] }

• Commentary Annotation on Publication without Identifying URI json-ld { "@context": "http://www.idpf.org/epub/oa/1.0/context.json", "@id": "http://example.org/epub/annotations.json", "@type": "epub:AnnotationCollection", "annotations": [ { "@id": "urn:uuid:E7E3799F-3CD5-4F69-87C6-5478B22873D6", "@type": "oa:Annotation", "hasTarget": { "@type": "oa:SpecificResource", "hasSource": { "@type": "dctypes:Text", "uniqueIdentifier": "isbn:123456789x", "originURL": "http://www.example.com/publisher/book/", "dc:identifier": "urn:uuid:A1B0D67E-2E81-4DF5-9E67-A64CBE366809", "dcterms:modified": "2011-01-01T12:00:00Z" } }, "hasBody": { "@type": "dctypes:Text", "format": "application/xhtml+xml", "chars": "<div xml:lang='en' xmlns='http://www.w3.org/1999/xhtml'>I love Alice in Wonderland</div>", "language": "en" }, "motivatedBy": "oa:commenting" } ] }

• Collection Metadata json-ld { "@context": "http://www.idpf.org/epub/oa/1.0/context.json", "@id": "http://example.org/epub/annotations.json", "@type": "epub:AnnotationCollection", "dc:title": "Alice in Wonderland Annotations", "dc:publisher": "Example Organization", "dc:creator": "Anne O'Tater", "dcterms:modified": "2014-03-17T12:30:00Z", "dc:description": "Anne's collection of annotations on Alice in Wonderland", "dc:rights": [ { "@value": "Quelques droits en Français", "@language": "fr" }, { "@value": "Some Rights in English", "@language": "en" } ], "annotations": [ { "@id": "urn:uuid:E7E3799F-3CD5-4F69-87C6-5478B22873D6", "@type": "oa:Annotation", "hasTarget": { "@type": "oa:SpecificResource", "hasSource": { "@type": "dctypes:Text", "uniqueIdentifier": "isbn:123456789x", "originURL": "http://www.example.com/publisher/book/", "dc:identifier": "urn:uuid:A1B0D67E-2E81-4DF5-9E67-A64CBE366809", "dcterms:modified": "2011-01-01T12:00:00Z" } }, "hasBody": { "@type": "dctypes:Text", "format": "application/xhtml+xml", "chars": "<div xml:lang='en' xmlns='http://www.w3.org/1999/xhtml'>I love Alice in Wonderland</div>", "language": "en" }, "motivatedBy": "oa:commenting" } ] }

• Annotation with Ancillary Resources in the Zip json-ld { "@context": "http://www.idpf.org/epub/oa/1.0/context.json", "@id": "http://example.org/epub/annotations.json", "@type": "epub:AnnotationCollection", "annotations": [ { "@id": "urn:uuid:E7E3799F-3CD5-4F69-87C6-5478B22873D6", "@type": "oa:Annotation", "hasTarget": { "@type": "oa:SpecificResource", "hasSource": { "@type": "dctypes:Text", "uniqueIdentifier": "isbn:123456789x", "originURL": "http://www.example.com/publisher/book/", "dc:identifier": "urn:uuid:A1B0D67E-2E81-4DF5-9E67-A64CBE366809", "dcterms:modified": "2011-01-01T12:00:00Z" } }, "hasBody": { "@type": "dctypes:Text", "format": "application/xhtml+xml", "chars": "<div xml:lang='en' xmlns='http://www.w3.org/1999/xhtml'>I love Alice in Wonderland! <img src='/imgs/heart.jpg'/></div>" }, "motivatedBy": "oa:commenting" } ] }

• Styling of Selection

json-ld { "@context": "http://www.idpf.org/epub/oa/1.0/context.json", "@id": "http://example.org/epub/annotations.json", "@type": "epub:AnnotationCollection", "annotations": [ { "@id": "urn:uuid:E7E3799F-3CD5-4F69-87C6-5478B22873D6", "@type": "oa:Annotation", "styledBy": { "@type": "oa:CssStyle", "format": "text/css", "chars": ".red { border: 1px solid red; }" }, "hasTarget": { "@type": "oa:SpecificResource", "hasSelector": { "@type": "oa:FragmentSelector", "value": "epubcfi(/6/4[chap01ref]!/4[body01]/10[para05]/3:10)" }, "hasSource": { "@type": "dctypes:Text", "uniqueIdentifier": "isbn:123456789x", "originURL": "http://www.example.com/publisher/book/", "dc:identifier": "urn:uuid:A1B0D67E-2E81-4DF5-9E67-A64CBE366809", "dcterms:modified": "2011-01-01T12:00:00Z" }, "styleClass": "red" }, "hasBody": { "@type": "dctypes:Text", "format": "application/xhtml+xml", "chars": "<div xml:lang='en' xmlns='http://www.w3.org/1999/xhtml'>I love this part of the text</div>", "language": "en" }, "motivatedBy": "oa:commenting" } ] }

• Replying to an Annotation json-ld { "@context": "http://www.idpf.org/epub/oa/1.0/context.json", "@id": "http://example.org/epub/annotations.json", "@type": "epub:AnnotationCollection", "annotations": [ { "@id": "urn:uuid:B81AF8C4-B04A-4D3D-B1D3-23F7C02E56BB", "@type": "oa:Annotation", "motivatedBy": "oa:replying", "hasTarget": "urn:uuid:E7E3799F-3CD5-4F69-87C6-5478B22873D6", "hasBody": { "@type": "dctypes:Text", "format": "application/xhtml+xml", "chars": "<span xmlns='http://www.w3.org/1999/xhtml'>I agree!</span>" } } ] }

xml <link href="https://circulation.librarysimplified.org/NYNYPL/annotations/Gutenberg%20ID/40278/" type="application/ld+json; profile=&quot;http://www.w3.org/ns/anno.jsonld&quot;" rel="http://www.w3.org/ns/oa#annotationService"/>

```html <link rel="alternate" type="application/opml+xml" title="Outline" href="https://www.openedition.org/?page=opml" />

<link rel="alternate" type="application/atom+xml;profile=opds-catalog" title="OpenEdition OPDS Catalogue" href="http://opds.openedition.org" /> ```

• Feedbooks : http://fr.feedbooks.com/catalog
• Atramenta : https://www.atramenta.net/opds/
• Gallica : https://gallica.bnf.fr/opds
• Ebooks Gratuits : https://www.ebooksgratuits.com/opds/
• Archive.org : http://bookserver.archive.org/catalog
• Projet Gutenberg : http://m.gutenberg.org/ebooks/?format=opds
• Framabookin : https://framabookin.org/

A Canonical Fragment Identifier (CFI) is a similar construct to these, but expresses a location within an EPUB Publication. For example:

book.epub#epubcfi(/6/4[chap01ref]!/4[body01]/10[para05]/3:10)

OPDS Endpoint: http://www.feedbooks.com/catalog.atom

https://www.theverge.com/2022/5/2/23053408/amazon-epub-kindle-ereader-file-format-kf8

https://addons.mozilla.org/en-US/firefox/addon/epubreader/

A browser extension for reading ePub files in Firefox.

https://forum.obsidian.md/t/epub-support/1403

Some interesting resources here, though none currently suit workflows I'm keen to support yet. There is a reference to FuturePress' epub.js which could be intriguing, though even here, I'm more likely to stick with Hypothes.is for annotating and note taking to keep context.

I totally want this!

Convert epub to mobi in bookdown

As it happens, this annotation works through its proper URL) but, Hypothesis butchered the link. You need to turn the page once to see the highlight though.

A long time partner, Ubiquity recently announced deeper annotation support across their ebooks.

Interesting. Because they're easier (more familiar?) to work with?

Bu kavram ilk defa bu yazıda kullanıldı. Web içeriği ile sosyal medyada paylaşılan içeriklerin görüntüleme davranışını açıklayan bir kavram.

Whaa..? This sounds seriously hard. But remarkably clever.

More background reading on CIF annotations in EPUB and iBooks.

This is a good resource explaining the how EPUB CFIs are structured.

We all do.

Ah, therein lies the crux of the problem. “Multi-touch” is what sets iBooks apart from other formats (despite the fact that the ePub format allows for the same exact type of interaction).

Sounds like a time-consuming process, but maybe there’s value in chunking the content to be adapted to diverse contexts.

May be challenging because of the restrictions placed on ePub, but it’s an interesting thought.

aka ePub3?

Somehow, eBooks aren’t part of responsive design? Even in ePUB3?

Sounds like ePUB without the full spec…

Could see a lot of potential for Open Standards, including annotations. What’s not so clear is how they can manage to produce such ePub while maintaining their DRM-focused practice. Heard about LCP (Lightweight Content Protection). But have yet to get a fully-accessible ePub which is also DRMed in such a way.

Leaving the door open for eBooks? IDPF is part of the coalition after all and there are important connections with work done on ePUB3.

Anchors are a key issue. Hope that deliverable will suffice.