Skip to content

Commit

Permalink
Merge pull request #549 from w3c/fix-ids-in-guide
Browse files Browse the repository at this point in the history 
Aligned the IDs in ONIX techniques and the guidelines
  • Loading branch information
@GeorgeKerscher
GeorgeKerscher authored Dec 20, 2024
2 parents 5658742 + a392779 commit d3fb833
Showing 1 changed file with 42 additions and 53 deletions.
95 changes: 42 additions & 53 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 @@ -584,7 +584,7 @@ <h3 data-localization-id="visual-adjustments-title">Visual
font size used, as well as spacing between
letters, words, sentences, or paragraphs.</p>

<p><!--this one might be moved to the techniques-->Knowing
<p>Knowing
that a publication can reflow to fit the
reading system's display area is not sufficient to know
that modifications to the font, spacing, and
Expand Down Expand Up @@ -736,7 +736,7 @@ <h4>Examples</h4>
data-localization-mode="compact">Not
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>-->

<li>No information is available</li>
</ul>
</aside>
Expand Down Expand Up @@ -829,7 +829,6 @@ <h4>Conformance statements</h4>
Accessibility and
WCAG 2 Level A standard</p>
</dd>
<!--To be Confirmed (see https://github.com/w3c/publ-a11y/issues/368)-->

<dt data-localization-id="conformance-no"
data-localization-mode="compact">No information is available</dt>
Expand Down Expand Up @@ -1047,10 +1046,7 @@ <h4>Examples</h4>
<p data-localization-id="conformance-no"
data-localization-mode="compact">No information is available</p>

<!-- It does not make sense to have detailed information when we already know that no conformance information was provided.

<p>Detailed conformance information:</p>
<p>No information is available</p> -->


</aside>
Expand All @@ -1077,14 +1073,14 @@ <h4>Display techniques for conformance support</h4>
</section>


<section id="pre-recorded-audio">
<h3 data-localization-id="pre-recorded-audio-title">Prerecorded audio</h3>
<section id="prerecorded-audio">
<h3 data-localization-id="prerecorded-audio-title">Prerecorded audio</h3>

<div class="note">
<p>This key information can be hidden if metadata is
missing. Alternatively it can be stated that
<span
data-localization-id="pre-recorded-audio-no-metadata"
data-localization-id="prerecorded-audio-no-metadata"
data-localization-mode="descriptive">No information is available</span>
</p>
</div>
Expand All @@ -1097,17 +1093,14 @@ <h3 data-localization-id="pre-recorded-audio-title">Prerecorded audio</h3>
popularity, audiobooks may provide more
accessibility options in the future.</p>

<!-- <p>Some publications provide audio (including audio in
video) in addition to text. In this case, it is
important that the user is informed that they may not be
able to access all content in the book. </p> -->


<p>Some publications provide prerecorded audio with text
synchronization. Users with hearing
impairments still can access the full content of these
books.</p>

<section id="pre-recorded-audio-examples">
<section id="prerecorded-audio-examples">
<h4>Examples</h4>

<p>The examples are provided as lists of possible
Expand All @@ -1116,49 +1109,45 @@ <h4>Examples</h4>

<aside class="example" title="Descriptive explanations">
<ul>
<li data-localization-id="pre-recorded-audio-only"
<li data-localization-id="prerecorded-audio-only"
data-localization-mode="descriptive">
Audiobook with no text alternative</li>
<!-- <li data-localization-id="pre-recorded-audio-complementary"
data-localization-mode="descriptive">
Contents available as complementary audio
and
text</li> -->
<li data-localization-id="pre-recorded-audio-synchronized"

<li data-localization-id="prerecorded-audio-synchronized"
data-localization-mode="descriptive">All the
content is available as prerecorded audio
synchronized with text</li>
<li data-localization-id="pre-recorded-audio-no-metadata"
<li data-localization-id="prerecorded-audio-no-metadata"
data-localization-mode="descriptive">
No information is available</li>
</ul>
</aside>

<aside class="example" title="Compact explanations">
<ul>
<li data-localization-id="pre-recorded-audio-only"
<li data-localization-id="prerecorded-audio-only"
data-localization-mode="compact">Audiobook</li>
<li data-localization-id="pre-recorded-audio-synchronized"
<li data-localization-id="prerecorded-audio-synchronized"
data-localization-mode="compact">Prerecorded audio synchronized with text</li>
<li data-localization-id="pre-recorded-audio-no-metadata"
<li data-localization-id="prerecorded-audio-no-metadata"
data-localization-mode="compact">
No information is available</li>
</ul>
</aside>
</section>

<section id="pre-recorded-audio-techniques">
<section id="prerecorded-audio-techniques">
<h4>Display techniques for prerecorded audio support
</h4>
<p>Specific techniques for meeting this principle are
defined in the following documents:</p>
<ul>
<li><a
href="../techniques/epub-metadata/index.html#pre-recorded-audio">EPUB
href="../techniques/epub-metadata/index.html#prerecorded-audio">EPUB
Accessibility: Full
audio</a></li>
<li><a
href="../techniques/onix-metadata/index.html#pre-recorded-audio">ONIX:
href="../techniques/onix-metadata/index.html#prerecorded-audio">ONIX:
Full
audio</a></li>
</ul>
Expand Down Expand Up @@ -1208,9 +1197,7 @@ <h4>Examples</h4>
adoption.</p>

<aside class="example" title="Descriptive explanations">
<!-- <p><span data-localization-id="navigation-intro"
data-localization-mode="descriptive">Navigation
features contain:</span></p> -->

<ul>
<li data-localization-id="navigation-toc"
data-localization-mode="descriptive">Table
Expand All @@ -1226,7 +1213,8 @@ <h4>Examples</h4>
data-localization-mode="descriptive">Page list to go to pages from the print
source
version</li>
<li>No information is available</li>
<li data-localization-id="navigation-no-metadata"
data-localization-mode="descriptive">No information is available</li>
</ul>
</aside>

Expand All @@ -1247,7 +1235,8 @@ <h4>Examples</h4>
<li><span
data-localization-id="navigation-page-navigation"
data-localization-mode="compact">Go to page </span></li>
<li>No information is available</li>
<li data-localization-id="navigation-no-metadata"
data-localization-mode="compact">No information is available</li>
</ul>
</aside>
</section>
Expand All @@ -1269,14 +1258,14 @@ <h4>Display techniques for navigation support</h4>
</ul>
</section>
</section>
<section id="charts-diagrams-and-formulas">
<h3 data-localization-id="charts-diagrams-formulas-title">Rich content</h3>
<section id="rich-content">
<h3 data-localization-id="Rich-content-title">Rich content</h3>

<div class="note">
<p>This key information can be hidden if metadata is
missing. Alternatively it can be stated that
<span
data-localization-id="charts-diagrams-formulas-unknown"
data-localization-id="rich-content-unknown"
data-localization-mode="descriptive">No information is available</span>
</p>
</div>
Expand All @@ -1296,25 +1285,25 @@ <h4>Examples</h4>
<aside class="example" title="Descriptive explanations">

<ul>
<li><span data-localization-id="charts-diagrams-formulas-accessible-math-as-mathml"
<li><span data-localization-id="rich-content-accessible-math-as-mathml"
data-localization-mode="descriptive">Math formulas in accessible format (MathML)</span>
</li>
<li><span data-localization-id="charts-diagrams-formulas-accessible-math-as-latex"
<li><span data-localization-id="rich-content-accessible-math-as-latex"
data-localization-mode="descriptive">Math formulas in accessible format (LaTex)</span>
</li>
<li><span
data-localization-id="charts-diagrams-formulas-accessible-math-described"
data-localization-id="rich-content-accessible-math-described"
data-localization-mode="descriptive">Math formulas in accessible format (formulas as images with textual description)</span>
</li>
<li><span data-localization-id="charts-diagrams-formulas-accessible-chemistry-as-mathml"
<li><span data-localization-id="rich-content-accessible-chemistry-as-mathml"
data-localization-mode="descriptive">Chemical formulas in accessible format (MathML)</span>
</li>
<li><span data-localization-id="charts-diagrams-formulas-accessible-chemistry-as-latex"
<li><span data-localization-id="rich-content-accessible-chemistry-as-latex"
data-localization-mode="descriptive">Chemical formulas in accessible format (LaTex)</span>
</li>
<li>
<span
data-localization-id="charts-diagrams-formulas-extended"
data-localization-id="rich-content-extended"
data-localization-mode="descriptive">Information-rich images are described by extended descriptions</span>
</li>
<li><span data-localization-id="additional-accessibility-information-adaptation-closed-captions" data-localization-mode="descriptive">
Expand All @@ -1325,32 +1314,32 @@ <h4>Examples</h4>
Videos included in publications have open captions </span></li>
<li><span data-localization-id="additional-accessibility-information-adaptation-full-transcript" data-localization-mode="descriptive">
Prerecorded audio has a full transcript</span></li>
<li>No information is available</li>
<li><span data-localization-id="rich-content-unknown" data-localization-mode="descriptive">No information is available</span></li>
</ul>
</aside>

<aside class="example" title="Compact explanations">

<ul>
<li>
<span data-localization-id="charts-diagrams-formulas-accessible-math-as-mathml"
<span data-localization-id="rich-content-accessible-math-as-mathml"
data-localization-mode="compact">Math as MathML</span></li>
<li>
<span data-localization-id="charts-diagrams-formulas-accessible-math-as-latex"
<span data-localization-id="rich-content-accessible-math-as-latex"
data-localization-mode="compact">Math as LaTex</span></li>
<li>
<span data-localization-id="charts-diagrams-formulas-accessible-math-described"
<span data-localization-id="rich-content-accessible-math-described"
data-localization-mode="compact">Math as images with text description</span></li>
<li><span data-localization-id="charts-diagrams-formulas-accessible-chemistry-as-mathml"
<li><span data-localization-id="rich-content-accessible-chemistry-as-mathml"
data-localization-mode="compact">Chemical formulas in MathML</span>
</li>
<li><span data-localization-id="charts-diagrams-formulas-accessible-chemistry-as-latex"
<li><span data-localization-id="rich-content-accessible-chemistry-as-latex"
data-localization-mode="compact">Chemical formulas in LaTex</span>
</li>

<li>
<span
data-localization-id="charts-diagrams-formulas-extended"
data-localization-id="rich-content-extended"
data-localization-mode="compact">Information-rich images are described by extended descriptions</span>
</li>
<li><span data-localization-id="additional-accessibility-information-adaptation-closed-captions" data-localization-mode="compact">
Expand All @@ -1361,7 +1350,7 @@ <h4>Examples</h4>
Videos have open captions </span></li>
<li><span data-localization-id="additional-accessibility-information-adaptation-full-transcript" data-localization-mode="compact">
Prerecorded audio has transcript</span></li>
<li>No information is available</li>
<li><span data-localization-id="rich-content-unknown" data-localization-mode="compact">No information is available</span></li>
</ul>
</aside>
</section>
Expand All @@ -1375,11 +1364,11 @@ <h4>Display techniques for rich content support</h4>

<ul>
<li><a
href="../techniques/epub-metadata/index.html#charts-diagrams-and-formulas">EPUB
href="../techniques/epub-metadata/index.html#rich-content">EPUB
Accessibility: Rich content</a>
</li>
<li><a
href="../techniques/onix-metadata/index.html#charts-diagrams-and-formulas">ONIX:
href="../techniques/onix-metadata/index.html#rich-content">ONIX:
Rich content</a></li>
</ul>
</section>
Expand Down Expand Up @@ -1704,7 +1693,7 @@ <h4> Display techniques for legal considerations</h4>

</dd>

<!-- maybe we can remove High Contrast Display -->

<dt>Clarity</dt>
<dd>
<p>For information on ways that the content has been
Expand Down

0 comments on commit d3fb833

Please sign in to comment.