From f159dcd0e1f6c1847f10c64668a4a07b493c0440 Mon Sep 17 00:00:00 2001 From: Wendy Reid Date: Thu, 4 Jan 2024 13:11:18 -0500 Subject: [PATCH 01/14] webtoons proposed change to epub3.3 --- epub33/core/index.html | 333 +++++++++++++++++++++-------------------- 1 file changed, 172 insertions(+), 161 deletions(-) diff --git a/epub33/core/index.html b/epub33/core/index.html index 49ea77bb9..0af8499e3 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -7850,178 +7850,180 @@

Content document dimensions

-
-

Reflowable layouts

- -

Although control over the rendering of [=EPUB content documents=] to create fixed layouts is an obvious need not handled by other - technologies, there are also considerations for reflowable content that are unique to [=EPUB - publications=] (e.g., how to handle the flow of content in the [=viewport=]). This section defines - properties that allow [=EPUB creators=] to control presentation aspects of reflowable content.

+
-
-

The rendition:flow property

+
+ Proposed Correction 2 +

Evolution in the publishing industry has led us to re-examine how the rendition:flow property applies to EPUB content. Previously it was considered to only apply to reflowable EPUB content, but with the growth of content types like webtoons and comics, scrolled fixed layout content is increasingly popular and the EPUB specification should reflect that demand. This change moves rendition:flow out of the Reflowable layouts section and clarifies how the property might apply to both reflowable and pre-paginated EPUB content. For more information, please refer to issue 2412.

+
-

The rendition:flow property specifies the [=EPUB creator=] preference for how - [=reading systems=] should handle content overflow.

+

The rendition:flow property

 +

Layout rendering control

 -

When the rendition:flow property is - specified on a meta element, it indicates the EPUB creator's global preference for - overflow content handling (i.e., for all [=EPUB spine | spine=] items). EPUB creators MAY - indicate a preference for dynamic pagination or scrolling. For scrolled content, it is also - possible to specify whether consecutive [=EPUB content documents=] are to be rendered as a - continuous scrolling view or whether each is to be rendered separately (i.e., with a dynamic - page break between each).

+

The rendition:flow property specifies the [=EPUB creator=] preference for how + [=reading systems=] should handle content overflow.

-

EPUB creators MUST use one of the following values with the rendition:flow - property:

+

When the rendition:flow property is + specified on a meta element, it indicates the EPUB creator's global preference for + overflow content handling (i.e., for all [=EPUB spine | spine=] items). EPUB creators MAY + indicate a preference for dynamic pagination or scrolling. For scrolled content, it is also + possible to specify whether consecutive [=EPUB content documents=] are to be rendered as a + continuous scrolling view or whether each is to be rendered separately (i.e., with a dynamic + page break between each).

-
-
paginated
-
-

Dynamically paginate all overflow content.

-
+

EPUB creators MUST use one of the following values with the rendition:flow + property:

-
scrolled-continuous
-
-

Render all EPUB content documents such that overflow content is scrollable, and the - [=EPUB publication=] is presented as one continuous scroll from spine item to spine item - (except where locally overridden).

-

Note that EPUB creators SHOULD NOT create publications in which different resources have - different block flow directions, as continuous scrolled rendition in EPUB reading - systems would be problematic.

-
- -
scrolled-doc
-
-

Render all EPUB content documents such that overflow content is scrollable, and each - spine item is presented as a separate scrollable document.

-
- -
auto
-
-

Render overflow content using the reading system default method or a user preference, - whichever is applicable. Default value.

-
-
+
+
paginated
+
+

Dynamically paginate all overflow content.

+
-

Note that when two reflowable EPUB content documents occur - sequentially in the spine, the default rendering for their [[!html]] body elements is consistent with the page-break-before property [[!csssnapshot]] having been set to - always. In addition to using the rendition:flow property, EPUB - creators MAY override this behavior through an appropriate style sheet declaration, if the - reading system supports such overrides.

- -

EPUB creators MUST NOT declare the rendition:flow property more than once.

- -

They also MUST NOT declare the property using the refines - attribute. Refer to for setting the property for - individual EPUB content documents.

- -
-
Rendering of an EPUB publication with a single spine item, and with the - rendition:flow set to paginated.
- The continuous progression of paginated content produced for a single document. -
- -
- Image description -

Three column-like rectangles linked left-to-middle and middle-to-right with respective - arrows, with a text flowing from one rectangle to the next one. The text is sectioned with - headers figuring 'Chapter 1', '2', and '3'. The leftmost rectangle is enclosed in a - schematic view of a tablet.

-
- -
-
Rendering of an EPUB publication with multiple spine items, and with the - rendition:flow set to paginated.
- The continuous progression of paginated content produced for each document with transitions to - new pages between documents. -
- -
- Image description -

Three column-like rectangles linked left-to-middle and middle-to-right with respective - arrows, with a text flowing from one rectangle to the next one. The text is sectioned with - headers figuring 'Chapter 1', '2'. The section with 'Chapter 2' starts at the top of the - rightmost rectangle, leaving an empty space at the bottom of the middle rectangle. The - leftmost rectangle is enclosed in a schematic view of a tablet.

-
- -
-
Rendering of an EPUB publication with a single spine item, and with the - rendition:flow set to scrolled-continuous.
- The progression of a continuous scroll of content extends vertically off the user's screen, - with new documents added to the bottom as encountered. -
- -
- Image description -

A single, column-like strip (i.e., a rectangle without a bottom edge) with a text flowing - down the strip. The text is sectioned with headers figuring 'Chapter 1', '2'. The top part - of the strip is enclosed in a schematic view of a tablet.

-
- -
-
Rendering of an EPUB publication with multiple spine items, and with the - rendition:flow set to scrolled-doc.
- The progression of scrollable documents depicting how only the content within each document - is scrollable. -
- -
- Image description -

