@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 w3c/epub-specs#326 (comment)
@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:
Caveats:
setinstead ofseries. The example shown puts a Harry Potter book in aset, 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?group-positionis “A singlexsd:unsignedIntor series of decimal-separated numbers (e.g.,1or2.2.1).”)Originally posted by @jcsalomon in w3c/epub-specs#326 (comment)