This document defines the RDFS [[rdf-schema]] vocabulary for the [[[epub-anno-10]]] specification. RDF versions of the vocabulary, in Turtle [[turtle]] and JSON-LD [[json-ld11]], as well as a JSON-LD @context, are also available.

This document defines the EPUB Annotations Vocabulary 1.0, an RDFS [[rdf-schema]] vocabulary formalizing the terms defined in the [[[epub-anno-10]]] specification. The vocabulary is a "profile" of the W3C [[[annotation-vocab]]].

Introduction

This document defines the EPUB Annotations Vocabulary 1.0, an RDFS [[rdf-schema]] vocabulary formalizing the terms defined in the [[[epub-anno-10]]] specification. The vocabulary is a "profile" of the W3C [[[annotation-vocab]]].

Publishing this vocabulary as a Working Group Note ensures the stability of the vocabulary and of the related JSON-LD @context file. This stability is important for implementers of [[epub-anno-10]] who want to rely on the Linked Data aspects of the underlying Data Model.

Namespaces

This specification makes use of the following namespaces:

ea
http://www.w3.org/ns/ea#
oa
http://www.w3.org/ns/oa#
as
http://www.w3.org/ns/activitystreams#
foaf
http://xmlns.com/foaf/0.1/
dc
http://purl.org/dc/terms/
dcterms
http://purl.org/dc/terms/
owl
http://www.w3.org/2002/07/owl#
rdf
http://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfs
http://www.w3.org/2000/01/rdf-schema#
xsd
http://www.w3.org/2001/XMLSchema#

Term definitions

Class definitions

The following are class definitions in the ea namespace.

About

Information about the EPUB publication

See the formal definition of the term.

Dublin Core terms are used with this class, retaining the prefixes (to be in line with the EPUB Package Document).
Range of:
about
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

Annotation

EPUB Annotation Object

See the formal definition of the term.

A subclass of the Web Annotation object with some restrictions with regards of various properties.
Subclass of:
oa:Annotation
Range of:
items
Domain of:
body, motivation, target
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

AnnotationSet

Set of annotations

See the formal definition of the term.

An unordered collection of annotations, used as an interchange format amont EPUB Reading Systems.
Domain of:
about, generator, items, setTitle
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

Body

Body of an EPUB Annotation

See the formal definition of the term.

In EPUB, annotations are restricted to have textual content only.
Subclass of:
oa:TextualBody
Range of:
body
Domain of:
color, highlight, tags
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

Creator

Creator of an EPUB Annotation

See the formal definition of the term.

JSON-LD serializations should use the terms Person, Organization, or Software for typing, as these are the only available creator types.
Subclass of:
foaf:Person ⊔ foaf:Organization ⊔ as:Application
Range of:
creator
In the domain of:
name
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

FragmentSelector

Fragment Selector in EPUB

See the formal definition of the term.

This is restricted version of the Web Annotation Fragment Selector, reducing the list of valid media types.
Subclass of:
oa:FragmentSelector
Domain of:
conformsTo
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

Generator

Generator

See the formal definition of the term.

Information about the tool generating the annotations.
Range of:
generator
Domain of:
homepage
In the domain of:
name
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

Meta

Meta

See the formal definition of the term.

this class is currently undefined...
Range of:
meta
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

Selector

EPUB Annotation selector

See the formal definition of the term.

A restrictive subset of selectors, usable in EPUB.
Subclass of:
FragmentSelector ⊔ oa:CssSelector ⊔ oa:TextPositionSelector
Range of:
refinedBy, selector
Domain of:
refinedBy
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

Target

Target of an EPUB Annotation.

See the formal definition of the term.

Range of:
target
Domain of:
meta, selector, source
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

Property definitions

The following are property definitions in the ea namespace.

about

Information on the EPUB publication

See the formal definition of the term.

Provide information on the EPUB publication associated with an Annotation Set.
Domain:
AnnotationSet
Range:
About
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

body

Designates the body of an annotation

See the formal definition of the term.

The range of body types is restricted for EPUB.
Subproperty of:
oa:hasBody
Domain:
Annotation
Range:
Body
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

