From 83f4fc45f16005aa9e8ac6d0517c310c5cfd9d97 Mon Sep 17 00:00:00 2001 From: Charles LaPierre Date: Wed, 10 Apr 2024 12:41:57 -0700 Subject: [PATCH 1/3] added new technique for non visual reading Also fixed a few other issues found missing ending }, duplicate section, and removed the complexity of text()= to improve readability. --- .../draft/techniques/epub-metadata/index.html | 92 ++++++++++++++++--- 1 file changed, 78 insertions(+), 14 deletions(-) diff --git a/UX-Guide-Metadata/draft/techniques/epub-metadata/index.html b/UX-Guide-Metadata/draft/techniques/epub-metadata/index.html index 280f0dc6..573194e0 100755 --- a/UX-Guide-Metadata/draft/techniques/epub-metadata/index.html +++ b/UX-Guide-Metadata/draft/techniques/epub-metadata/index.html @@ -58,9 +58,10 @@ margin-left: 0.2em; padding: 0.1em; } - code[id]::after { - content: "[ID: " attr(id) "]"; - /*html::before { content: ""; }*/ + code[id]::after { + content: "[ID: " attr(id) "]"; + /*html::before { content: ""; } */ + } @@ -77,7 +78,7 @@

EPUB Accessibility Metadata

@@ -196,9 +197,9 @@

Variables setup

  1. LET package_document be the result of calling pre processing given package_document_as_text.
    2. -
  2. LET all_textual_content_can_be_modified be the result of calling check for node on package_document, /package/metadata/meta[@property="schema:accessibilityFeature" and text()="displayTransformability"].
    3. +
  3. LET all_textual_content_can_be_modified be the result of calling check for node on package_document, /package/metadata/meta[@property="schema:accessibilityFeature" = displayTransformability].
    4. -
  4. LET is_fixed_layout be the result of calling check for node on package_document, /package/metadata/meta[@property="rendition:layout" and text()="pre-paginated"].
    5. +
  5. LET is_fixed_layout be the result of calling check for node on package_document, /package/metadata/meta[@property="rendition:layout" = pre-paginated].

Instructions

@@ -218,7 +219,76 @@

Instructions

Supports nonvisual reading

This technique relates to Supports nonvisual reading key information.

- +

This algorithm takes the package_document_as_text argument: a UTF-8 string representing the Package document.

+

Understanding the variables

+
+
all_necessary_content_textual
+
+

If true it indicates that the accessModeSufficient="textual" (all main content is provided in textual form) is present in the OPF file, otherwise if false it means that the metadata is not present.

+

All non-decorative content supports reading without sight means that all contents of the digital publication necessary to use and understanding, including text, images (via their alternative descriptions), audio and video material (via their transcripts, descriptions, captions or subtitles) are fully accessible via suitable reading devices, for example text-to-speech screen readers or tactile reading devices (‘Braille displays’), and nothing in the digital publication prevents or blocks the use of alternative reading modes. The entire publication can be navigated and ‘read’ using only text rendered via sound or touch, and does not require visual perception.

+
+
non_textual_content_images
+
+

If true it indicates that at least one of the following is present in the OPF file:

+
    +
  • accessMode="chartOnVisual" (Charts and Graphs);
    • +
  • accessMode="chemOnVisual" (Chemistry);
    • +
  • accessMode="diagramOnVisual" (Diagrams);
    • +
  • accessMode="mathOnVisual" (Math);
    • +
  • accessMode="musicOnVisual" (Music);
    • +
  • accessMode="textOnVisual" (Images of text);
    • +
  • otherwise if false it means that this metadata is not present.
    • +
+

This means that the content contains images of any type.

+
+
textual_alternative_images
+
+

If true it indicates that at least one of the following is present in the OPF file:

+
    +
  • accessibilityFeature="alternativeText" (Short alternative textual descriptions);
    • +
  • accessibilityFeature="longDescription" (Full alternative textual descriptions);
    • +
  • accessibilityFeature="describedMath" (Visual of math fully described));
    • +
  • otherwise if false it means that this metadata is not present.
    • +
+

This means that there are textual alternatives for images.

+
+
+

Variables setup

+
    +
  1. LET package_document be the result of calling pre processing given package_document_as_text.
    2. + +
  2. LET all_necessary_content_textual be the result of calling check for node on package_document, /package/metadata/meta[@property="schema:accessModeSufficient = textual"].
    3. +
  3. + LET non_textual_content_images be the result of calling check for node on package_document, /package/metadata/meta[
    + @property="schema:accessMode" = chartOnVisual or
    + @property="schema:accessMode" = chemOnVisual or
    + @property="schema:accessMode" = diagramOnVisual or
    + @property="schema:accessMode" = mathOnVisual or
    + @property="schema:accessMode" = musicOnVisual or
    + @property="schema:accessMode" = textOnVisual]    . +
    4. + +
  4. LET textual_alternative_images be the result of calling check for node on package_document, /package/metadata/meta[
    + @property="schema:accessibilityFeature" = alternativeText or
    + @property="schema:accessibilityFeature" = longDescription or
    + @property="schema:accessibilityFeature" = describedMath]    . + +
    5. +
+

Instructions

+
    +
  1. + IF all_necessary_content_textual: + THEN display "Readable in read aloud and braille". +
    2. +
  2. + ELSE IF non_textual_content_images AND NOT textual_alternative_images: + THEN display "Not fully readable in read aloud and braille". +
    3. +
  3. ELSE display "May not be fully readable in read aloud and braille".
    4. +
+ +
@@ -234,13 +304,7 @@

Pre-recorded audio

This technique relates to Pre-recorded audio key information.

- -
-

Supports nonvisual reading