Three column-like strips (i.e., a rectangles without bottom edges) linked left-to-middle and - middle-to-right with respective arrows, each containing a text flowing down the strip. The - text is sectioned with headers figuring 'Chapter 1', '2' and '3'. Each strip starts with a - chapter header and flows down the strip. The top part of the leftmost strip is enclosed in a - schematic view of a tablet.

-
- -
-
Spine overrides
- -

[=EPUB creators=] MAY specify the following properties - locally on [=EPUB spine | spine=] [^itemref^] elements to override the global value for the given spine item:

+
scrolled-continuous
+
+

Render all EPUB content documents such that overflow content is scrollable, and the + [=EPUB publication=] is presented as one continuous scroll from spine item to spine item + (except where locally overridden).

+

Note that EPUB creators SHOULD NOT create publications in which different resources have + different block flow directions, as continuous scrolled rendition in EPUB reading + systems would be problematic.

+
-
-
rendition:flow-auto
-
Indicates no preference for overflow content handling by the EPUB creator.
+
scrolled-doc
+
+

Render all EPUB content documents such that overflow content is scrollable, and each + spine item is presented as a separate scrollable document.

+

Note that if this value is applied to an EPUB with a pre-paginated layout, it will render the same as if paginated was applied.

 +
-
rendition:flow-paginated
-
Indicates the EPUB creator preference is to dynamically paginate content overflow.
+
auto
+
+

Render overflow content using the reading system default method or a user preference, + whichever is applicable. Default value.

+
+
-
rendition:flow-scrolled-continuous
-
Indicates the EPUB creator preference is to provide a scrolled view for overflow - content, and that consecutive spine items with this property are to be rendered as a - continuous scroll.
+

Note that when two reflowable EPUB content documents occur + sequentially in the spine, the default rendering for their [[!html]] body elements is consistent with the page-break-before property [[!csssnapshot]] having been set to + always. In addition to using the rendition:flow property, EPUB + creators MAY override this behavior through an appropriate style sheet declaration, if the + reading system supports such overrides.

+ +

EPUB creators MUST NOT declare the rendition:flow property more than once.

+ +

They also MUST NOT declare the property using the refines + attribute. Refer to for setting the property for + individual EPUB content documents.

+ +
+
Rendering of an EPUB publication with a single spine item, and with the + rendition:flow set to paginated.
+ The continuous progression of paginated content produced for a single document. +
+ +
+ Image description +

Three column-like rectangles linked left-to-middle and middle-to-right with respective + arrows, with a text flowing from one rectangle to the next one. The text is sectioned with + headers figuring 'Chapter 1', '2', and '3'. The leftmost rectangle is enclosed in a + schematic view of a tablet.

+
+ +
+
Rendering of an EPUB publication with multiple spine items, and with the + rendition:flow set to paginated.
+ The continuous progression of paginated content produced for each document with transitions to + new pages between documents. +
+ +
+ Image description +

Three column-like rectangles linked left-to-middle and middle-to-right with respective + arrows, with a text flowing from one rectangle to the next one. The text is sectioned with + headers figuring 'Chapter 1', '2'. The section with 'Chapter 2' starts at the top of the + rightmost rectangle, leaving an empty space at the bottom of the middle rectangle. The + leftmost rectangle is enclosed in a schematic view of a tablet.

+
+ +
+
Rendering of an EPUB publication with a single spine item, and with the + rendition:flow set to scrolled-continuous.
+ The progression of a continuous scroll of content extends vertically off the user's screen, + with new documents added to the bottom as encountered. +
+ +
+ Image description +

A single, column-like strip (i.e., a rectangle without a bottom edge) with a text flowing + down the strip. The text is sectioned with headers figuring 'Chapter 1', '2'. The top part + of the strip is enclosed in a schematic view of a tablet.

+
+ +
+
Rendering of an EPUB publication with multiple spine items, and with the + rendition:flow set to scrolled-doc.
+ The progression of scrollable documents depicting how only the content within each document + is scrollable. +
+ +
+ Image description +

Three column-like strips (i.e., a rectangles without bottom edges) linked left-to-middle and + middle-to-right with respective arrows, each containing a text flowing down the strip. The + text is sectioned with headers figuring 'Chapter 1', '2' and '3'. Each strip starts with a + chapter header and flows down the strip. The top part of the leftmost strip is enclosed in a + schematic view of a tablet.

+
+ +
+
Spine overrides
 +

Spine overrides

 + +

[=EPUB creators=] MAY specify the following properties + locally on [=EPUB spine | spine=] [^itemref^] elements to override the global value for the given spine item:

-
rendition:flow-scrolled-doc
-
Indicates the EPUB creator preference is to provide a scrolled view for overflow - content, and each spine item with this property is to be rendered as a separate - scrollable document.
-
+
+
rendition:flow-auto
+
Indicates no preference for overflow content handling by the EPUB creator.
+ +
rendition:flow-paginated
+
Indicates the EPUB creator preference is to dynamically paginate content overflow.
+ +
rendition:flow-scrolled-continuous
+
Indicates the EPUB creator preference is to provide a scrolled view for overflow + content, and that consecutive spine items with this property are to be rendered as a + continuous scroll.
+ +
rendition:flow-scrolled-doc
+
Indicates the EPUB creator preference is to provide a scrolled view for overflow + content, and each spine item with this property is to be rendered as a separate + scrollable document. +

Note that if this value is applied to spine items within an EPUB with a pre-paginated layout, it will render the same as if paginated was applied.

 +
+
-

EPUB creators MUST NOT use more than one of these overrides on any given spine item.

+

EPUB creators MUST NOT use more than one of these overrides on any given spine item.

-
+
+
+ +
+

Reflowable layouts

+ +

Although control over the rendering of [=EPUB content documents=] to create fixed layouts is an obvious need not handled by other + technologies, there are also considerations for reflowable content that are unique to [=EPUB + publications=] (e.g., how to handle the flow of content in the [=viewport=]). This section defines + properties that allow [=EPUB creators=] to control presentation aspects of reflowable content.

The rendition:align-x-center property