color

Highlight color

See the formal definition of the term.

Domain:
Body
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

conformsTo

Designates the fragment format

See the formal definition of the term.

The range of possible media formats in Fragment Selectors is restricted, see the range of this property.
Subproperty of:
dcterms:conformsTo
Domain:
FragmentSelector
Range:
dcterms:Standard
Value may be one of:
https://tools.ietf.org/rfc/rfc3236.html, http://www.w3.org/TR/media-frags/, https://www.w3.org/TR/SVG/, https://wicg.github.io/scroll-to-text-fragment/
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

creator

Information on the creator of an annotation

See the formal definition of the term.

The range of Creator types is restricted in EPUB.
Subproperty of:
dcterms:creator
Range:
Creator
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

generator

Information on the tool generating the annotations

See the formal definition of the term.

Subproperty of:
as:generator
Domain:
AnnotationSet
Range:
Generator
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

highlight

Highlight mode

See the formal definition of the term.

Domain:
Body
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

homepage

Homepage of the tool generating the annotations

See the formal definition of the term.

The property's value should be a URL, i.e., not a literal.

Subproperty of:
foaf:homepage
Domain:
Generator
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

items

Items in a set of annotations

See the formal definition of the term.

Domain:
AnnotationSet
Range:
Annotation

In a JSON-LD representation, values to this property are supposed to be represented in the form of a JSON array, even if there is just a single value.

Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

meta

Meta

See the formal definition of the term.

To be defined…
Domain:
Target
Range:
Meta
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

motivation

Provides the motivation for an annotation

See the formal definition of the term.

The set of motivation types is restricted in EPUB, see the range definition. In the JSON-LD serialization those terms should be used without prefix.
Subproperty of:
oa:motivatedBy
Domain:
Annotation
Range:
oa:Motivation
Value may be one of:
oa:bookmarking, oa:commenting, oa:highlighting
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

name

Name

See the formal definition of the term.

This property is available on some classes, see domain definition.
Subproperty of:
foaf:name
Domain:
Creator ⊔ Generator
Range:
xsd:string
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

refinedBy

Selector refinement

See the formal definition of the term.

This property restricts the usage of the general oa:refinedBy property to the list of Selector types available in EPUB.
Subproperty of:
oa:refinedBy
Domain:
Selector
Range:
Selector
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

selector

Designates the selector(s) for a target

See the formal definition of the term.

This property restricts the possible Selector types in EPUB.
Subproperty of:
oa:hasSelector
Domain:
Target
Range:
Selector
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

source

Designates the source resource for the target

See the formal definition of the term.

The property's value should be a URL, i.e., not a literal.

Subproperty of:
oa:hasSource
Domain:
Target
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

tags

Tags

See the formal definition of the term.

Domain:
Body
Range:
xsd:string

In a JSON-LD representation, values to this property are supposed to be represented in the form of a JSON array, even if there is just a single value.

Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

target

Designates the target resource for the EPUB annotation

See the formal definition of the term.

Subproperty of:
oa:hasTarget
Domain:
Annotation
Range:
Target
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

setTitle

Title of the Annotation Set

See the formal definition of the term.

In the generated JSON-LD context file this term appears as "title".

Domain:
AnnotationSet
Range:
xsd:string
Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

Definitions for individuals

The following are definitions for individuals in the ea namespace.

pink

Pink selection color

See the formal definition of the term.

Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

orange

Orange selection color

See the formal definition of the term.

Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

yellow

Yellow selection color

See the formal definition of the term.

Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

green

Green selection color

See the formal definition of the term.

Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

blue

Blue selection color

See the formal definition of the term.

Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

purple

Purple selection color

See the formal definition of the term.

Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

solid

Solid selection highlight

See the formal definition of the term.

Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

underline

Underline selection highlight

See the formal definition of the term.

Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

strikethrough

Strikethrough selection highlight

See the formal definition of the term.

Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld

outline

Outline selection highlight

See the formal definition of the term.

Relevant @context:
https://www.w3.org/ns/epub-anno.jsonld