Merge pull request #2812 from w3c/editorial/a11y-refs

Fix all remaining references to 1.1.1

Author: mattgarrish

epub34/a11y-tech/index.html

@@ -64,6 +64,11 @@
 							"Matt Garrish"
 						]
 					},
+					"epub-3": {
+						"title": "EPUB 3",
+						"href": "https://www.w3.org/TR/epub/",
+						"publisher": "W3C"
+					},
 					"iso24751-3": {
 						"title": " ISO/IEC 24751-3:2008 Information technology -- Individualized adaptability and accessibility in e-learning, education and training -- Part 3: "Access for all" digital resource description",
 						"href": "http://www.iso.org/iso/catalogue_detail?csnumber=43604",
@@ -137,8 +142,9 @@ <h3>Overview</h3>
 			<section id="sec-terminology">
 				<h3>Terminology</h3>
 
-				<p>This document uses terminology defined in <a data-cite="epub/#sec-terminology">EPUB 3.3</a> [[epub]]
-					and <a data-cite="epub-a11y-11#sec-terminology">EPUB Accessibility 1.2</a> [[epub-a11y-12]]:</p>
+				<p>This document uses terminology defined in <a data-cite="epub/#sec-terminology">EPUB 3.3</a>
+					[[epub-3]] and <a data-cite="epub-a11y-11#sec-terminology">EPUB Accessibility 1.2</a>
+					[[epub-a11y-12]]:</p>
 
 				<div class="note">
 					<p>Only the first instance of a term in a section links to its definition.</p>
@@ -264,7 +270,7 @@ <h4>Ensure meaningful order of content across spreads</h4>
 						the underlying markup).</p>
 
 					<p>As EPUB allows two <a data-cite="epub/#dfn-epub-content-document">EPUB content documents</a> to
-						be rendered together in a <a data-cite="epub/#spread">synthetic spread</a> [[epub]], the order
+						be rendered together in a <a data-cite="epub/#spread">synthetic spread</a> [[epub-3]], the order
 						of content within a single document cannot always be evaluated in isolation. Content might span
 						visually from one document to the next. For example, a sidebar might span the bottom of two
 						pages.</p>
@@ -295,7 +301,7 @@ <h4>Provide multiple ways to access the content</h4>
 							>EPUB content documents</a>, <a data-cite="epub/#dfn-epub-reading-system">reading
 							systems</a> automatically provide the ability for the user to move seamlessly from one
 						document to the next, so long as they are listed in the <a data-cite="epub/#sec-spine-elem"
-							>spine</a> [[epub]]. To the user, an EPUB publication is a single document they have
+							>spine</a> [[epub-3]]. To the user, an EPUB publication is a single document they have
 						complete access to, not a set of disconnected pages that they need links to move through.</p>
 
 					<p>The required table of contents provides a second method to access the major headings of the
@@ -455,7 +461,7 @@ <h4>ARIA roles and <code>epub:type</code></h4>
 					</div>
 
 					<p>Although the <code>role</code> attribute might seem similar in nature to the <a
-							data-cite="epub/#sec-epub-type-attribute"><code>type</code> attribute</a> [[epub]], their
+							data-cite="epub/#sec-epub-type-attribute"><code>type</code> attribute</a> [[epub-3]], their
 						target uses in EPUB content documents do not overlap.</p>
 
 					<p>The key difference between these attributes is that the <code>role</code> attribute bridges
@@ -917,7 +923,7 @@ <h4>Language of package document</h4>
 					<p>Consequently, it is necessary to provide the language of all text content in the package document
 						to conform with these WCAG success criteria. The easiest way to meet this requirement is to add
 						an <code>xml:lang</code> attribute on the root <a data-cite="epub/#sec-package-elem"
-								><code>package</code> element</a> [[epub]].</p>
+								><code>package</code> element</a> [[epub-3]].</p>
 
 					<aside class="example" title="All text declared to be in Japanese by default">
 						<pre><code>&lt;package … xml:lang="jp">
@@ -954,7 +960,7 @@ <h4>Language of the EPUB publication</h4>
 					<p>In addition to being able to express the language of text content, the <a
 							data-cite="epub/#dfn-package-document">package document</a> also allows the identification
 						of the languages of the <a data-cite="epub/#dfn-epub-publication">EPUB publication</a> in <a
-							data-cite="epub/#sec-opf-dclanguage"><code>dc:language</code> elements</a> [[epub]].</p>
+							data-cite="epub/#sec-opf-dclanguage"><code>dc:language</code> elements</a> [[epub-3]].</p>
 
 					<aside class="example" title="Setting the language of an EPUB publication to Italian">
 						<pre><code>&lt;package …>
