Skip to content

Commit

Permalink
Merge branch 'main' of https://github.com/w3c/publ-a11y
Browse files Browse the repository at this point in the history
  • Loading branch information
@mattgarrish
mattgarrish committed Nov 21, 2024
2 parents 424e431 + e009f46 commit 10c865c
Show file tree
Hide file tree
Showing 3 changed files with 53 additions and 38 deletions.
79 changes: 47 additions & 32 deletions a11y-meta-display-guide/2.0/draft/guidelines/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -150,28 +150,44 @@ <h2>Introduction</h2>
accessible from the outset, not fixed later) and getting the accessibility validation or audit done by
independent organizations.</p>

<section id="terminology">
<h3>Terminology</h3>

<p>There are several terms used in these guidelines that should be defined for clarity:</p>
<dl>
<dt><dfn>digital publication</dfn></dt>
<dd>
<p>The term digital publication is used in this document to refer to publications produced in any number of digital formats. Digital publications are not limited to books, but encompass any written, visual, or audio work distributed and read in digital form.</p>
<p>Some examples of digital publications include ebooks, audiobooks, manga, comic books, journals, digital textbooks, picture books, and children's picture books with accompanying audio. The formats they come in include EPUB, PDF, and Digital Talking Books (DTB).</p>
</dd>
<dt><dfn>reading system</dfn></dt>
<dd>
<p>All digital publications require a reading system to present the publication to the end user. Reading Systems may be Apps that run on a smart phone or tablet. There are Reading Systems which are applications that run on personal computers. There are also Reading Systems that are integrated in to dedicated devices devoted to a single purpose, for presenting a publication. There are even skills that run on smart speakers that can be considered Reading Systems.</p>
</dd>
<dt><dfn>electronic braille</dfn></dt>
<dt><dfn>refreshable braille</dfn></dt>
<dd>
<p>The terms "electronic braille" and "refreshable braille" can be used interchangeably, which denotes a device with pop-up pins to present the braille on a tactile screen. These devices can be used as a display attached to a personal computer, or they may be a self-contained multipurpose note taker with a refreshable braille display. </p>
</dd>
</dl>
</section>
</section>
<section id="terminology">
<h3>Terminology</h3>

<p>There are several terms used in these guidelines that should be defined for clarity:</p>

<dl>
<dt><dfn>digital publication</dfn></dt>
<dd>
<p>The term digital publication is used in this document to refer to publications produced in any number of digital formats. Digital publications are not limited to books, but encompass any written, visual, or audio work distributed and read in digital form.</p>
<p>Some examples of digital publications include ebooks, audiobooks, manga, comic books, journals, digital textbooks, picture books, and children's picture books with accompanying audio. The formats they come in include EPUB, PDF, and Digital Talking Books (DTB).</p>
</dd>

<dt><dfn>dynamic braille</dfn></dt>
<dd>
<p>The term dynamic braille is used to denote content that is generated as braille on the fly,
as opposed to preformatted digital braille formats. This dynamic rendering of
content is sometimes referred to as electronic braille or refreshable braille.</p>

<p>Dynamic braille is typically rendered on a separate device from the reading system, one with
pop-up pins to present the braille on a tactile screen. These devices, commonly referred to as
refreshable braille displays, can be attached to a personal computer, or they may be a
self-contained multipurpose note taker with a refreshable braille display.</p>
</dd>

<dt><dfn>read aloud speech</dfn></dt>
<dd>
<p>The term read aloud speech is used to denote content that is generated into synthetic speech
on the fly, as opposed to prerecorded narration. Read aloud functionality is often a feature
of reading systems, but can be provided by a separate assistive technology.</p>
</dd>

<dt><dfn>reading system</dfn></dt>
<dd>
<p>All digital publications require a reading system to present the publication to the end user. Reading Systems may be Apps that run on a smart phone or tablet. There are Reading Systems which are applications that run on personal computers. There are also Reading Systems that are integrated in to dedicated devices devoted to a single purpose, for presenting a publication. There are even skills that run on smart speakers that can be considered Reading Systems.</p>
</dd>
</dl>
</section>
</section>
<section id="general-overview">
<h2>General overview</h2>

Expand Down Expand Up @@ -463,7 +479,7 @@ <h3 data-localization-id="nonvisual-reading-title">Supports nonvisual reading</h
</div>

<p>Indicates whether all content required for comprehension can be consumed in text and therefore is
available to reading systems with text-to-speech or refreshable braille capabilities</p>
available to reading systems with [=read aloud speech=] or [=dynamic braille=] capabilities.</p>

<p>This field answers whether nonvisual reading is possible, not possible, or unknown.</p>

Expand All @@ -482,24 +498,23 @@ <h4>Examples</h4>
<aside class="example" title="Descriptive explanations">
<ul>
<li data-localization-id="nonvisual-reading-readable" data-localization-mode="descriptive"
>All content is available in generated read aloud speech and generated refreshable braille</li>
>All content can be read as read aloud speech or dynamic braille</li>
<li data-localization-id="nonvisual-reading-may-not-fully"
data-localization-mode="descriptive">Portions of the content may not be available in
generated read aloud speech and generated refreshable braille</li>
data-localization-mode="descriptive">Portions of the content may not be readable
as read aloud speech or dynamic braille</li>
<li data-localization-id="nonvisual-reading-not-fully" data-localization-mode="descriptive"
>Not all of the content will be available in generated read aloud speech and generated refreshable
braille</li>
</ul>
>Not all of the content will be readable as read aloud speech or dynamic braille</li>
</ul>
</aside>

<aside class="example" title="Compact explanations">
<ul>
<li data-localization-id="nonvisual-reading-readable" data-localization-mode="compact"
>Readable in read aloud and braille</li>
>Readable in read aloud or dynamic braille</li>
<li data-localization-id="nonvisual-reading-may-not-fully" data-localization-mode="compact"
>May not be fully readable in read aloud and braille</li>
>May not be fully readable in read aloud or dynamic braille</li>
<li data-localization-id="nonvisual-reading-not-fully" data-localization-mode="compact">Not
fully readable in read aloud and braille</li>
fully readable in read aloud or dynamic braille</li>
<!--To be Confirmed (see https://github.com/w3c/publ-a11y/issues/367)<li data-localization-id="nonvisual-reading-unknown" data-localization-mode="compact">Not known if readable in read aloud and braille</li>-->
</ul>
</aside>
Expand Down
6 changes: 3 additions & 3 deletions a11y-meta-display-guide/2.0/draft/techniques/epub-metadata/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -318,13 +318,13 @@ <h4>Instructions</h4>
<li>Display <code id="nonvisual-reading-title">"Supports nonvisual reading"</code> as heading.</li>
<li>
<span><b>IF</b> <var>all_necessary_content_textual</var>:</span>
<span><b>THEN</b> display <code id="nonvisual-reading-readable">"Readable in read aloud and braille"</code>.</span>
<span><b>THEN</b> display <code id="nonvisual-reading-readable">"Readable in read aloud or dynamic braille"</code>.</span>
</li>
<li>
<span><b>ELSE IF</b> <var>non_textual_content_images</var> <b>AND</b> <b>NOT</b> <var>textual_alternative_images</var>:</span>
<span><b>THEN</b> display <code id="nonvisual-reading-not-fully">"Not fully readable in read aloud and braille"</code>.</span>
<span><b>THEN</b> display <code id="nonvisual-reading-not-fully">"Not fully readable in read aloud or dynamic braille"</code>.</span>
</li>
<li><b>ELSE</b> display <code id="nonvisual-reading-may-not-fully">"May not be fully readable in read aloud and braille"</code>.</li>
<li><b>ELSE</b> display <code id="nonvisual-reading-may-not-fully">"May not be fully readable in read aloud or dynamic braille"</code>.</li>
</ol>


Expand Down
6 changes: 3 additions & 3 deletions a11y-meta-display-guide/2.0/draft/techniques/onix-metadata/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -324,13 +324,13 @@ <h4>Instructions</h4>
<li>Display <code id="nonvisual-reading-title">"Supports nonvisual reading"</code> as heading.</li>
<li>
<span><b>IF</b> <var>all_necessary_content_textual</var>:</span>
<span><b>THEN</b> display <code id="nonvisual-reading-readable">"Readable in read aloud and braille"</code>.</span>
<span><b>THEN</b> display <code id="nonvisual-reading-readable">"read aloud or dynamic braille"</code>.</span>
</li>
<li>
<span><b>ELSE IF</b> <var>real_text</var> <b>AND</b> <var>non_textual_content_images</var> <b>AND</b> <b>NOT</b> <var>textual_alternative_images</var>:</span>
<span><b>THEN</b> display <code id="nonvisual-reading-not-fully">"Not fully readable in read aloud and braille"</code>.</span>
<span><b>THEN</b> display <code id="nonvisual-reading-not-fully">"Not fully readable in read aloud or dynamic braille"</code>.</span>
</li>
<li><b>ELSE</b> display <code id="nonvisual-reading-may-not-fully">"May not be fully readable in read aloud and braille"</code>.</li>
<li><b>ELSE</b> display <code id="nonvisual-reading-may-not-fully">"May not be fully readable in read aloud or dynamic braille"</code>.</li>
</ol>
</section>

Expand Down

0 comments on commit 10c865c

Please sign in to comment.