From 91f6a2ced20e80fce7a7319541c01e33f2a39ef8 Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Fri, 16 Dec 2022 18:39:22 -0400 Subject: [PATCH 1/6] add property for exempt resources --- epub33/core/index.html | 6 +++++ epub33/core/vocab/item-properties.html | 37 ++++++++++++++++++++++++++ 2 files changed, 43 insertions(+) diff --git a/epub33/core/index.html b/epub33/core/index.html index 780b43eef..72613cbdb 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -1247,6 +1247,12 @@

Exempt resources

resources (i.e., the requirement for a fallback for the foreign content document covers any rendering issues within it). As the resource is not referenced from an EPUB content document, it automatically becomes exempt from fallbacks.

+ +
+

Resources that fall under this latter exemption have to be identified in the manifest using the + exempt property on their [^item^] entry. Refer to + for more information.

+
diff --git a/epub33/core/vocab/item-properties.html b/epub33/core/vocab/item-properties.html index 71528e633..4f58d26a0 100644 --- a/epub33/core/vocab/item-properties.html +++ b/epub33/core/vocab/item-properties.html @@ -37,6 +37,43 @@

cover-image

+
+

data

+ + + + + + + + + + + + + + + + + + + + +
Name: + exempt +
Description: +

The exempt property indicates that the [=publication resource=] + is an [=exempt resource=] (e.g., is used as script input or is included in the + [=EPUB container=] for non-rendering purposes).

+

If [=EPUB creators=] do not set this property, acknowledging the resources are include by + design, reading systems and [=EPUB validators=] may flag the resources as unused if they + cannot find references to them.

+
Applies to:All publication resources that meet the exempt + resources condition that allows unreferenced resources.
Cardinality: + Zero or more +
+
+

mathml

From af9f41b28371dc5d8994ba86abf9c583baea388e Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Fri, 16 Dec 2022 19:36:03 -0400 Subject: [PATCH 2/6] fix broken terminology ref --- epub33/core/vocab/item-properties.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/epub33/core/vocab/item-properties.html b/epub33/core/vocab/item-properties.html index 4f58d26a0..6ae1689d3 100644 --- a/epub33/core/vocab/item-properties.html +++ b/epub33/core/vocab/item-properties.html @@ -54,9 +54,9 @@

data

The exempt property indicates that the [=publication resource=] is an [=exempt resource=] (e.g., is used as script input or is included in the [=EPUB container=] for non-rendering purposes).

-

If [=EPUB creators=] do not set this property, acknowledging the resources are include by - design, reading systems and [=EPUB validators=] may flag the resources as unused if they - cannot find references to them.

+

If [=EPUB creators=] do not set this property, acknowledging the resources are + include by design, reading systems and [=EPUB conformance checkers=] may flag the + resources as unused if they cannot find references to them.

From d1eeeb50f348baa150cd21ba01818813845d3a58 Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Fri, 16 Dec 2022 21:09:14 -0400 Subject: [PATCH 3/6] typo --- epub33/core/vocab/item-properties.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/epub33/core/vocab/item-properties.html b/epub33/core/vocab/item-properties.html index 6ae1689d3..8725f289d 100644 --- a/epub33/core/vocab/item-properties.html +++ b/epub33/core/vocab/item-properties.html @@ -38,7 +38,7 @@

cover-image

-

data

+

exempt

From d8cd549b295be5be30e12ec17514dffb8bd0f391 Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Fri, 16 Dec 2022 21:12:52 -0400 Subject: [PATCH 4/6] updated note --- epub33/core/index.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/epub33/core/index.html b/epub33/core/index.html index 72613cbdb..22d6fcf0c 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -1249,9 +1249,9 @@

Exempt resources

automatically becomes exempt from fallbacks.

-

Resources that fall under this latter exemption have to be identified in the manifest using the - exempt property on their [^item^] entry. Refer to - for more information.

+

Resources that fall under this latter exemption should be identified in the manifest using the + exempt property on their [^item^] entry to avoid their being flagged by EPUB conformance + checkers. Refer to for more information.

From 95039b5e15aa95670ef588cbb6656edadde597ea Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Fri, 16 Dec 2022 21:23:00 -0400 Subject: [PATCH 5/6] add usage recommendation --- epub33/core/index.html | 9 ++++++--- epub33/core/vocab/item-properties.html | 2 +- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/epub33/core/index.html b/epub33/core/index.html index 22d6fcf0c..71e72f53d 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -1247,11 +1247,11 @@

Exempt resources

resources (i.e., the requirement for a fallback for the foreign content document covers any rendering issues within it). As the resource is not referenced from an EPUB content document, it automatically becomes exempt from fallbacks.

- +

Resources that fall under this latter exemption should be identified in the manifest using the - exempt property on their [^item^] entry to avoid their being flagged by EPUB conformance - checkers. Refer to for more information.

+ exempt property on their [^item^] entry to avoid their being flagged by EPUB + conformance checkers. Refer to for more information.

@@ -4938,6 +4938,9 @@
Resource properties
  • switch
    • +

    EPUB creators SHOULD set the exempt property whenever a resource referenced by an + item element matches its definition.

    +