From e395febb78dfc1417a7ec5076b4636bd2852708c Mon Sep 17 00:00:00 2001 From: Wendy Reid Date: Thu, 4 Jan 2024 13:21:35 -0500 Subject: [PATCH 02/14] proposed webtoon change to epub rs 3.3 --- epub33/rs/index.html | 121 +++++++++++++++++++++++-------------------- 1 file changed, 64 insertions(+), 57 deletions(-) diff --git a/epub33/rs/index.html b/epub33/rs/index.html index 237c64e21..03c992220 100644 --- a/epub33/rs/index.html +++ b/epub33/rs/index.html @@ -1729,73 +1729,80 @@

Viewport rendering

-
-

Reflowable layouts

+
-

[=Reading systems=] SHOULD process the reflowable layout properties [[epub-33]].

+
+ Proposed Correction 1 +

Evolution in the publishing industry has led us to re-examine how the rendition:flow property applies to EPUB content. Previously it was considered to only apply to reflowable EPUB content, but with the growth of content types like webtoons and comics, scrolled fixed layout content is increasingly popular and the EPUB specification should reflect that demand. This change moves rendition:flow out of the Reflowable layouts section and clarifies how the property might apply to both reflowable and pre-paginated EPUB content. This change will also change the normative statement regarding reading system behaviour for the rendition:flow property in fixed layout EPUB content. For more information, please refer to issue 2412.

+
-
-

The rendition:flow property

+

The rendition:flow property

 +

Layout rendering control

 -

If a reading system supports the specified rendering, it SHOULD use that method to handle - overflow content, but MAY provide the option for users to override the requested rendering.

+

If a reading system supports the specified rendering, it SHOULD use that method to handle + overflow content, but MAY provide the option for users to override the requested rendering.

-

The default global value is auto if no meta element carrying this - property occurs in the metadata - section [[epub-33]]. Reading systems MAY support only this default value.

+

The default global value is auto if no meta element carrying this + property occurs in the metadata + section [[epub-33]]. Reading systems MAY support only this default value.

-

The rendition:flow property values have the following processing requirements:

+

The rendition:flow property values have the following processing requirements:

-
-
paginated
-
-

The reading system SHOULD dynamically paginate all overflow content.

-
+
+
paginated
+
+

The reading system SHOULD dynamically paginate all overflow content.

+
-
scrolled-continuous
-
-

The reading system SHOULD render all [=EPUB content documents=] such that overflow - content is scrollable, and SHOULD present the [=EPUB publication=] as one continuous - scroll from spine item to spine item (except where locally overridden [[epub-33]]).

-
+
scrolled-continuous
+
+

The reading system SHOULD render all [=EPUB content documents=] such that overflow + content is scrollable, and SHOULD present the [=EPUB publication=] as one continuous + scroll from spine item to spine item (except where locally overridden [[epub-33]]).

+
-
scrolled-doc
-
-

The reading system SHOULD render all EPUB content documents such that users can scroll - overflow content, and SHOULD present each spine item as a separate scrollable - document.

-
+
scrolled-doc
+
+

The reading system SHOULD render all EPUB content documents such that users can scroll + overflow content, and SHOULD present each spine item as a separate scrollable + document.

+
-
auto
-
-

The reading system MAY render overflow content using its default method or a user - preference, whichever is applicable.

-
-
+
auto
+
+

The reading system MAY render overflow content using its default method or a user + preference, whichever is applicable.

+
+
-

For the rendition:flow-scrolled-continuous property, the scroll direction MUST be - defined relative to the block flow direction of the root element of the [=XHTML content - document=] referenced by the [^itemref^] element [[epub-33]]. The scroll direction MUST be - vertical if the block flow direction is downward (top-to-bottom). It MUST be horizontal if the - block flow direction of the root element is rightward (left-to-right) or leftward - (right-to-left).

- -

Reading systems MUST ignore the rendition:flow property and its overrides when - processing pre-paginated spine - items [[epub-33]].

- -

Reading system developers may decide to disregard this restriction, and accept the - scrolled-continuous value of rendition:flow as a switch to display - each pre-paginated spine item on a long, vertical strip (making it is easier to read on a - smartphone or computer). This type of presentation is often referred to as "webtoons". Some - publishers already use this possibility. After some further experimentation and incubation, a - future version of this specification may introduce this approach as a standard feature for - fixed-layout documents. See also the (deferred) github issue 2412.

-
+

For the rendition:flow-scrolled-continuous property, the scroll direction MUST be + defined relative to the block flow direction of the root element of the [=XHTML content + document=] referenced by the [^itemref^] element [[epub-33]]. The scroll direction MUST be + vertical if the block flow direction is downward (top-to-bottom). It MUST be horizontal if the + block flow direction of the root element is rightward (left-to-right) or leftward + (right-to-left).

+ +

Reading systems MUSTMAY ignore the rendition:flow property and its overrides when + processing pre-paginated spine + items [[epub-33]].

+ +

Reading system developers may decide to disregard this restriction, and accept the + scrolled-continuous value of rendition:flow as a switch to display + each pre-paginated spine item on a long, vertical strip (making it is easier to read on a + smartphone or computer). This type of presentation is often referred to as "webtoons". Some + publishers already use this possibility. After some further experimentation and incubation, a + future version of this specification may introduce this approach as a standard feature for + fixed-layout documents. See also the (deferred) github issue 2412.

+
+ +
+

Reflowable layouts

+ +

[=Reading systems=] SHOULD process the reflowable layout properties [[epub-33]].

The rendition:align-x-center property

From 9c1eb68831541ebed6a72f2c248c0db2fd14e83d Mon Sep 17 00:00:00 2001 From: Wendy Reid Date: Thu, 4 Jan 2024 13:26:24 -0500 Subject: [PATCH 03/14] fixing heading issue --- epub33/core/index.html | 6 +++--- epub33/rs/index.html | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/epub33/core/index.html b/epub33/core/index.html index 0af8499e3..61b76204b 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -7853,14 +7853,14 @@

Content document dimensions

+

The rendition:flow property

 +

Layout rendering control

 +
Proposed Correction 2

Evolution in the publishing industry has led us to re-examine how the rendition:flow property applies to EPUB content. Previously it was considered to only apply to reflowable EPUB content, but with the growth of content types like webtoons and comics, scrolled fixed layout content is increasingly popular and the EPUB specification should reflect that demand. This change moves rendition:flow out of the Reflowable layouts section and clarifies how the property might apply to both reflowable and pre-paginated EPUB content. For more information, please refer to issue 2412.

-

The rendition:flow property

 -

Layout rendering control

 -

The rendition:flow property specifies the [=EPUB creator=] preference for how [=reading systems=] should handle content overflow.

diff --git a/epub33/rs/index.html b/epub33/rs/index.html index 03c992220..00d9ffd73 100644 --- a/epub33/rs/index.html +++ b/epub33/rs/index.html @@ -1731,14 +1731,14 @@

Viewport rendering

+

The rendition:flow property

 +

Layout rendering control

 +
Proposed Correction 1

Evolution in the publishing industry has led us to re-examine how the rendition:flow property applies to EPUB content. Previously it was considered to only apply to reflowable EPUB content, but with the growth of content types like webtoons and comics, scrolled fixed layout content is increasingly popular and the EPUB specification should reflect that demand. This change moves rendition:flow out of the Reflowable layouts section and clarifies how the property might apply to both reflowable and pre-paginated EPUB content. This change will also change the normative statement regarding reading system behaviour for the rendition:flow property in fixed layout EPUB content. For more information, please refer to issue 2412.

-

The rendition:flow property

 -

Layout rendering control

 -

If a reading system supports the specified rendering, it SHOULD use that method to handle overflow content, but MAY provide the option for users to override the requested rendering.

From 3083f7544c1f83705e2861a7f6166b7516e1d08b Mon Sep 17 00:00:00 2001 From: Wendy Reid Date: Thu, 4 Jan 2024 13:30:49 -0500 Subject: [PATCH 04/14] cannot use del/ins on headings --- epub33/core/index.html | 3 +-- epub33/rs/index.html | 3 +-- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/epub33/core/index.html b/epub33/core/index.html index 61b76204b..1e9645abc 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -7853,8 +7853,7 @@

Content document dimensions

-

The rendition:flow property

 -

Layout rendering control

 +

Layout rendering control

Proposed Correction 2 diff --git a/epub33/rs/index.html b/epub33/rs/index.html index 00d9ffd73..1a0529c68 100644 --- a/epub33/rs/index.html +++ b/epub33/rs/index.html @@ -1731,8 +1731,7 @@

Viewport rendering

-

The rendition:flow property

 -

Layout rendering control

 +

Layout rendering control

Proposed Correction 1 From 8bcd6c6a7445176629cedf610fde4016ead3cb9d Mon Sep 17 00:00:00 2001 From: Wendy Reid Date: Thu, 4 Jan 2024 14:19:38 -0500 Subject: [PATCH 05/14] fixing change number --- epub33/core/index.html | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/epub33/core/index.html b/epub33/core/index.html index 1e9645abc..cc440c31a 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -7855,7 +7855,7 @@

Content document dimensions

Layout rendering control

-
+
Proposed Correction 2

Evolution in the publishing industry has led us to re-examine how the rendition:flow property applies to EPUB content. Previously it was considered to only apply to reflowable EPUB content, but with the growth of content types like webtoons and comics, scrolled fixed layout content is increasingly popular and the EPUB specification should reflect that demand. This change moves rendition:flow out of the Reflowable layouts section and clarifies how the property might apply to both reflowable and pre-paginated EPUB content. For more information, please refer to issue 2412.

@@ -7894,7 +7894,7 @@

Layout rendering control

Render all EPUB content documents such that overflow content is scrollable, and each spine item is presented as a separate scrollable document.

-

Note that if this value is applied to an EPUB with a pre-paginated layout, it will render the same as if paginated was applied.

 +

Note that if this value is applied to an EPUB with a pre-paginated layout, it will render the same as if paginated was applied.
auto
@@ -7989,8 +7989,7 @@

Layout rendering control

-
Spine overrides
 -

Spine overrides

 +

Spine overrides

[=EPUB creators=] MAY specify the following properties locally on [=EPUB spine | spine=] [^itemref^] elements to override the Layout rendering control

Indicates the EPUB creator preference is to provide a scrolled view for overflow content, and each spine item with this property is to be rendered as a separate scrollable document. -

Note that if this value is applied to spine items within an EPUB with a pre-paginated layout, it will render the same as if paginated was applied.

 +

Note that if this value is applied to spine items within an EPUB with a pre-paginated layout, it will render the same as if paginated was applied.
From fe938e0112664163fedc09d66e94ced99004aaa6 Mon Sep 17 00:00:00 2001 From: Wendy Reid Date: Fri, 5 Jan 2024 11:42:17 -0500 Subject: [PATCH 06/14] restructuring headings and fixing change number --- epub33/core/index.html | 77 ++++++++++++++++++++++-------------------- 1 file changed, 41 insertions(+), 36 deletions(-) diff --git a/epub33/core/index.html b/epub33/core/index.html index cc440c31a..e1a828cf9 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -7850,16 +7850,20 @@

Content document dimensions

-
+
-

Layout rendering control

+

Layout-independent settings

-
- Proposed Correction 2 + +
+ +

The rendition:flow property

+

The rendition:flow property specifies the [=EPUB creator=] preference for how [=reading systems=] should handle content overflow.

@@ -7894,7 +7898,7 @@

Layout rendering control

Render all EPUB content documents such that overflow content is scrollable, and each spine item is presented as a separate scrollable document.

-

Note that if this value is applied to an EPUB with a pre-paginated layout, it will render the same as if paginated was applied.

 +

Note that if this value is applied to an EPUB with a pre-paginated layout, it will render the same as if paginated was applied.
auto
@@ -7987,41 +7991,41 @@

Layout rendering control

schematic view of a tablet.

-
-

Spine overrides

+
+
Spine overrides
-

[=EPUB creators=] MAY specify the following properties - locally on [=EPUB spine | spine=] [^itemref^] elements to override the global value for the given spine item:

+

[=EPUB creators=] MAY specify the following properties + locally on [=EPUB spine | spine=] [^itemref^] elements to override the global value for the given spine item:

-
-
rendition:flow-auto
-
Indicates no preference for overflow content handling by the EPUB creator.
- -
rendition:flow-paginated
-
Indicates the EPUB creator preference is to dynamically paginate content overflow.
- -
rendition:flow-scrolled-continuous
-
Indicates the EPUB creator preference is to provide a scrolled view for overflow - content, and that consecutive spine items with this property are to be rendered as a - continuous scroll.
- -
rendition:flow-scrolled-doc
-
Indicates the EPUB creator preference is to provide a scrolled view for overflow - content, and each spine item with this property is to be rendered as a separate - scrollable document. -

Note that if this value is applied to spine items within an EPUB with a pre-paginated layout, it will render the same as if paginated was applied.

 -
-
+
+
rendition:flow-auto
+
Indicates no preference for overflow content handling by the EPUB creator.
+ +
rendition:flow-paginated
+
Indicates the EPUB creator preference is to dynamically paginate content overflow.
+ +
rendition:flow-scrolled-continuous
+
Indicates the EPUB creator preference is to provide a scrolled view for overflow + content, and that consecutive spine items with this property are to be rendered as a + continuous scroll.
+ +
rendition:flow-scrolled-doc
+
Indicates the EPUB creator preference is to provide a scrolled view for overflow + content, and each spine item with this property is to be rendered as a separate + scrollable document. +

Note that if this value is applied to spine items within an EPUB with a pre-paginated layout, it will render the same as if paginated was applied.

 +
+
-

EPUB creators MUST NOT use more than one of these overrides on any given spine item.

+

EPUB creators MUST NOT use more than one of these overrides on any given spine item.

- + +
From 19feb783a2a1e2ef5e88bc016c626b1b938739f0 Mon Sep 17 00:00:00 2001 From: Wendy Reid Date: Fri, 5 Jan 2024 11:48:12 -0500 Subject: [PATCH 07/14] restructuring headings rs version --- epub33/rs/index.html | 109 ++++++++++++++++++++++--------------------- 1 file changed, 57 insertions(+), 52 deletions(-) diff --git a/epub33/rs/index.html b/epub33/rs/index.html index 1a0529c68..41f027969 100644 --- a/epub33/rs/index.html +++ b/epub33/rs/index.html @@ -1729,72 +1729,77 @@

Viewport rendering

-
+
-

Layout rendering control

+

Layout-independent settings

Proposed Correction 1

Evolution in the publishing industry has led us to re-examine how the rendition:flow property applies to EPUB content. Previously it was considered to only apply to reflowable EPUB content, but with the growth of content types like webtoons and comics, scrolled fixed layout content is increasingly popular and the EPUB specification should reflect that demand. This change moves rendition:flow out of the Reflowable layouts section and clarifies how the property might apply to both reflowable and pre-paginated EPUB content. This change will also change the normative statement regarding reading system behaviour for the rendition:flow property in fixed layout EPUB content. For more information, please refer to issue 2412.

-

If a reading system supports the specified rendering, it SHOULD use that method to handle - overflow content, but MAY provide the option for users to override the requested rendering.

+
-

The default global value is auto if no meta element carrying this - property occurs in the metadata - section [[epub-33]]. Reading systems MAY support only this default value.

+

The rendition:flow property

-

The rendition:flow property values have the following processing requirements:

+

If a reading system supports the specified rendering, it SHOULD use that method to handle + overflow content, but MAY provide the option for users to override the requested rendering.

-
-
paginated
-
-

The reading system SHOULD dynamically paginate all overflow content.

-
+

The default global value is auto if no meta element carrying this + property occurs in the metadata + section [[epub-33]]. Reading systems MAY support only this default value.

-
scrolled-continuous
-
-

The reading system SHOULD render all [=EPUB content documents=] such that overflow - content is scrollable, and SHOULD present the [=EPUB publication=] as one continuous - scroll from spine item to spine item (except where locally overridden [[epub-33]]).

-
+

The rendition:flow property values have the following processing requirements:

-
scrolled-doc
-
-

The reading system SHOULD render all EPUB content documents such that users can scroll - overflow content, and SHOULD present each spine item as a separate scrollable - document.

-
+
+
paginated
+
+

The reading system SHOULD dynamically paginate all overflow content.

+
-
auto
-
-

The reading system MAY render overflow content using its default method or a user - preference, whichever is applicable.

-
-
+
scrolled-continuous
+
+

The reading system SHOULD render all [=EPUB content documents=] such that overflow + content is scrollable, and SHOULD present the [=EPUB publication=] as one continuous + scroll from spine item to spine item (except where locally overridden [[epub-33]]).

+
-

For the rendition:flow-scrolled-continuous property, the scroll direction MUST be - defined relative to the block flow direction of the root element of the [=XHTML content - document=] referenced by the [^itemref^] element [[epub-33]]. The scroll direction MUST be - vertical if the block flow direction is downward (top-to-bottom). It MUST be horizontal if the - block flow direction of the root element is rightward (left-to-right) or leftward - (right-to-left).

- -

Reading systems MUSTMAY ignore the rendition:flow property and its overrides when - processing pre-paginated spine - items [[epub-33]].

- -

Reading system developers may decide to disregard this restriction, and accept the - scrolled-continuous value of rendition:flow as a switch to display - each pre-paginated spine item on a long, vertical strip (making it is easier to read on a - smartphone or computer). This type of presentation is often referred to as "webtoons". Some - publishers already use this possibility. After some further experimentation and incubation, a - future version of this specification may introduce this approach as a standard feature for - fixed-layout documents. See also the (deferred) github issue 2412.

+
scrolled-doc
+
+

The reading system SHOULD render all EPUB content documents such that users can scroll + overflow content, and SHOULD present each spine item as a separate scrollable + document.