@@ -1147,7 +1153,7 @@ <h4>Identify pages in audio playback</h4>
 
 					<p>To identify page numbers in media overlay documents, attach an <code>epub:type</code> attribute
 						with the value "<a data-cite="epub-ssv-11/#pagebreak"><code>pagebreak</code></a>" [[epub-ssv]]
-						to each <a data-cite="epub#sec-smil-par-elem"><code>par</code> element</a> [[epub]] that
+						to each <a data-cite="epub#sec-smil-par-elem"><code>par</code> element</a> [[epub-3]] that
 						identifies a page number.</p>
 
 					<aside class="example" title="A page number identified in a media overlays document">
@@ -1211,7 +1217,7 @@ <h4>Provide a page list</h4>
 
 					<p>The <a data-cite="epub/#dfn-epub-navigation-document">EPUB navigation document</a> allows the
 						inclusion of a <a data-cite="epub/#sec-nav-pagelist"><code>page-list</code>
-							<code>nav</code></a> [[epub]], while the EPUB 2 NCX file provides the same functionality
+							<code>nav</code></a> [[epub-3]], while the EPUB 2 NCX file provides the same functionality
 						through the <a href="http://idpf.org/epub/20/spec/OPF_2.0.1_draft.htm#Section2.4.1.2"
 								><code>pageList</code> element</a> [[opf-201]].</p>
 
@@ -1296,7 +1302,8 @@ <h4>Identify the pagination source</h4>
 
 					<p>To allow users to determine the suitability of the pagination, identify the ISBN of the source
 						work in the <a data-cite="epub/#dfn-package-document">package document</a> metadata using the <a
-							data-cite="epub#sec-pageBreakSource"><code>pageBreakSource</code> property</a> [[epub]].</p>
+							data-cite="epub#sec-pageBreakSource"><code>pageBreakSource</code> property</a>
+						[[epub-3]].</p>
 
 					<aside class="example" title="Expressing the source of pagination">
 						<p>In this example, the <code>pageBreakSource</code> property contains the ISBN of the print
@@ -1315,15 +1322,15 @@ <h4>Identify the pagination source</h4>
 						<p>These techniques previously advised using the <a data-cite="epub/#sec-source-of"
 									><code>source-of</code> property</a> to identify the <a
 								data-cite="epub/#sec-opf-dcmes-optional-def"><code>dc:source</code> element</a>
-							containing the source of the pagination [[epub]]. This method came with a number of
+							containing the source of the pagination [[epub-3]]. This method came with a number of
 							limitations, however. It was not future proof, for example, as it relied on the EPUB 3 <a
-								data-cite="epub/#attrdef-refines"><code>refines</code> attribute</a> [[epub]] and it
+								data-cite="epub/#attrdef-refines"><code>refines</code> attribute</a> [[epub-3]] and it
 							could not handle pagination without a source due to the reliance on a <code>dc:source</code>
 							element.</p>
 
 						<p>The <a data-cite="epub#sec-pageBreakSource"><code>pageBreakSource</code> property</a>
-							[[epub]] replaces <code>source-of</code> in newer version of EPUB 3. It is strongly advised
-							that anyone using the <code>source-of</code> property switch to using the
+							[[epub-3]] replaces <code>source-of</code> in newer version of EPUB 3. It is strongly
+							advised that anyone using the <code>source-of</code> property switch to using the
 								<code>pageBreakSource</code> property. Although the <code>source-of</code> method will
 							remain valid for backwards compatibility purposes, its use is no longer advised.</p>
 					</div>
@@ -1368,9 +1375,9 @@ <h4>Ensuring complete text coverage</h4>
 						even audio-only playback, have access to the same information as users who do not require
 						synchronized playback.</p>
 
-					<p>EPUB 3's <a data-cite="epub/#sec-media-overlays">media overlays feature</a> [[epub]] allows audio
-						to be synchronized with any element in an <a data-cite="epub/#dfn-epub-content-document">EPUB
-							content document</a>, so there is no technical barrier to providing synchronized
+					<p>EPUB 3's <a data-cite="epub/#sec-media-overlays">media overlays feature</a> [[epub-3]] allows
+						audio to be synchronized with any element in an <a data-cite="epub/#dfn-epub-content-document"
+							>EPUB content document</a>, so there is no technical barrier to providing synchronized
 						playback.</p>
 
 					<p>The primary consideration for this objective is what constitutes the text content of an EPUB
@@ -1384,9 +1391,9 @@ <h4>Ensuring complete text coverage</h4>
 
 					<p>The media overlays <a data-cite="epub/#sec-smil-text-elem"><code>text</code> element</a> is used
 						to reference these elements, either to play back the pre-recorded audio in a sibling <a
