From 5f3d5b00f8bcaf6f0ef2909e21b50fbe21727948 Mon Sep 17 00:00:00 2001 From: Gregorio Pellegirno Date: Thu, 18 Jul 2024 21:35:07 +0200 Subject: [PATCH 1/2] First proposal for additional accessibility information --- .../draft/techniques/onix-metadata/index.html | 182 +++++++++++++++++- 1 file changed, 181 insertions(+), 1 deletion(-) diff --git a/UX-Guide-Metadata/draft/techniques/onix-metadata/index.html b/UX-Guide-Metadata/draft/techniques/onix-metadata/index.html index c1117a9e..5ec6b5ba 100644 --- a/UX-Guide-Metadata/draft/techniques/onix-metadata/index.html +++ b/UX-Guide-Metadata/draft/techniques/onix-metadata/index.html @@ -759,8 +759,188 @@

Instructions

Additional accessibility information

This technique relates to Additional accessibility information key information.

+
+

Adaptation

+ +
Understanding the variables
+
+
dyslexia_readability
+
+

If true it indicates that the code 24 of codelist 196 (Dyslexia readability) is present in the ONIX record, otherwise if false it means that the metadata is not present.

+

This means that the product has been specifically adapted or has features specifically to improve readability for dyslexic readers, for example specialised font, character and/or line spacing, justification and paragraph spacing, coloring and other options provided specifically to improve readability for dyslexic readers.

+
+
closed_captions
+
+

If true it indicates that the code V210 of codelist 175 (Closed captions) is present in the ONIX record, otherwise if false it means that the metadata is not present.

+

This means that the audio content of a video can be seen via closed captions that can be turned on or off by the viewer and which will be a separate file from the video itself.

+
+
open_captions
+
+

If true it indicates that the code V211 of codelist 175 (Open captions) is present in the ONIX record, otherwise if false it means that the metadata is not present.

+

This means that the audio content of a video can be seen via open captions, which means they cannot be turned off and are always visible when the video plays.

+
+
full_transcript
+
+

If true it indicates that the code V212 of codelist 175 (Full transcript) is present in the ONIX record, otherwise if false it means that the metadata is not present.

+

This means that a full transcript of the audio content of the product is supplied with it.

+
+
sign_language
+
+

If true it indicates that the code V213 of codelist 175 (Sign language interpretation) is present in the ONIX record, otherwise if false it means that the metadata is not present.

+

This means that a full signing of audio content of the product supplied with the video file.

+
+
+ +
Variables setup
+
    +
  1. LET onix be the result of calling pre processing given onix_record_as_text.
    2. +
  2. LET dyslexia_readability be the result of calling check for node on onix, /ONIXMessage/Product/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType = "09" and ProductFormFeatureValue = "24"].
    3. +
  3. LET closed_captions be the result of calling check for node on onix, /ONIXMessage/Product/DescriptiveDetail[ProductFormDetail = "V210"].
    4. +
  4. LET open_captions be the result of calling check for node on onix, /ONIXMessage/Product/DescriptiveDetail[ProductFormDetail = "V211"].
    5. +
  5. LET full_transcript be the result of calling check for node on onix, /ONIXMessage/Product/DescriptiveDetail[ProductFormDetail = "V212"].
    6. +
  6. LET sign_language be the result of calling check for node on onix, /ONIXMessage/Product/DescriptiveDetail[ProductFormDetail = "V213"].
    7. +
+ +
Instructions
+
    +
  1. + IF dyslexia_readability OR closed_captions OR open_captions OR full_transcript OR sign_language: + THEN LET adaptation be an empty array. +
      +
    1. + IF dyslexia_readability: + THEN APPEND "dyslexia readability" to adaptation. +
      2. +
    2. + IF closed_captions: + THEN APPEND "closed captions" to adaptation. +
      3. +
    3. + IF open_captions: + THEN APPEND "open captions" to adaptation. +
      4. +
    4. + IF full_transcript: + THEN APPEND "full transcript" to adaptation. +
      5. +
    5. + IF sign_language: + THEN APPEND "sign language" to adaptation. +
      6. +
    6. LET adaptation_string be the result of: +
        +
      • calling join on adaptation with the separator ", "
        • +
      • making uppercase the first character
        • +
      • replacing the last occurence of ", " with " and ".
        • +
      +
      7. +
    7. display adaptation_string.
      8. +
    +
    2. +
+
+ +
+

Clarity

+ +
Understanding the variables
+
+
text_to_speech_hinting
+
+

If true it indicates that the code 21 of codelist 196 (Text-to-speech hinting provided) is present in the ONIX record, otherwise if false it means that the metadata is not present.

+

This means that text-to-speech has been optimised through provision of PLS lexicons, SSML or CSS Speech synthesis hints or other speech synthesis markup languages or hinting.

+
+
color_not_sole_means_of_conveying_information
+
+

If true it indicates that the code 25 of codelist 196 (Use of color is not sole means of conveying information) is present in the ONIX record, otherwise if false it means that the metadata is not present.

+

This means that for readers with color vision deficiency, use of color (eg in diagrams, graphs and charts, in prompts or on buttons inviting a response) is not the sole means of graphical distinction or of conveying information.

+
+
high_contrast_between_text_and_background
+
+

If true it indicates that the code 26 of codelist 196 (Use of high contrast between text and background color) is present in the ONIX record, otherwise if false it means that the metadata is not present.

+

This means that body text is presented with a contrast ratio of at least 4.5:1 (or 3:1 for large/heading text).

+
+
ultra_high_contrast_between_text_and_background
+
+

If true it indicates that the code 37 of codelist 196 (Use of ultra-high contrast between text foreground and background) is present in the ONIX record, otherwise if false it means that the metadata is not present.

+

This means that body text is presented with a contrast ratio of at least 7:1 (or 4.5:1 for large/heading text).

+
+
visible_page_numbering
+
+

If true it indicates that the code E205 of codelist 175 (Visible page numbering) is present in the ONIX record, otherwise if false it means that the metadata is not present.

+

This means that the e-publication (mostly in the case of a fixed-format) contains visible page numbers.

+
+
high_contrast_between_foreground_and_background_audio
+
+

If true it indicates that the code 27 of codelist 196 (Use of high contrast between foreground and background audio) is present in the ONIX record, otherwise if false it means that the metadata is not present.

+

This means that foreground audio content (eg voice) is presented with no or low background noise (eg ambient sounds, music), at least 20dB below the level of the foreground, or background noise can be switched off (eg via an alternative audio track). Brief and occasional sound effects may be as loud as foreground voice so long as they are isolated from the foreground.

+
+
without_background_sounds
+
+

If true it indicates that the code A312 of codelist 175 (Without background sounds) is present in the ONIX record, otherwise if false it means that the metadata is not present.

+

This means that pre-recorded audiobook narration does not contain any background sounds, including music, sound effects, etc, though music and effects may be present if isolated from the speech (ie the sounds do not overlap).

+
+
+ +
Variables setup
+
    +
  1. LET onix be the result of calling pre processing given onix_record_as_text.
    2. +
  2. LET text_to_speech_hinting be the result of calling check for node on onix, /ONIXMessage/Product/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType = "09" and ProductFormFeatureValue = "21"].
    3. +
  3. LET color_not_sole_means_of_conveying_information be the result of calling check for node on onix, /ONIXMessage/Product/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType = "09" and ProductFormFeatureValue = "25"].
    4. +
  4. LET high_contrast_between_text_and_background be the result of calling check for node on onix, /ONIXMessage/Product/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType = "09" and ProductFormFeatureValue = "26"].
    5. +
  5. LET ultra_high_contrast_between_text_and_background be the result of calling check for node on onix, /ONIXMessage/Product/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType = "09" and ProductFormFeatureValue = "37"].
    6. +
  6. LET visible_page_numbering be the result of calling check for node on onix, /ONIXMessage/Product/DescriptiveDetail[ProductFormDetail = "E205"].
    7. +
  7. LET high_contrast_between_foreground_and_background_audio be the result of calling check for node on onix, /ONIXMessage/Product/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType = "09" and ProductFormFeatureValue = "27"].
    8. +
  8. LET without_background_sounds be the result of calling check for node on onix, /ONIXMessage/Product/DescriptiveDetail[ProductFormDetail = "A312"].
    9. +
+ +
Instructions
+
    +
  1. + IF text_to_speech_hinting OR color_not_sole_means_of_conveying_information OR high_contrast_between_text_and_background OR ultra_high_contrast_between_text_and_background OR visible_page_numbering OR high_contrast_between_foreground_and_background_audio OR without_background_sounds: + THEN LET clarity be an empty array. +
      +
    1. + IF text_to_speech_hinting: + THEN APPEND "text-to-speech hinting provided" to clarity. +
      2. +
    2. + IF color_not_sole_means_of_conveying_information: + THEN APPEND "color is not the sole means of conveying information" to clarity. +
      3. +
    3. + IF high_contrast_between_text_and_background: + THEN APPEND "high contrast between text and background" to clarity. +
      4. +
    4. + IF ultra_high_contrast_between_text_and_background: + THEN APPEND "ultra high contrast between text and background" to clarity. +
      5. +
    5. + IF visible_page_numbering: + THEN APPEND "visible page numbering " to clarity. +
      6. +
    6. + IF high_contrast_between_foreground_and_background_audio: + THEN APPEND "high contrast between foreground and background audio" to clarity. +
      7. +
    7. + IF without_background_sounds: + THEN APPEND "without background sounds" to clarity. +
      8. +
    8. LET clarity_string be the result of: +
        +
      • calling join on clarity with the separator ", "
        • +
      • making uppercase the first character
        • +
      • replacing the last occurence of ", " with " and ".
        • +
      +
      9. +
    9. display clarity_string.
      10. +
    +
    2. +