+
+ +
auto
+
+

The reading system MAY render overflow content using its default method or a user + preference, whichever is applicable.

+
+
+ +

For the rendition:flow-scrolled-continuous property, the scroll direction MUST be + defined relative to the block flow direction of the root element of the [=XHTML content + document=] referenced by the [^itemref^] element [[epub-33]]. The scroll direction MUST be + vertical if the block flow direction is downward (top-to-bottom). It MUST be horizontal if the + block flow direction of the root element is rightward (left-to-right) or leftward + (right-to-left).

+ +

Reading systems MUSTMAY ignore the rendition:flow property and its overrides when + processing pre-paginated spine + items [[epub-33]].

+ +

Reading system developers may decide to disregard this restriction, and accept the + scrolled-continuous value of rendition:flow as a switch to display + each pre-paginated spine item on a long, vertical strip (making it is easier to read on a + smartphone or computer). This type of presentation is often referred to as "webtoons". Some + publishers already use this possibility. After some further experimentation and incubation, a + future version of this specification may introduce this approach as a standard feature for + fixed-layout documents. See also the (deferred) github issue 2412.

+
From b7433ba8b1745bcacfcb9f0e9f5429f50acde45b Mon Sep 17 00:00:00 2001 From: Wendy Reid Date: Mon, 8 Jan 2024 16:21:01 -0500 Subject: [PATCH 08/14] adding images and figures for the three main cases --- ...rendering_FXL_paginated_multiple_spine.svg | 1 + ...mple_rendering_FXL_scrolled_continuous.svg | 1 + .../example_rendering_FXL_scrolled_doc.svg | 1 + epub33/core/index.html | 40 ++++++++++++++++++- 4 files changed, 41 insertions(+), 2 deletions(-) create mode 100644 epub33/core/images/example_rendering_FXL_paginated_multiple_spine.svg create mode 100644 epub33/core/images/example_rendering_FXL_scrolled_continuous.svg create mode 100644 epub33/core/images/example_rendering_FXL_scrolled_doc.svg diff --git a/epub33/core/images/example_rendering_FXL_paginated_multiple_spine.svg b/epub33/core/images/example_rendering_FXL_paginated_multiple_spine.svg new file mode 100644 index 000000000..5fbbe5aed --- /dev/null +++ b/epub33/core/images/example_rendering_FXL_paginated_multiple_spine.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/epub33/core/images/example_rendering_FXL_scrolled_continuous.svg b/epub33/core/images/example_rendering_FXL_scrolled_continuous.svg new file mode 100644 index 000000000..cc5a4633c --- /dev/null +++ b/epub33/core/images/example_rendering_FXL_scrolled_continuous.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/epub33/core/images/example_rendering_FXL_scrolled_doc.svg b/epub33/core/images/example_rendering_FXL_scrolled_doc.svg new file mode 100644 index 000000000..5fbbe5aed --- /dev/null +++ b/epub33/core/images/example_rendering_FXL_scrolled_doc.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/epub33/core/index.html b/epub33/core/index.html index e1a828cf9..c6af4881d 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -7924,7 +7924,7 @@

The rendition:flow property

individual EPUB content documents.

-
Rendering of an EPUB publication with a single spine item, and with the +
Rendering of a reflowable EPUB publication with a single spine item, and with the rendition:flow set to paginated.
The rendition:flow property
-
Rendering of an EPUB publication with multiple spine items, and with the +
Rendering of a reflowable EPUB publication with multiple spine items, and with the rendition:flow set to paginated.
The rendition:flow property leftmost rectangle is enclosed in a schematic view of a tablet.

+
+
Rendering of a fixed layout EPUB publication with multiple spine items, and with the rendition:flow set to paginated.
+ The continuous progression of paginated content with transitions to new pages between spine items. +
+ +
+ Image description +

Three rectangles linked left-to-middle and middle-to-right with respective arrows, representing three spine items or pages in an EPUB document. Each page is styled like a comic, with segemented boxes within the rectangle. Each rectangle fills the screen of the schematic view of a tablet.

+
+
Rendering of an EPUB publication with a single spine item, and with the rendition:flow set to scrolled-continuous.
@@ -7973,6 +7985,18 @@

The rendition:flow property

of the strip is enclosed in a schematic view of a tablet.

+
+
Rendering of a fixed layout EPUB publication with multiple spine items, and with the rendition:flow set to scrolled-continuous.
+ The progression of a continuous scroll of content extends vertically off the user's screen, with new documents following without gaps. +
+ +
+ Image description +

A single, column-like strip (i.e. a rectangle without a bottom edge) with multiple comic pages flowing down the strip. The content is segmented by the page boundaries, but there are no gaps between the pages. The top part of the strip is enclosed in a schematic view of a tablet.

+
+
Rendering of an EPUB publication with multiple spine items, and with the rendition:flow set to scrolled-doc.
@@ -7991,6 +8015,18 @@

The rendition:flow property

schematic view of a tablet.

+
+
Rendering of a fixed layout EPUB publication with multiple spine items, and with the rendition:flow set to scrolled-doc.
+ The continuous progression of content with transitions to new pages between spine items. +
+ +
+ Image description +

Three rectangles linked left-to-middle and middle-to-right with respective arrows, representing three spine items or pages in an EPUB document. Each page is styled like a comic, with segemented boxes within the rectangle. Each rectangle fills the screen of the schematic view of a tablet.

+
+
Spine overrides
From 35d3dcd48f2377c73cbb9d73425fb365233bdae8 Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Wed, 10 Jan 2024 09:51:47 +0100 Subject: [PATCH 09/14] Changed the SVG image for FXL, and modified the alt texts --- ...rendering_FXL_paginated_multiple_spine.svg | 87 ++++++++++++++++++- ...mple_rendering_FXL_scrolled_continuous.svg | 62 ++++++++++++- .../example_rendering_FXL_scrolled_doc.svg | 87 ++++++++++++++++++- epub33/core/index.html | 34 ++++++-- 4 files changed, 258 insertions(+), 12 deletions(-) diff --git a/epub33/core/images/example_rendering_FXL_paginated_multiple_spine.svg b/epub33/core/images/example_rendering_FXL_paginated_multiple_spine.svg index 5fbbe5aed..301e06297 100644 --- a/epub33/core/images/example_rendering_FXL_paginated_multiple_spine.svg +++ b/epub33/core/images/example_rendering_FXL_paginated_multiple_spine.svg @@ -1 +1,86 @@ - \ No newline at end of file + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/epub33/core/images/example_rendering_FXL_scrolled_continuous.svg b/epub33/core/images/example_rendering_FXL_scrolled_continuous.svg index cc5a4633c..6edc7b741 100644 --- a/epub33/core/images/example_rendering_FXL_scrolled_continuous.svg +++ b/epub33/core/images/example_rendering_FXL_scrolled_continuous.svg @@ -1 +1,61 @@ - \ No newline at end of file + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/epub33/core/images/example_rendering_FXL_scrolled_doc.svg b/epub33/core/images/example_rendering_FXL_scrolled_doc.svg index 5fbbe5aed..301e06297 100644 --- a/epub33/core/images/example_rendering_FXL_scrolled_doc.svg +++ b/epub33/core/images/example_rendering_FXL_scrolled_doc.svg @@ -1 +1,86 @@ - \ No newline at end of file + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/epub33/core/index.html b/epub33/core/index.html index c6af4881d..5dc8a8050 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -7958,15 +7958,22 @@

The rendition:flow property

-
Rendering of a fixed layout EPUB publication with multiple spine items, and with the rendition:flow set to paginated.
- Rendering of a fixed layout EPUB publication with multiple spine items, and with the rendition:flow set to + paginated. +
(Comics courtesy of xkcd, + licensed under cc by-nc 2.5.) + +
+ The continuous progression of paginated content with transitions to new pages between spine items.
Image description -

Three rectangles linked left-to-middle and middle-to-right with respective arrows, representing three spine items or pages in an EPUB document. Each page is styled like a comic, with segemented boxes within the rectangle. Each rectangle fills the screen of the schematic view of a tablet.

+

Three rectangles linked left-to-middle and middle-to-right with respective arrows, representing three spine items or pages in an EPUB document. + Each page is one piece of a comics. Each rectangle fills the screen of the schematic view of a tablet.

@@ -7986,8 +7993,12 @@

The rendition:flow property

-
Rendering of a fixed layout EPUB publication with multiple spine items, and with the rendition:flow set to scrolled-continuous.
- Rendering of a fixed layout EPUB publication with multiple spine items, and with the + rendition:flow set to scrolled-continuous. +
(Comics courtesy of xkcd, + licensed under cc by-nc 2.5.) +
+ The progression of a continuous scroll of content extends vertically off the user's screen, with new documents following without gaps.
@@ -8016,15 +8027,20 @@

The rendition:flow property

-
Rendering of a fixed layout EPUB publication with multiple spine items, and with the rendition:flow set to scrolled-doc.
- Rendering of a fixed layout EPUB publication with multiple spine items, and with the rendition:flow set to + scrolled-doc. +
(Comics courtesy of xkcd, licensed under + cc by-nc 2.5.) + + The continuous progression of content with transitions to new pages between spine items. + alt="The continuous progression of content with transitions to new pages between pages in a document." />
Image description -

Three rectangles linked left-to-middle and middle-to-right with respective arrows, representing three spine items or pages in an EPUB document. Each page is styled like a comic, with segemented boxes within the rectangle. Each rectangle fills the screen of the schematic view of a tablet.

+

Three rectangles linked left-to-middle and middle-to-right with respective arrows, representing three pages in an EPUB document. + Each page is one piece of a comics. Each rectangle fills the screen of the schematic view of a tablet.