-							data-cite="epub/#sec-smil-audio-elem"><code>audio</code> element</a> [[epub]] or to initiate
-						playback of an audio or video element if the <code>audio</code> element is missing (e.g., for
-						embedded audio and video in the document).</p>
+							data-cite="epub/#sec-smil-audio-elem"><code>audio</code> element</a> [[epub-3]] or to
+						initiate playback of an audio or video element if the <code>audio</code> element is missing
+						(e.g., for embedded audio and video in the document).</p>
 
 					<div class="note">
 						<p>Do not synchronize media overlays to hidden text content. Synchronizing audio with invisible
@@ -1426,8 +1433,8 @@ <h4>Specifying the reading order</h4>
 						content) diverges from the default reading order, order the playback sequence of <a
 							data-cite="epub/#sec-smil-seq-elem"><code>seq</code></a> and <a
 							data-cite="epub/#sec-smil-par-elem"><code>par</code></a> elements in a <a
-							data-cite="epub/#sec-overlay-docs">media overlays document</a> [[epub]] to match the logical
-						order.</p>
+							data-cite="epub/#sec-overlay-docs">media overlays document</a> [[epub-3]] to match the
+						logical order.</p>
 
 					<p>Use caution when making alterations, however, as other accessibility issues can arise when the
 						logical order does not match the default order. For example, the content might not be accessible
@@ -1451,13 +1458,14 @@ <h4>Identifying skippable structures</h4>
 						content after finishing the <a data-cite="epub/#dfn-epub-publication">EPUB publication</a>. The
 						announcement of page break numbers can be similarly annoying to readers.</p>
 
-					<p>EPUB 3's <a data-cite="epub/#sec-media-overlays">media overlays feature</a> [[epub]] does not
+					<p>EPUB 3's <a data-cite="epub/#sec-media-overlays">media overlays feature</a> [[epub-3]] does not
 						allow <a data-cite="epub/#dfn-epub-reading-system">reading systems</a> to determine if playback
 						sequences are skippable unless additional semantics are added to the markup using the <a
-							data-cite="epub/#sec-epub-type-attribute"><code>epub:type</code></a> attribute [[epub]] on
+							data-cite="epub/#sec-epub-type-attribute"><code>epub:type</code></a> attribute [[epub-3]] on
 							<a data-cite="epub/#sec-smil-seq-elem"><code>seq</code></a> and <a
-							data-cite="epub/#sec-smil-par-elem"><code>par</code></a> elements [[epub]]. These semantics
-						are what allow reading systems to provide users the option to skip their playback sequences.</p>
+							data-cite="epub/#sec-smil-par-elem"><code>par</code></a> elements [[epub-3]]. These
+						semantics are what allow reading systems to provide users the option to skip their playback
+						sequences.</p>
 
 					<p>It is strongly advised to identify the following structures for skippability:</p>
 
@@ -1553,13 +1561,13 @@ <h4>Identifying escapable structures</h4>
 						on. These are called escapable elements, because the user needs to be able to escape from them
 						whenever they choose to simplify the reading experience.</p>
 
-					<p>EPUB 3's <a data-cite="epub/#sec-media-overlays">media overlays feature</a> [[epub]] only
+					<p>EPUB 3's <a data-cite="epub/#sec-media-overlays">media overlays feature</a> [[epub-3]] only
 						supports escapability if structural semantics are added to the markup using the <a
-							data-cite="epub/#sec-epub-type-attribute"><code>epub:type</code> attribute</a> [[epub]] on
+							data-cite="epub/#sec-epub-type-attribute"><code>epub:type</code> attribute</a> [[epub-3]] on
 							<a data-cite="epub/#sec-smil-seq-elem"><code>seq</code></a> and <a
-							data-cite="epub/#sec-smil-seq-elem"><code>par</code></a> elements [[epub]]. These semantics
-						are what allow <a data-cite="epub/#dfn-epub-reading-system">reading systems</a> to provide users
-						the option to escape their playback sequences.</p>
+							data-cite="epub/#sec-smil-seq-elem"><code>par</code></a> elements [[epub-3]]. These
+						semantics are what allow <a data-cite="epub/#dfn-epub-reading-system">reading systems</a> to
+						provide users the option to escape their playback sequences.</p>
 
 					<p>It is strongly advised to identify the following structures for escapability:</p>
 
@@ -1579,7 +1587,7 @@ <h4>Identifying escapable structures</h4>
 
 					<div class="note">
 						<p>Identifying nested escapable structures is not advised at this time. Refer to <a
-								data-cite="epub/#sec-escapability">Escapability</a> [[epub]] for more information.</p>
+								data-cite="epub/#sec-escapability">Escapability</a> [[epub-3]] for more information.</p>
 					</div>
 
 					<aside class="example" title="Identifying an escapable list">