Skip to content

Commit 1dde837

Browse files
authored
Merge pull request #2770 from w3c/editorial/issue-2720
Add more accessibility document references
2 parents faf95ac + 08752fe commit 1dde837

File tree

3 files changed

+96
-9
lines changed

3 files changed

+96
-9
lines changed

epub34/a11y/index.html

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1489,6 +1489,67 @@ <h4>Re-evaluating conformance</h4>
14891489
widest possible audience.</p>
14901490
</section>
14911491
</section>
1492+
1493+
<section id="sec-a11y-resources" class="informative">
1494+
<h3>Additional resources</h3>
1495+
1496+
<p>The following documents provide additional information on how to author accessible <a
1497+
href="https://www.w3.org/TR/epub/#dfn-epub-publication">EPUB publications</a>:</p>
1498+
1499+
<dl>
1500+
<dt><a href="https://www.w3.org/TR/epub-a11y-111/">EPUB Accessibility Techniques 1.1.1</a></dt>
1501+
<dd>
1502+
<p>The EPUB Accessibility techniques [[epub-a11y-tech-111]] provide specific guidance on how to
1503+
apply WCAG techniques to EPUB publications as well a guidance on how to meet the
1504+
EPUB-specific objectives of this document.</p>
1505+
</dd>
1506+
1507+
<dt><a href="https://www.w3.org/WAI/WCAG22/Understanding/">WCAG 2.2 Understanding Docs</a></dt>
1508+
<dd>
1509+
<p>The WCAG Understanding Docs provide detailed explanations of the purpose and goals of the
1510+
WCAG success criteria.</p>
1511+
</dd>
1512+
1513+
<dt><a href="https://www.w3.org/WAI/WCAG22/quickref/">How to Meet WCAG (Quick Reference)</a></dt>
1514+
<dd>
1515+
<p>The WCAG quick reference guide provides links to techniques showing ways to meet each WCAG
1516+
success critierion.</p>
1517+
</dd>
1518+
1519+
<dt><a href="https://www.w3.org/TR/wai-aria/">Accessible Rich Internet Applications (ARIA)</a></dt>
1520+
<dd>
1521+
<p>The ARIA standard [[wai-aria]] defines roles, states, and properties for making dynamic
1522+
content that does not use native HTML elements and attributes accessible. It also provides a
1523+
set of landmarks for navigating web pages.</p>
1524+
</dd>
1525+
1526+
<dt><a href="https://www.w3.org/TR/html-aria/">ARIA in HTML</a></dt>
1527+
<dd>
1528+
<p>ARIA in HTML [[html-aria]] specifies how the roles, states, and properties defined ARIA and
1529+
DPUB-ARIA can be used in HTML documents.</p>
1530+
</dd>
1531+
1532+
<dt><a href="https://www.w3.org/WAI/ARIA/apg/">ARIA Authoring Practices Guide (APG)</a></dt>
1533+
<dd>
1534+
<p>The ARIA Authoring Practices guide provides examples of how to use ARIA roles, states, and
1535+
properties to make dynamic content more accessible.</p>
1536+
</dd>
1537+
1538+
<dt><a href="https://www.w3.org/TR/dpub-aria/">Digital Publishing WAI-ARIA Module
1539+
(DPUB-ARIA)</a></dt>
1540+
<dd>
1541+
<p>The [[dpub-aria]] specification is an extension of [[wai-aria]] that provides additional
1542+
roles specific to identifying common publishing structures.</p>
1543+
</dd>
1544+
1545+
<dt><a href="https://www.w3.org/TR/epub-aria-authoring/">EPUB Type to ARIA Role Authoring
1546+
Guide</a></dt>
1547+
<dd>
1548+
<p>The EPUB Type to ARIA Role authoring guide provides mappings from the semantics used in the
1549+
<code>epub:type</code> attribute to ARIA and DPUB-ARIA role equivalents.</p>
1550+
</dd>
1551+
</dl>
1552+
</section>
14921553
</section>
14931554
<section id="sec-optimized-pubs" class="informative">
14941555
<h2>Optimized publications</h2>

epub34/authoring/index.html

Lines changed: 34 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9470,14 +9470,40 @@ <h2>Accessibility</h2>
94709470
<p>EPUB 3 builds upon the Open Web Platform expressly so that it can leverage the structure, semantics and,
94719471
by extension, accessibility built into its underlying technologies.</p>
94729472

9473-
<p>The requirements and practices for creating accessible web content have already been documented in the
9474-
W3C's <a href="https://www.w3.org/TR/WCAG2/">Web Content Accessibility Guidelines (WCAG)</a> [[wcag2]].
9475-
These guidelines also form the basis for defining accessibility in [=EPUB publications=].</p>
9476-
9477-
<p>As the current WCAG guidelines (version 2) are heavily focused on web pages, a separate specification, <a
9478-
data-cite="epub-a11y-111#">EPUB Accessibility</a> [[epub-a11y-111]], defines how to apply the
9479-
standard to EPUB publications. It also adds EPUB-specific requirements and recommendations for metadata,
9480-
pagination, and media overlays.</p>
9473+
<p>Some of the key standards for authoring accessible web content include:</p>
9474+
9475+
<dl>
9476+
<dt><a href="https://www.w3.org/TR/WCAG2/">Web Content Accessibility Guidelines (WCAG)</a></dt>
9477+
<dd>
9478+
<p>The requirements and practices for creating accessible web content are documented in the
9479+
[[wcag2]].</p>
9480+
</dd>
9481+
9482+
<dt><a href="https://www.w3.org/TR/wai-aria/">Accessible Rich Internet Applications (ARIA)</a></dt>
9483+
<dd>
9484+
<p>The [[wai-aria]] specification defines roles, states, and properties for making dynamic content
9485+
that does not use native HTML elements and attributes accessible. It also provides a set of
9486+
landmarks for navigating web pages.</p>
9487+
</dd>
9488+
9489+
<dt><a href="https://www.w3.org/TR/dpub-aria/">Digital Publishing WAI-ARIA Module (DPUB-ARIA)</a></dt>
9490+
<dd>
9491+
<p>The [[dpub-aria]] specification is an extension of [[wai-aria]] that provides additional roles
9492+
specific to identifying common publishing structures.</p>
9493+
</dd>
9494+
9495+
<dt><a href="https://www.w3.org/TR/html-aria/">ARIA in HTML</a></dt>
9496+
<dd>
9497+
<p>[[html-aria]] specifies how the roles, states, and properties defined ARIA and DPUB-ARIA can be
9498+
used in HTML documents.</p>
9499+
</dd>
9500+
</dl>
9501+
9502+
<p>These standards also form the basis for making [=EPUB publications=] accessible. As the current WCAG
9503+
guidelines (version 2) are heavily focused on web pages, however, the <a data-cite="epub-a11y-111#">EPUB
9504+
Accessibility</a> standard [[epub-a11y-111]] defines how to apply these standards to EPUB
9505+
publications and adds EPUB-specific requirements and recommendations for metadata, pagination, and media
9506+
overlays.</p>
94819507

94829508
<p>This specification recommends that EPUB publications <a href="#confreq-a11y">conform to the accessibility
94839509
requirements</a> defined in&#160;[[epub-a11y-111]]. A benefit of following this recommendation is

epub34/authoring/vocab/meta-property.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -547,7 +547,7 @@ <h5>The <code>pageBreakSource</code> property</h5>
547547
</table>
548548

549549
<div class="note">
550-
<p>The <code>pageBreakSource</code> property replaces the <a href="#source-of"><code>source-of</code>
550+
<p>The <code>pageBreakSource</code> property replaces the <a href="#sec-source-of"><code>source-of</code>
551551
property</a> for identifying the source of static pagination for an EPUB publication.</p>
552552

553553
<p>Refer to [[epub-a11y-tech-11]] for information on how to provide accessible page navigation.</p>

0 commit comments

Comments
 (0)