Descriptive properties describe aspects of a Web Publication, such as its Descriptive properties describe aspects of a Web Publication, such as its title, creator, and language. These properties are primarily drawn from Schema.org and its hosted
@@ -796,7 +796,7 @@ Requirements
The way that properties are expressed in the manifest and infoset often differs from how they are + referred to using natural language. The following table provides a mapping between property names + and the sections where they are explained to help clarify the differing nomenclature:
+ +| Property Name | +Defined In | +
|---|---|
accessMode |
+ Accessibility | +
accessModeSufficient |
+ Accessibility | +
accessibilityAPI |
+ Accessibility | +
accessibilityControl |
+ Accessibility | +
accessibilityFeature |
+ Accessibility | +
accessibilityHazard |
+ Accessibility | +
accessibilitySummary |
+ Accessibility | +
artist |
+ Creators | +
author |
+ Creators | +
contents |
+ Table of Contents | +
contributor |
+ Creators | +
creator |
+ Creators | +
dateModified |
+ Last Modification Date | +
datePublished |
+ Publication Date | +
editor |
+ Creators | +
https://www.w3.org/ns/wp#accessibility-report |
+ Accessibility Report | +
https://www.w3.org/ns/wp#cover |
+ Cover | +
id |
+ Canonical Identifier | +
illustrator |
+ Creators | +
inDirection |
+ Direction | +
inker |
+ Creators | +
inLanguage |
+ Language | +
letterer |
+ Creators | +
link |
+ Links | +
name |
+ Title | +
penciler |
+ Creators | +
privacy-policy |
+ Privacy Policy | +
publisher |
+ Creators | +
readBy |
+ Creators | +
readingOrder |
+ Default Reading Order | +
readingProgression |
+ Reading Progression Direction | +
resourceList |
+ Resource List | +
translator |
+ Creators | +
url |
+ Address | +
The following are categorized as accessibility properties:
-The following infoset items are categorized as accessibility properties:
+accessModeaccessModeSufficientaccessibilityAPIaccessibilityControlaccessibilityFeatureaccessibilityHazardaccessibilitySummaryThe more detailed descriptions of these properties, as well as the possible values, are described + on the WebSchemas Wiki site.
-The more detailed descriptions of these properties, as well as the possible values, are - described on the WebSchemas Wiki - site.
+TBD
A Web Publication's address is a URL [[!url]] that - represents the primary entry page for the Web Publication.
+ represents the primary entry page for the Web Publication. It is expressed using the +url property.
A Web Publication's canonical identifier is a unique identifier that resolves to the preferred version of - the Web Publication.
+ the Web Publication. It is expressed using theid property.
Ensuring uniqueness of canonical identifiers is outside the scope of this specification. The actual achievable uniqueness depends on such factors as the conventions of @@ -1133,7 +1289,6 @@
A creator is an individual or entity responsible for the creation of the Web Publication. Creators are represented in one of the following two ways:
@@ -1148,27 +1303,27 @@name property is set to that string value. (See also .)
- The following properties are categorized as creators:
-The following infoset items are categorized as creators:
+artistauthorcontributorcreatoreditorillustratorinkerlettererpencilerpublisherreadBytranslatorA Web Publication MAY have more than one of each of these types of creators.
+The infoset MAY include more than one of each type of creator.
The Web Publication has a natural language value (e.g., English, French, Chinese), as well - as a natural base writing direction (left-to-right or right-to-left). The infoset has entries to set these values, which can - influence, for example, the behavior of a user agent (e.g., it might place a pop-up for a table - of contents on the right hand side for publications whose natural base direction is - right-to-left).
+ as a natural base writing direction (the display direction, either left-to-right or + right-to-left). The infoset has entries to set these + values, which can influence, for example, the behavior of a user agent (e.g., it might place a + pop-up for a table of contents on the right hand side for publications whose natural base + direction is right-to-left).Similarly, each natural language property value in the Web Publication's - infoset (e.g., title, infoset (e.g., title, creators) is localizable [[string-meta]], meaning that the same information is available for @@ -1398,11 +1553,12 @@
of both the Web Publication and the natural language properties values of the infoset.
+of both the Web Publication (inLanguage and inDirection) and the
+ natural language properties values of the infoset.
The last modification date is the date when the Web Publication was last updated (i.e., whenever changes were last made to any of the resources of the Web Publication, - including the manifest).
+ including the manifest). It is expressed using thedateModified
+ property.
The publication date is the date on which the Web Publication was originally published. It represents a static event in the lifecycle of a Web Publication and allows - subsequent revisions to be identified and compared.
+ subsequent revisions to be identified and compared. It is expressed using the +datePublished property.
The reading progression establishes the - reading direction from one resource to the next within a Web Publication.
+ reading direction from one resource to the next within a Web Publication. It is expressed + using thereadingDirection property.
The title provides the human-readable name of the Web Publication.
+The title provides the human-readable name of the Web Publication. It is expressed using
+ the name property.
The default reading order is a specific progression through a set of Web - Publication resources.
+ Publication resources. It is expressed using thereadingOrder property.
A user might follow alternative pathways through the content, but in the absence of such interaction the default reading order defines the expected progression from one resource to the @@ -1953,7 +2113,8 @@
The resource list enumerates any additional resources used in the processing and rendering of a Web Publication that are not already listed in the - default reading order.
+ default reading order. It is expressed using theresourceList
+ property.
The union of the resource list and default reading order represents the definitive list of resources that belong to the Web Publication. All other resources are external to the @@ -2056,11 +2217,13 @@
The links property provides a list of resources that are - not required for the processing and rendering of a Web Publication (i.e., the - content of the Web Publication remains unaffected even if these resources are not available). - Linked resources are typically made available to user agents to augment or enhance the - processing or rendering of it, such as:
+Links provide a list of resources that are not
+ required for the processing and rendering of a Web Publication (i.e., the content of the Web
+ Publication remains unaffected even if these resources are not available). They are expressed
+ using the link property.
Linked resources are typically made available to user agents to augment or enhance the processing + or rendering of it, such as:
The links property can also be used to identify resources that are used in the
- online rendering of a Web Publication, but that are not essential to include with it when it is
- taken offline or packaged (e.g., to minimize the size). These include:
Links can also be used to identify resources that are used in the online rendering of a Web + Publication, but that are not essential to include with it when it is taken offline or packaged + (e.g., to minimize the size). These include:
An accessibility report is identified using the
+ https://www.w3.org/ns/wp#accessibility-report link relationship.
A privacy policy is identified using the privacy-policy link relationship.
The cover is a resource that user agents can use to present the Web Publication - (e.g., in a library or bookshelf, or when initially loading the Web Publication).
+ (e.g., in a library or bookshelf, or when initially loading the Web Publication). It is + identified by thehttps://www.w3.org/ns/wp#cover link relationship.
The working group has not reached consensus on whether the cover should be any resource or should be limited to images.
@@ -2353,7 +2522,8 @@The table of contents property identifies the resource that contains the Web - Publication's table of contents.
+ Publication's table of contents. It is identified by the +contents link relationship.
undefined otherwisemanifest["name"] is undefined, then locate
+ manifest["name"] is undefined, then locate
the title HTML element [[!html]] using document. If that element
exists, let t be its text content, and add to manifest: