From fde488e7bd4c9b4b4ede67de4c768227053a3b63 Mon Sep 17 00:00:00 2001 From: wareid Date: Mon, 21 Oct 2024 10:13:20 -0400 Subject: [PATCH 1/4] reading order improvements --- epub33/fxl-a11y/index.html | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/epub33/fxl-a11y/index.html b/epub33/fxl-a11y/index.html index cab99a1a4..1cc9bbff5 100644 --- a/epub33/fxl-a11y/index.html +++ b/epub33/fxl-a11y/index.html @@ -192,6 +192,8 @@

Reading order

A key concept of EPUB is that an EPUB publication consists of multiple resources that can be completely navigated and consumed by a person or program in some specific order. - 1.2.1 Reading Order EPUB 3.3 Overview [[epub-overview-33]]
+

Reading order in EPUB refers to the order of content documents in the spine section of the Package document. However, the concept of reading order is also an important consideration for accessibility and refers to the visual and programmatic order of elements in a content document. In both EPUB and accessibility usage, reading order must be logical and accurate both visually and programmatically.

+

Whereas many reflowable publications have an obvious reading order, or logical progression through their content, fixed layout publications are often more complex in their design and layout and may consist of multiple readable objects on the same page.

For viewers of the visual page, the reading order can be inferred by various visual triggers including:

@@ -224,12 +226,14 @@

Altering the reading order

If a blind user, who reads the page with a screen reader that follows the source order, is working with a sighted user who reads the page in visual order, they may be confused when they encounter information in different orders. A user with low vision who uses a screen magnifier in combination with a screen reader may be confused when the reading order appears to skip around on the screen. A keyboard user may have trouble predicting where focus will go next when the source order does not match the visual order. - Making the DOM order match the visual order
+

EPUB authors need to be mindful of how the reading order of a page is presented both visually and programmatically to readers. The DOM order, or programmatic order, refers to the order of elements in the source code for a content document. As much as possible, the programmatic order of a page should match its visual order.

+

Removing items from the reading order

-

There may be cases when text appears on the page but is unnecessary, duplicated or otherwise confusing for it to be added to the reading order, e.g. page numbers, running headers and footers, or text used for visual effects.

+

There may be cases when text appears on the page but is unnecessary, duplicated or otherwise confusing for it to be added to the programmatic reading order, e.g. page numbers, running headers and footers, or text used for visual effects.

See the techniques document for guidance on how to apply this recommendation.

@@ -237,7 +241,7 @@

Removing items from the reading order

Reading order across the 'fold'

-

Fixed layout documents can be presented as synthetic spreads where two pages are arranged side-by-side. As each page of the fixed layout document is a separate XHTML document, it is expected that the reading order of the EPUB flows from one page to the next. Even if the content is presented in a synthetic spread, the reading order should not require that the reader move between pages to read the content in order.

+

Fixed layout documents can be presented as synthetic spreads where two pages are arranged side-by-side. As each page of the fixed layout document is a separate XHTML document, it is expected that the reading order of the EPUB flows from one page to the next. Even if the content is presented in a synthetic spread, the reading order should not require that the reader move back and forth between pages to read the content in order.

If the text must be read in this way, the only solution to maintain the correct reading order is to convert the double page spread in to a single landscape page that contains the entire content of the spread and for the EPUB to be rendered as single pages.

From 05215956a4bb65b1604a3df00cf38ad1c44d37de Mon Sep 17 00:00:00 2001 From: wareid Date: Mon, 21 Oct 2024 10:15:28 -0400 Subject: [PATCH 2/4] document name change --- epub33/fxl-a11y/index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/epub33/fxl-a11y/index.html b/epub33/fxl-a11y/index.html index 1cc9bbff5..357ad3d1a 100644 --- a/epub33/fxl-a11y/index.html +++ b/epub33/fxl-a11y/index.html @@ -2,7 +2,7 @@ - EPUB Fixed Layout Accessibility + EPUB Best Practices for Fixed Layout Accessibility @@ -51,7 +51,7 @@
-

This document, EPUB Fixed Layout Accessibility, outlines the goals for EPUB accessible fixed layout ebooks while acknowledging the challenges unique to the fixed layout format.

+

This document, EPUB Best Practices for Fixed Layout Accessibility, outlines the goals for EPUB accessible fixed layout ebooks while acknowledging the challenges unique to the fixed layout format.

From f20e036527cb1d648b114d419dc4021d583f971d Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Tue, 22 Oct 2024 11:11:40 +0200 Subject: [PATCH 3/4] Update epub33/fxl-a11y/index.html Co-authored-by: Matt Garrish --- epub33/fxl-a11y/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/epub33/fxl-a11y/index.html b/epub33/fxl-a11y/index.html index 357ad3d1a..4e7d5eccd 100644 --- a/epub33/fxl-a11y/index.html +++ b/epub33/fxl-a11y/index.html @@ -192,7 +192,7 @@

Reading order

A key concept of EPUB is that an EPUB publication consists of multiple resources that can be completely navigated and consumed by a person or program in some specific order. - 1.2.1 Reading Order EPUB 3.3 Overview [[epub-overview-33]]
-

Reading order in EPUB refers to the order of content documents in the spine section of the Package document. However, the concept of reading order is also an important consideration for accessibility and refers to the visual and programmatic order of elements in a content document. In both EPUB and accessibility usage, reading order must be logical and accurate both visually and programmatically.

+

Reading order in EPUB refers to the order of content documents in the spine section of the package document. However, the concept of reading order is also an important consideration for accessibility and refers to the visual and programmatic order of elements in a content document. In both EPUB and accessibility usage, reading order must be logical and accurate both visually and programmatically.

Whereas many reflowable publications have an obvious reading order, or logical progression through their content, fixed layout publications are often more complex in their design and layout and may consist of multiple readable objects on the same page.

From e319d95ccc0f4d688f4e1dccd1726498437339a0 Mon Sep 17 00:00:00 2001 From: wareid Date: Wed, 27 Nov 2024 09:31:22 -0500 Subject: [PATCH 4/4] naming and abstract change --- epub33/fxl-a11y/index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/epub33/fxl-a11y/index.html b/epub33/fxl-a11y/index.html index 4e7d5eccd..5bc990a4a 100644 --- a/epub33/fxl-a11y/index.html +++ b/epub33/fxl-a11y/index.html @@ -2,7 +2,7 @@ - EPUB Best Practices for Fixed Layout Accessibility + EPUB Accessibility - Fixed Layout Challenges and Best Practices @@ -51,7 +51,7 @@
-

This document, EPUB Best Practices for Fixed Layout Accessibility, outlines the goals for EPUB accessible fixed layout ebooks while acknowledging the challenges unique to the fixed layout format.

+

An accessible fixed layout EPUB file is one that meets the accessibility requirements of the Web Content Accessibility Guidelines 2.x level AA [[wcag2]] and EPUB Accessibility 1.1 [[epub-a11y-11].This document, Fixed Layout Challenges and Best Practices, outlines the goals for EPUB accessible fixed layout ebooks while acknowledging the challenges unique to the fixed layout format.