diff --git a/index.html b/index.html index 1170519..af3b97a 100644 --- a/index.html +++ b/index.html @@ -202,6 +202,13 @@

Terminology

and a default reading order.

+
Non-empty
+
+

For the purposes of this specification, non-empty is used to refer to an element, attribute or + property whose text content or value consists of one or more characters after whitespace + normalization, where whitespace normalization rules are defined per the host format.

+
+
Primary Resource

A primary resource is one that is presented directly by a user agent (i.e., not embedded within @@ -288,18 +295,18 @@

Requirements

The Web Publication infoset MUST include the following information:

In addition, the infoset SHOULD include the following information:

These requirements reflect the current minimum consensus, though a number of issues remain @@ -315,28 +322,32 @@

Requirements

-
+

Title

-

The Web Publication's infoset requires a title.

+

The title provides the human-readable name of the Web Publication.

-

If a title is not specified in the manifest, the user agent MUST provide one as - follows:

+

When specified in the manifest, the title MUST be non-empty.

-
    -
  1. If the Web Publication contains at least one primary resource whose media type includes a - title element (e.g., SVG or HTML), use the title of the first instance listed in the - default reading order.
    2. -
  2. If the preceding step results in an empty title, or no primary resources are recognized as having a - title, the user agent MUST use its own algorithm to produce a title (e.g., inspect subsequent primary - resources or provide a placeholder title).
    3. -
+ + +

If a user agent requires a title and one is not available in the compiled infoset, it MAY define one. This + specification does not mandate how such a title is created. The user agent might:

+ +
    +
  • use the first non-empty title element found in a primary resource in the default reading order;
    • +
  • provide a language-specific placeholder title (e.g., 'Untitled Publication');
    • +
  • use the URL of the manifest;
    • +
  • calculate a title using its own algorithm.
    • +
-

A user agent may not be able to produce a A user agent is not expected to produce a meaningful title [[WCAG20]] - for a Web Publication based on the above rules. Authors are encouraged to ensure that their manifest - contains such a title, or one is provided in one of the two steps above.

+ for a Web Publication when one is not specified.

@@ -348,22 +359,31 @@

Title

-
+

Language

-

The Web Publication's infoset requires the language(s) of its content be specified. The language MUST be a - tag that conforms to [[!BCP47]] or its successors.

+

The language specified in the Web Publication's infoset identifies the natural language of its + content.

-

If the language is not specified in the manifest, the user agent MUST provide one - as follows:

+

This language is not used in the processing or rendering of the Web Publication, and is + not a replacement for identifying the language of each resource as defined by its + format. It instead allows a user agent to ability to provide supplementary enhancements, such as the + ability to download a custom dictionary or the preload a language-specific text-to-speech module.

-
    -
  1. If the Web Publication contains at least one primary resource whose media type allows the language to - be specified (e.g., SVG or HTML), use the language of the first instance listed in the default - reading order.
    2. -
  2. If the preceding step results in an empty language tag, use the value "und" - (undetermined).
    3. -
+

When specified, the language MUST be a tag that conforms to [[!BCP47]] or its successors.

+ +

In the case of a multilingual Web Publication, the language declaration can be repeated.

+ +

If a user agent requires the language and one is not available in the compiled infoset, it MAY attempt to + determine the language. This specification does not mandate how such a language tag is created. The user + agent might:

+ +
    +
  • use the non-empty language declaration of the first primary resource in the default reading + order that provides one;
    • +
  • use the value "und" (undetermined);
    • +
  • calculate the language using its own algorithm.
    • +

The question is whether the manifest MUST include the language(s) of the content or not.

@@ -372,7 +392,7 @@

Language

-
+

Canonical Identifier

A Web Publication's canonical identifier is an identifier assigned to it by the publisher. @@ -386,7 +406,7 @@

Canonical Identifier

If assigned, this canonical identifier MUST be unique to the Web Publication.

-
+

Address

A Web Publication's address is a URL that refers to a Web Publication and enables the @@ -395,11 +415,11 @@

Address

The availability of this address does not preclude the creation and use of other identifiers and/or addresses to retrieve a representation of a Web Publication in whole or part.

-
The Web Publication's address can also be used as value for an - identifier link relation [[link-relation]].
+
The Web Publication's address can also be used as value for an identifier link relation + [[link-relation]].
-
+

Resources

The infoset MUST include a list of the primary resources of the Web Publication, regardless of @@ -417,13 +437,13 @@

Resources

resources or not.

-
+

Default Reading Order

The default reading order MUST include at least one primary resource.

-
+

Table of Contents

Placeholder for identifying table of contents - whether embedded or by reference.