An identifier is metadata that can be used to refer to Web Content in a - persistent and unambiguous manner. URLs, - URNs, DOIs, ISBNs, and PURLs are all examples of persistent - identifiers frequently used in publishing.
-The general term URL is defined by the URL - Standard [[!url]]. It is used as in other W3C specifications, like HTML [[!html]]. In particular, a URL allows for the usage of characters from Unicode following [[!rfc3987]]. - See the note in the HTML5 - specification for further details.
-PublicationManifest Dictionary
dictionary PublicationManifest {
required sequence<DOMString> type;
+ sequence<DOMString> id;
sequence<DOMString> accessMode;
sequence<DOMString> accessModeSufficient;
sequence<DOMString> accessibilityFeature;
@@ -339,6 +314,7 @@ The PublicationManifest Dictionary
sequence<CreatorInfo> publisher;
sequence<CreatorInfo> readBy;
sequence<CreatorInfo> translator;
+ sequence<DOMString> url;
DOMString duration;
DOMString inLanguage;
TextDirection inDirection;
@@ -542,7 +518,6 @@ Numbers
These values are expressed as [[!json]] numbers.
-
Explicit and Implied Objects
@@ -609,8 +584,7 @@ Links
link value, the link MUST be expressed in one of the following two ways:
- - as a string encoding the (absolute or relative) URL of the resources [[!url]];
- or
+ - as a string encoding the URL of the resources; or
- as an instance of a
LinkedResource
object that can be used to express the URL, the media type, and other
characteristics of the target resource.
@@ -647,15 +621,21 @@ Links
URLs
- Both relative and absolute URL strings MAY be
- used in the manifest.
+ URLs are used to identify resources associated with a digital
+ publication. They MUST be valid URL strings [[!url]].
- In the case of relative URL strings, these are resolved to absolute URL strings using a
+
Manifest URLs are restricted to only the http and https
+ schemes [[!url]]. URLs MUST
+ dereference to a resource, although user agents are not required to dereference all URLs in
+ the manifest.
+
+ In the case of relative-URL
+ strings, these are resolved to absolute-URL strings using a
base URL [[!url]].
- The base URL for relative URLs is determined as follows:
+ The base URL for relative-URL strings is determined as follows:
- In the case of an embedded manifest, the base URL is the
@@ -665,10 +645,28 @@
URLs
the manifest resource.
- By consequence, relative URLs in embedded manifests are resolved against the URL of the
- primary entry page unless the page declares a base URL (i.e., in a By consequence, relative-URL strings in embedded manifests are resolved against the URL of
+ the primary entry page unless the page declares a base URL (i.e., in a <base> element in its
header).
+
+ URLs allow for the usage of characters from Unicode following [[rfc3987]].
+ See the note in the HTML5
+ specification for further details.
+
+
+
+ Identifiers
+
+ Identifiers are URL records [[!url]]
+ that can be used to refer to Web Content in a
+ persistent and unambiguous manner. URLs,
+ URNs, DOIs, ISBNs, and PURLs are all examples of persistent
+ identifiers frequently used in publishing.
@@ -844,6 +842,134 @@ Accessibility
+
+ Address
+
+ A digital publication's
+ address is a URL that identifies its primary entry page. It is expressed
+ using the url property.
+
+
+
+
+ Term
+ Description
+ Required Value
+ Value Type
+ [[!schema.org]] Mapping
+
+
+
+
+
+
+ url
+
+
+ URL of the primary entry page.
+ A valid URL string [[!url]].
+ Array of URLs
+
+ url (Thing)
+
+
+
+
+ A digital publication MAY have more than one address, but all the addresses MUST resolve to
+ the same document.
+
+ The publication's address can also be used as value for an identifier link
+ relation [[link-relation]].
+
+
+{
+ "@context" : ["https://schema.org","https://www.w3.org/ns/wp-context"],
+ "type" : "Book",
+ …
+ "url" : "https://publisher.example.org/mobydick",
+ …
+}
+
+
+
+
+ Canonical Identifier
+
+ A digital publication's
+ canonical identifier property provides a unique identifier for the publication.
+ It is expressed using the id property.
+
+
+
+
+ Term
+ Description
+ Required Value
+ Value Type
+ [[!schema.org]] Mapping
+
+
+
+
+
+
+ id
+
+
+ Preferred version of the publication.
+ A URL record [[!url]].
+ Identifier
+ (None)
+
+
+
+
+ The canonical identifier SHOULD be a URL that resolves to the preferred version of the
+ digital publication. Using a URL provides a measure of permanence above and
+ beyond a digital publication's address(es). If a digital publication
+ is permanently relocated to a new URL, for example, the canonical address provides a way of
+ discovering the new location (e.g., a DOI
+ registry could be updated with the new URL, or a redirect could be added to the URL of the
+ canonical identifier). It is also intended to provide a means of identifying instances of
+ the same digital publication hosted at different URLs.
+
+ Ensuring uniqueness of canonical identifiers is outside the scope of this
+ specification. The actual achievable uniqueness depends on such factors as the conventions
+ of the identifier scheme used and the degree of control over assignment of identifiers.
+
+ If a canonical identifier is not provided in the manifest, or the value is an invalid URL,
+ the digital publication does not have a canonical identifier. User agents MUST NOT attempt
+ to construct a canonical identifier from any other identifiers provided in the manifest for
+ the canonical manifest.
+
+ The specification of the canonical identifier MAY be complemented by the inclusion of
+ additional types of identifiers using the identifier property [[!schema.org]] and/or its subtypes.
+
+
+{
+ "@context" : ["https://schema.org","https://www.w3.org/ns/wp-context"],
+ "type" : "TechArticle",
+ …
+ "id" : "http://www.w3.org/TR/tabular-data-model/",
+ "url" : "http://www.w3.org/TR/2015/REC-tabular-data-model-20151217/",
+ …
+}
+
+
+
+{
+ "@context" : ["https://schema.org","https://www.w3.org/ns/wp-context"],
+ "type" : "Book",
+ …
+ "id" : "urn:isbn:9780123456789",
+ "url" : "https://publisher.example.org/mobydick",
+ …
+}
+
+
+
Creators
@@ -1105,12 +1231,12 @@ Creators
-
id
- - A canonical identifier of the creator as a URL. [[!url]]
+ - A canonical identifier of the creator as an Identifier.
-
url
- - An address for the creator in the form of a URL. [[!url]]
+ - An address for the creator in the form of a URL.
Note that user agents MAY interpret a wider range of creator properties defined by Schema.org
@@ -1677,8 +1803,8 @@
Resource Categorization Properties
>privacy policy, and structural resources like the table of contents.
- Note that a particular resource's URL MUST NOT appear in more than one of these lists, and a URL
- MUST NOT be repeated within a list.
+ Note that a particular resource's URL MUST NOT appear in more than one of these lists, and
+ a URL MUST NOT be repeated within a list.
The manifest MUST NOT include a reference to itself within any of these lists.
@@ -1713,7 +1839,7 @@ Default Reading Order
One or more of:
- - a string, representing the URL [[url]] of the resource; or
+ - a string, representing the URL of the resource; or
- an instance of a
LinkedResource object
@@ -1801,7 +1927,7 @@ Resource List
One or more of:
- - a string, representing the URL [[url]] of the resource; or
+ - a string, representing the URL of the resource; or
- an instance of a
LinkedResource object
@@ -1886,7 +2012,7 @@ Links
One or more of:
- - a string, representing the URL [[url]] of the resource; or
+ - a string, representing the URL of the resource; or
- an instance of a
LinkedResource object
@@ -2122,7 +2248,7 @@ Accessibility Report
}
-
+
Preview
@@ -3031,9 +3157,9 @@ Publication Bounds
>default reading order and resource list.
To determine whether a resource is within the bounds of a Web Publication, user agents MUST
- compare the absolute URL of a resource to the absolute URLs of the resources obtained from the
- union. If the resource is identified in the enumeration, it is within the bounds of the Web
- Publication. All other resources are external to the Web Publication.
+ compare the absolute URL of a resource to the absolute URLs of the resources obtained
+ from the union. If the resource is identified in the enumeration, it is within the bounds of the
+ Web Publication. All other resources are external to the Web Publication.
Resources within the bounds of a Web Publication do not have to share the same domain.
@@ -3254,131 +3380,6 @@ Requirements
Properties
-
- Address
-
- A Web Publication's address is a URL [[!url]] that identifies the primary entry page for the Web
- Publication. It is expressed using the url property.
-
-
-
-
- Term
- Description
- Required Value
- Value Type
- [[!schema.org]] Mapping
-
-
-
-
-
- url
-
- URL of the primary entry page.
- A URL [[!url]].
- Array of URLs
-
- url (Thing)
-
-
-
-
- A Web Publication MAY have more than one address, but all the addresses MUST resolve to the
- same document.
-
- The publication's address can also be used as value for an identifier link
- relation [[link-relation]].
-
-
-{
- "@context" : ["https://schema.org","https://www.w3.org/ns/wp-context"],
- "type" : "Book",
- …
- "url" : "https://publisher.example.org/mobydick",
- …
-}
-
-
-
-
- Canonical Identifier
-
- A Web Publication's canonical identifier is a unique identifier that resolves to
- the preferred version of the Web Publication. It is expressed using the id
- property.
-
-
-
-
- Term
- Description
- Required Value
- Value Type
- [[!schema.org]] Mapping
-
-
-
-
-
- id
-
- Preferred version of the publication.
- A URL [[!url]].
- URL
- (None)
-
-
-
-
- Ensuring uniqueness of canonical identifiers is outside the scope of this
- specification. The actual achievable uniqueness depends on such factors as the conventions
- of the identifier scheme used and the degree of control over assignment of identifiers.
-
- The canonical identifier is intended to provide a measure of permanence above and beyond the
- Web Publication's address(es). If a Web Publication is permanently
- relocated to a new URL, for example, the canonical identifier provides a way of discovering
- the new location (e.g., a DOI registry could
- be updated with the new URL, or a redirect
- could be added to the URL of the canonical
- identifier). It is also intended to provide a means of identifying instances of the same Web
- Publication hosted at different URLs.
-
- If a URL is not provided in the manifest, or the value is an invalid URL, the Web Publication
- does not have a canonical identifier. User agents MUST NOT attempt to construct a canonical
- identifier from any other identifiers provided in the manifest for the canonical
- manifest.
-
- The specification of the canonical identifier MAY be complemented by the inclusion of
- additional types of identifiers for the Web Publication using the identifier
- property [[!schema.org]] and/or its subtypes.
-
-
-{
- "@context" : ["https://schema.org","https://www.w3.org/ns/wp-context"],
- "type" : "TechArticle",
- …
- "id" : "http://www.w3.org/TR/tabular-data-model/",
- "url" : "http://www.w3.org/TR/2015/REC-tabular-data-model-20151217/",
- …
-}
-
-
-
-{
- "@context" : ["https://schema.org","https://www.w3.org/ns/wp-context"],
- "type" : "Book",
- …
- "isbn" : "9780123456789",
- "url" : "https://publisher.example.org/mobydick",
- …
-}
-
-
-
Default Reading Order
@@ -3771,8 +3772,8 @@ LinkedResource Definition
Location of the resource. REQUIRED.
- A URL [[!url]]. Refer to the property definitions that accept this type for additional
- restrictions.
+ A valid URL string [[!url]]. Refer to the property definitions that accept this type
+ for additional restrictions.
URL