Date: Wed, 10 Jan 2024 09:55:11 +0100 Subject: [PATCH 10/14] Added the references of the new figures to the readme file --- epub33/core/images/readme.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/epub33/core/images/readme.md b/epub33/core/images/readme.md index 82ff11229..e9256b9c6 100644 --- a/epub33/core/images/readme.md +++ b/epub33/core/images/readme.md @@ -11,6 +11,11 @@ Here is the link to the individual files: - [example_spread_landscape.svg](https://docs.google.com/drawings/d/1d1Q-pjutZFl09FSx-P5Hl_TswiiuW_jTX4lqv47PVfQ/edit?usp=drive_link) - [example_spread_none.svg](https://docs.google.com/drawings/d/1uJVY_IkZwWiz3Tux3WfqStfA8cNTbF4jBzHFz84ir7A/edit?usp=drive_link) - [example_spread_page_spread_right.svg](https://docs.google.com/drawings/d/1rTwzPcksrs0xPMQPIh3bAMkkt9zV9XUChzCJ2pWjnF8/edit?usp=drive_link) +- [example_rendering_FXL_paginated_multiple_spine.svg](https://docs.google.com/drawings/d/13vh7wpr11bddJ-HilCq04WnkaRbr_ixaAPzx2YN0wtI/edit?usp=sharing) +- [example_rendering_FXL_scrolled_doc.svg](https://docs.google.com/drawings/d/1QP_Iea9-_e60qqz1sbLfQ9AMEFRhCBi2qUMqYNJwjgg/edit?usp=sharing) +- [example_rendering_FXL_scrolled_continuous.svg](https://docs.google.com/drawings/d/1EE98CX1LuAQcTIXe5JMSahU-TwgWXeOmADppe5_48mc/edit?usp=sharing) + + All files should be publicly visible and can be commented upon. If there is any access issue, please contact [Ivan Herman](ivan@w3.org). From 8cf41a1ba8b55d182446b987e53a643c91aa5c48 Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Wed, 10 Jan 2024 10:03:34 +0100 Subject: [PATCH 11/14] Added the references to the image folder's readme file --- epub33/core/images/readme.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/epub33/core/images/readme.md b/epub33/core/images/readme.md index e9256b9c6..341929e34 100644 --- a/epub33/core/images/readme.md +++ b/epub33/core/images/readme.md @@ -16,9 +16,15 @@ Here is the link to the individual files: - [example_rendering_FXL_scrolled_continuous.svg](https://docs.google.com/drawings/d/1EE98CX1LuAQcTIXe5JMSahU-TwgWXeOmADppe5_48mc/edit?usp=sharing) - - All files should be publicly visible and can be commented upon. If there is any access issue, please contact [Ivan Herman](ivan@w3.org). +The workflow for adding these to the document is as follows: + +- Create/modify the drawing on Google Doc +- Export the content into SVG +- Modify the SVG file: + - The `viewBox` attribute should be modified to make it as close to the "real" content as possible, otherwise too much empty space is left in the final document. Unfortunately, this is pretty much a trial-and-error process. (A good trick: add, temporarily, a `` at the very beginning of the file and then play with the rectangle dimension to find the smallest enclosing rectangle for the content. That will set the final `viewBox` values.) + - If your editor has a formatting possibility it may be useful to run it; it may help others to possibly consult the SVG content +- Add a reference via an `` element to the SVG file. The `width` argument may have to be modified to make the drawing appear on a proper size in the document. From c00da9c9b59368daabea71fe78c54aa323f2f068 Mon Sep 17 00:00:00 2001 From: Wendy Reid Date: Thu, 11 Jan 2024 10:46:34 -0500 Subject: [PATCH 12/14] wrapping new diagrams with ins --- epub33/core/index.html | 104 ++++++++++++++++++++++------------------- 1 file changed, 55 insertions(+), 49 deletions(-) diff --git a/epub33/core/index.html b/epub33/core/index.html index 5dc8a8050..97674f4dc 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -7957,24 +7957,26 @@

The rendition:flow property

leftmost rectangle is enclosed in a schematic view of a tablet.

-
-
Rendering of a fixed layout EPUB publication with multiple spine items, and with the rendition:flow set to - paginated. -
(Comics courtesy of xkcd, - licensed under cc by-nc 2.5.) - -
- The continuous progression of paginated content with transitions to new pages between spine items. -
- -
- Image description -

Three rectangles linked left-to-middle and middle-to-right with respective arrows, representing three spine items or pages in an EPUB document. - Each page is one piece of a comics. Each rectangle fills the screen of the schematic view of a tablet.

-
+ +
+
Rendering of a fixed layout EPUB publication with multiple spine items, and with the rendition:flow set to + paginated. +
(Comics courtesy of xkcd, + licensed under cc by-nc 2.5.) + +
+ The continuous progression of paginated content with transitions to new pages between spine items. +
+ +
+ Image description +

Three rectangles linked left-to-middle and middle-to-right with respective arrows, representing three spine items or pages in an EPUB document. + Each page is one piece of a comics. Each rectangle fills the screen of the schematic view of a tablet.

+
+
Rendering of an EPUB publication with a single spine item, and with the @@ -7992,21 +7994,23 @@

The rendition:flow property

of the strip is enclosed in a schematic view of a tablet.

-
-
Rendering of a fixed layout EPUB publication with multiple spine items, and with the - rendition:flow set to scrolled-continuous. -
(Comics courtesy of xkcd, - licensed under cc by-nc 2.5.) -
- The progression of a continuous scroll of content extends vertically off the user's screen, with new documents following without gaps. -
- -
- Image description -

A single, column-like strip (i.e. a rectangle without a bottom edge) with multiple comic pages flowing down the strip. The content is segmented by the page boundaries, but there are no gaps between the pages. The top part of the strip is enclosed in a schematic view of a tablet.

-
+ +
+
Rendering of a fixed layout EPUB publication with multiple spine items, and with the + rendition:flow set to scrolled-continuous. +
(Comics courtesy of xkcd, + licensed under cc by-nc 2.5.) +
+ The progression of a continuous scroll of content extends vertically off the user's screen, with new documents following without gaps. +
+ +
+ Image description +

A single, column-like strip (i.e. a rectangle without a bottom edge) with multiple comic pages flowing down the strip. The content is segmented by the page boundaries, but there are no gaps between the pages. The top part of the strip is enclosed in a schematic view of a tablet.

+
+
Rendering of an EPUB publication with multiple spine items, and with the @@ -8026,22 +8030,24 @@

The rendition:flow property

schematic view of a tablet.

-
-
Rendering of a fixed layout EPUB publication with multiple spine items, and with the rendition:flow set to - scrolled-doc. -
(Comics courtesy of xkcd, licensed under - cc by-nc 2.5.) -
- The continuous progression of content with transitions to new pages between pages in a document. -
- -
- Image description -

Three rectangles linked left-to-middle and middle-to-right with respective arrows, representing three pages in an EPUB document. - Each page is one piece of a comics. Each rectangle fills the screen of the schematic view of a tablet.

-
+ +
+
Rendering of a fixed layout EPUB publication with multiple spine items, and with the rendition:flow set to + scrolled-doc. +
(Comics courtesy of xkcd, licensed under + cc by-nc 2.5.) +
+ The continuous progression of content with transitions to new pages between pages in a document. +
+ +
+ Image description +

Three rectangles linked left-to-middle and middle-to-right with respective arrows, representing three pages in an EPUB document. + Each page is one piece of a comics. Each rectangle fills the screen of the schematic view of a tablet.

+
+
From fdff8a4e98b24e0cd8ec113794165545a73c3c74 Mon Sep 17 00:00:00 2001 From: Wendy Reid Date: Thu, 11 Jan 2024 10:56:43 -0500 Subject: [PATCH 13/14] updating changelogs with placeholders --- epub33/core/index.html | 1 + epub33/rs/index.html | 4 +--- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/epub33/core/index.html b/epub33/core/index.html index 97674f4dc..c23d6fdc8 100644 --- a/epub33/core/index.html +++ b/epub33/core/index.html @@ -12055,6 +12055,7 @@

Change log

Substantive changes since the Recommendation of 2023-05-25