+
-

Acknowledgements

From 4211b9000e09cd5cf9da1d44a4cb5a395af5b828 Mon Sep 17 00:00:00 2001 From: Gregorio Pellegirno Date: Thu, 25 Jul 2024 02:27:26 +0200 Subject: [PATCH 2/2] suggestions by charles --- .../draft/techniques/onix-metadata/index.html | 102 +++++++++--------- 1 file changed, 50 insertions(+), 52 deletions(-) diff --git a/UX-Guide-Metadata/draft/techniques/onix-metadata/index.html b/UX-Guide-Metadata/draft/techniques/onix-metadata/index.html index 5ec6b5ba..2fc73478 100644 --- a/UX-Guide-Metadata/draft/techniques/onix-metadata/index.html +++ b/UX-Guide-Metadata/draft/techniques/onix-metadata/index.html @@ -803,30 +803,29 @@
Variables setup
Instructions
    +
  1. LET adaptation be an empty array.
  2. - IF dyslexia_readability OR closed_captions OR open_captions OR full_transcript OR sign_language: - THEN LET adaptation be an empty array. + IF dyslexia_readability: + THEN APPEND "dyslexia readability" to adaptation. +
    3. +
  3. + IF closed_captions: + THEN APPEND "closed captions" to adaptation. +
    4. +
  4. + IF open_captions: + THEN APPEND "open captions" to adaptation. +
    5. +
  5. + IF full_transcript: + THEN APPEND "full transcript" to adaptation. +
    6. +
  6. + IF sign_language: + THEN APPEND "sign language" to adaptation. +
    7. +
  7. IF adaptation is NOT empty:
      -
    1. - IF dyslexia_readability: - THEN APPEND "dyslexia readability" to adaptation. -
      2. -
    2. - IF closed_captions: - THEN APPEND "closed captions" to adaptation. -
      3. -
    3. - IF open_captions: - THEN APPEND "open captions" to adaptation. -
      4. -
    4. - IF full_transcript: - THEN APPEND "full transcript" to adaptation. -
      5. -
    5. - IF sign_language: - THEN APPEND "sign language" to adaptation. -
    6. LET adaptation_string be the result of:
      • calling join on adaptation with the separator ", "
        • @@ -896,38 +895,37 @@
        Variables setup
        Instructions
          +
        1. LET clarity be an empty array.
          2. +
        2. + IF text_to_speech_hinting: + THEN APPEND "text-to-speech hinting provided" to clarity. +
          3. +
        3. + IF color_not_sole_means_of_conveying_information: + THEN APPEND "color is not the sole means of conveying information" to clarity. +
          4. +
        4. + IF high_contrast_between_text_and_background: + THEN APPEND "high contrast between text and background" to clarity. +
          5. +
        5. + IF ultra_high_contrast_between_text_and_background: + THEN APPEND "ultra high contrast between text and background" to clarity. +
          6. +
        6. + IF visible_page_numbering: + THEN APPEND "visible page numbering " to clarity. +
          7. +
        7. + IF high_contrast_between_foreground_and_background_audio: + THEN APPEND "high contrast between foreground and background audio" to clarity. +
        8. - IF text_to_speech_hinting OR color_not_sole_means_of_conveying_information OR high_contrast_between_text_and_background OR ultra_high_contrast_between_text_and_background OR visible_page_numbering OR high_contrast_between_foreground_and_background_audio OR without_background_sounds: - THEN LET clarity be an empty array. + IF without_background_sounds: + THEN APPEND "without background sounds" to clarity. +
          9. +
        9. IF clarity is NOT empty:
            -
          1. - IF text_to_speech_hinting: - THEN APPEND "text-to-speech hinting provided" to clarity. -
            2. -
          2. - IF color_not_sole_means_of_conveying_information: - THEN APPEND "color is not the sole means of conveying information" to clarity. -
            3. -
          3. - IF high_contrast_between_text_and_background: - THEN APPEND "high contrast between text and background" to clarity. -
            4. -
          4. - IF ultra_high_contrast_between_text_and_background: - THEN APPEND "ultra high contrast between text and background" to clarity. -
            5. -
          5. - IF visible_page_numbering: - THEN APPEND "visible page numbering " to clarity. -
            6. -
          6. - IF high_contrast_between_foreground_and_background_audio: - THEN APPEND "high contrast between foreground and background audio" to clarity. -
            7. -
          7. - IF without_background_sounds: - THEN APPEND "without background sounds" to clarity. -
          8. LET clarity_string be the result of:
            • calling join on clarity with the separator ", "