jEpub icon indicating copy to clipboard operation
jEpub copied to clipboard

Metadata for series

Open lelinhtinh opened this issue 6 years ago • 0 comments

@jeffmcneill, since the “new” EPUB3 is mostly a reversion to EPUB 3.0.1, that’s the model to follow. See https://w3c.github.io/publ-epub-revision/epub32/spec/epub-packages.html#sec-belongs-to-collection for the spec, though the examples at https://w3c.github.io/publ-epub-revision/epub32/spec/epub-packages.html#group-position are perhaps a bit more complete. Basically:

<meta id="num" property="belongs-to-collection">Series Name Goes Here</meta>
<meta property="collection-type" refines="#num">series</meta>
<meta property="group-position" refines="#num">1</meta>

Caveats:

  • I’m not clear when you’d use set instead of series. The example shown puts a Harry Potter book in a set, but would that have been the right decision when the books were still being released? How about a book series whose final length is not known at the moment?
  • Note that group-position is “A single xsd:unsignedInt or series of decimal-separated numbers (e.g., 1 or 2.2.1).”)
  • The specs recommend also giving the collection an identifier, e.g.,
    <meta property="belongs-to-collection" id="c02">Harry Potter</meta>
    <meta refines="#c02" property="collection-type">set</meta>
    <meta refines="#c02" property="group-position">2</meta>
    <meta refines="#c02" property="dcterms:identifier">urn:uuid:99999999-8888-7777-6666-555555555555</meta>
    
    but I have no idea whether any reading system implemented actually cares about that. Probably can’t hurt, though.
  • Supposedly, a book can belong to multiple collections. Good luck getting any reading systems to respect that, though.

Originally posted by @jcsalomon in https://github.com/w3c/publ-epub-revision/issues/326#issuecomment-441413635

lelinhtinh avatar Jun 03 '19 12:06 lelinhtinh