-

This technique relates to Supports nonvisual reading key information.

- -
- +

Conformance

From 55b059ab9669903394afaf3e51b4a4e2b22e25d8 Mon Sep 17 00:00:00 2001 From: Charles LaPierre Date: Fri, 12 Apr 2024 07:36:50 -0700 Subject: [PATCH 2/3] fixed xpath's --- .../draft/techniques/epub-metadata/index.html | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/UX-Guide-Metadata/draft/techniques/epub-metadata/index.html b/UX-Guide-Metadata/draft/techniques/epub-metadata/index.html index 573194e0..5b85271a 100755 --- a/UX-Guide-Metadata/draft/techniques/epub-metadata/index.html +++ b/UX-Guide-Metadata/draft/techniques/epub-metadata/index.html @@ -197,9 +197,9 @@

Variables setup

  1. LET package_document be the result of calling pre processing given package_document_as_text.
    2. -
  2. LET all_textual_content_can_be_modified be the result of calling check for node on package_document, /package/metadata/meta[@property="schema:accessibilityFeature" = displayTransformability].
    3. +
  3. LET all_textual_content_can_be_modified be the result of calling check for node on package_document, /package/metadata/meta[@property="schema:accessibilityFeature" and text()="displayTransformability"].
    4. -
  4. LET is_fixed_layout be the result of calling check for node on package_document, /package/metadata/meta[@property="rendition:layout" = pre-paginated].
    5. +
  5. LET is_fixed_layout be the result of calling check for node on package_document, /package/metadata/meta[@property="rendition:layout" and text()="pre-paginated"].

Instructions

@@ -257,21 +257,21 @@

Variables setup

  1. LET package_document be the result of calling pre processing given package_document_as_text.
    2. -
  2. LET all_necessary_content_textual be the result of calling check for node on package_document, /package/metadata/meta[@property="schema:accessModeSufficient = textual"].
    3. +
  3. LET all_necessary_content_textual be the result of calling check for node on package_document, /package/metadata/meta[@property="schema:accessModeSufficient" and text()="textual"].
  4. LET non_textual_content_images be the result of calling check for node on package_document, /package/metadata/meta[
    - @property="schema:accessMode" = chartOnVisual or
    - @property="schema:accessMode" = chemOnVisual or
    - @property="schema:accessMode" = diagramOnVisual or
    - @property="schema:accessMode" = mathOnVisual or
    - @property="schema:accessMode" = musicOnVisual or
    - @property="schema:accessMode" = textOnVisual]    . + @property="schema:accessMode" and text()="chartOnVisual" or
    + @property="schema:accessMode" and text()="chemOnVisual"" or
    + @property="schema:accessMode" and text()="diagramOnVisual" or
    + @property="schema:accessMode" and text()="mathOnVisual" or
    + @property="schema:accessMode" and text()="musicOnVisual" or
    + @property="schema:accessMode" and text()="textOnVisual"].
  5. LET textual_alternative_images be the result of calling check for node on package_document, /package/metadata/meta[
    - @property="schema:accessibilityFeature" = alternativeText or
    - @property="schema:accessibilityFeature" = longDescription or
    - @property="schema:accessibilityFeature" = describedMath]    . + @property="schema:accessibilityFeature" and text()="alternativeText" or
    + @property="schema:accessibilityFeature" and text()="longDescription" or
    + @property="schema:accessibilityFeature" and text()="describedMath"].
From 1d5634bf8f493d395807336216492a0d13991145 Mon Sep 17 00:00:00 2001 From: Charles LaPierre Date: Fri, 12 Apr 2024 10:53:48 -0700 Subject: [PATCH 3/3] Updated xpaths to be syntactically correct. --- .../draft/techniques/epub-metadata/index.html | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/UX-Guide-Metadata/draft/techniques/epub-metadata/index.html b/UX-Guide-Metadata/draft/techniques/epub-metadata/index.html index 5b85271a..47a997ee 100755 --- a/UX-Guide-Metadata/draft/techniques/epub-metadata/index.html +++ b/UX-Guide-Metadata/draft/techniques/epub-metadata/index.html @@ -259,19 +259,13 @@

Variables setup

  • LET all_necessary_content_textual be the result of calling check for node on package_document, /package/metadata/meta[@property="schema:accessModeSufficient" and text()="textual"].
  • - LET non_textual_content_images be the result of calling check for node on package_document, /package/metadata/meta[
    - @property="schema:accessMode" and text()="chartOnVisual" or
    - @property="schema:accessMode" and text()="chemOnVisual"" or
    - @property="schema:accessMode" and text()="diagramOnVisual" or
    - @property="schema:accessMode" and text()="mathOnVisual" or
    - @property="schema:accessMode" and text()="musicOnVisual" or
    - @property="schema:accessMode" and text()="textOnVisual"]    . + LET non_textual_content_images be the result of calling check for node on + package_document, /package/metadata/meta[@property="schema:accessibilityFeature" and
    (text()="chartOnVisual" or text()="chemOnVisual" or
    + text()="diagramOnVisual" or text()="mathOnVisual" or
    + text()="musicOnVisual" or text()="textOnVisual")]    .
    • -
  • LET textual_alternative_images be the result of calling check for node on package_document, /package/metadata/meta[
    - @property="schema:accessibilityFeature" and text()="alternativeText" or
    - @property="schema:accessibilityFeature" and text()="longDescription" or
    - @property="schema:accessibilityFeature" and text()="describedMath"]    . +
  • LET textual_alternative_images be the result of calling check for node on package_document, /package/metadata/meta[@property="schema:accessibilityFeature" and
    (text()="longDescription" or text()="alternativeText" or text()="describedMath")]    .