From 6a336c850c9356e600de02da0e88f9374b3eb247 Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Thu, 14 Jan 2021 10:45:35 -0400 Subject: [PATCH 1/3] add section on resolving relative IRIs in the package document --- epub33/core/index.html | 6 +++--- epub33/rs/index.html | 18 ++++++++++++++++-- 2 files changed, 19 insertions(+), 5 deletions(-) diff --git a/epub33/core/index.html b/epub33/core/index.html index bbae40010..9bd6ee125 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -2521,9 +2521,9 @@
The item Element

Each item element identifies a Publication Resource by the IRI [[!RFC3987]] provided in its href attribute. The IRI MAY be absolute or - relative. In the case of relative IRIs, the IRI of the Package Document is used as the - base when resolving to absolute IRIs. The resulting absolute IRI MUST be unique within - the manifest scope.

+ relative, but each IRI MUST be unique within the manifest scope after resolution to an + absolute IRI [[!EPUB-RS-33]].

The Publication Resource identified by an item element MUST conform to the applicable specification(s) as inferred from the MIME media diff --git a/epub33/rs/index.html b/epub33/rs/index.html index a67530b22..26c85ed0c 100644 --- a/epub33/rs/index.html +++ b/epub33/rs/index.html @@ -306,6 +306,20 @@

Package Document Conformance

Package Document

+
+

Resolving Relative IRIs

+ +

Relative IRI references [[!RFC3987]] in the Package Document MUST be resolved to absolute IRI + references using the Base IRI [[!RFC3986]] of the Package Document.

+ +

The Base IRI of the Package Document is the combination of the Base IRI of the EPUB Container + together with the path to Package Document (relative to the Root Directory) when an EPUB + Publication is zipped.

+ +

This specification does not require a specific IRI scheme for referencing the path to the Package + Document within the EPUB Container.

+
+

Metadata

@@ -337,8 +351,8 @@

Metadata

The title element

Reading Systems MUST recognize the first title - element in document order as the main title of the EPUB Publication and present it - to users before other title elements.

+ element in document order as the main title of the EPUB Publication and present it to + users before other title elements.

This specification does not define how to process additional title elements.

From 28410b600984ca6d3b0e9de58608d9123146f00d Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Thu, 14 Jan 2021 12:44:37 -0400 Subject: [PATCH 2/3] add def link --- epub33/rs/index.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/epub33/rs/index.html b/epub33/rs/index.html index 26c85ed0c..caa888513 100644 --- a/epub33/rs/index.html +++ b/epub33/rs/index.html @@ -312,9 +312,9 @@

Resolving Relative IRIs

Relative IRI references [[!RFC3987]] in the Package Document MUST be resolved to absolute IRI references using the Base IRI [[!RFC3986]] of the Package Document.

-

The Base IRI of the Package Document is the combination of the Base IRI of the EPUB Container - together with the path to Package Document (relative to the Root Directory) when an EPUB - Publication is zipped.

+

The Base IRI of the Package Document is the combination of the Base IRI of the EPUB + Container together with the path to Package Document (relative to the Root + Directory) when an EPUB Publication is zipped.

This specification does not require a specific IRI scheme for referencing the path to the Package Document within the EPUB Container.

From f58bc8b8ad8716a47e13fcdb7de318d327f205ac Mon Sep 17 00:00:00 2001 From: Matt Garrish Date: Thu, 1 Apr 2021 17:40:35 -0300 Subject: [PATCH 3/3] clarify resolving relative references is not a requirement in all cases --- epub33/rs/index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/epub33/rs/index.html b/epub33/rs/index.html index caa888513..a0b1a74cd 100644 --- a/epub33/rs/index.html +++ b/epub33/rs/index.html @@ -309,8 +309,8 @@

Package Document

Resolving Relative IRIs

-

Relative IRI references [[!RFC3987]] in the Package Document MUST be resolved to absolute IRI - references using the Base IRI [[!RFC3986]] of the Package Document.

+

To obtain an absolute IRI reference from a relative IRI reference [[!RFC3987]] in the Package + Document, Reading Systems MUST use the Base IRI [[!RFC3986]] of the Package Document.

The Base IRI of the Package Document is the combination of the Base IRI of the EPUB Container together with the path to Package Document (relative to the Root