Skip to content

Commit

Permalink
Merge branch 'main' into editorial/issue-2200
Browse files Browse the repository at this point in the history
  • Loading branch information
@mattgarrish
mattgarrish authored Apr 6, 2022
2 parents 943066f + 1287600 commit e81e90c
Show file tree
Hide file tree
Showing 8 changed files with 437 additions and 337 deletions.
6 changes: 3 additions & 3 deletions epub33/a11y-tech/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1341,9 +1341,9 @@ <h4>Language of the EPUB Publication</h4>

<p>Although it is not strictly required to set this information to meet [[WCAG2]] <a
href="https://www.w3.org/TR/WCAG2/#language-of-page">Success Criterion 3.1.1</a>, as it is
only informative, it should be considered a best practice to always set this field with the
proper language information. (Note that EPUB3 requires the language always be specified, so
omitting will fail validation requirements.)</p>
non-normative, it should be considered a best practice to always set this field with the proper
language information. (Note that EPUB3 requires the language always be specified, so omitting
will fail validation requirements.)</p>

<p>Although Reading Systems do not use this language information to render the text content of the
EPUB Publication, they do use it to optimize the reading experience for users (e.g., to preload
Expand Down
304 changes: 186 additions & 118 deletions epub33/a11y/index.html
View file

Large diffs are not rendered by default.

310 changes: 170 additions & 140 deletions epub33/core/index.html
View file

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion epub33/core/vocab/meta-property.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h3>Meta Properties Vocabulary</h3>
augmented.</p>

<p>The prefix URL for <a href="#sec-default-vocab">referencing these properties</a> is
<code>http://idpf.org/epub/vocab/package/meta/#</code>.</p>
<code>http://idpf.org/epub/vocab/package/meta/#</code>.</p>

<section id="sec-alternate-script">
<h5>alternate-script</h5>
Expand Down
12 changes: 7 additions & 5 deletions epub33/multi-rend/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -455,8 +455,8 @@ <h3>Content Conformance</h3>
<li id="confreq-selection-attr">MAY include any of the selection attributes defined in <a
href="#rendition-selection-attr">Rendition Selection Attributes</a>.</li>
<li id="confreq-selection-default">MAY Include selection attributes on the <a
data-cite="epub-33#sec-container.xml-rootfiles-elem"><code>rootfile</code> element</a> [[EPUB-33]]
for the <a>Default Rendition</a></li>
data-cite="epub-33#sec-container.xml-rootfiles-elem"><code>rootfile</code> element</a>
[[EPUB-33]] for the <a>Default Rendition</a></li>
<li id="confreq-selection-min">SHOULD include at least one selection attribute ‒ in addition to the
OPTIONAL label ‒ on each subsequent <code>rootfile</code> element.</li>
</ul>
Expand Down Expand Up @@ -937,7 +937,8 @@ <h3>Content Conformance</h3>

<ul class="conformancelist">
<li id="confreq-map-xhtml">MUST conform to all content conformance constraints for XHTML Content
Documents as defined in <a data-cite="epub-33#sec-xhtml-req">XHTML Requirements</a> [[EPUB-33]].</li>
Documents as defined in <a data-cite="epub-33#sec-xhtml-req">XHTML Requirements</a>
[[EPUB-33]].</li>
<li id="confreq-map-content-model">MUST conform to all content conformance constraints specific for
EPUB Rendition Mapping Documents expressed in <a href="#rendition-mapping-doc-def">EPUB
Rendition Mapping Document Definition</a>.</li>
Expand Down Expand Up @@ -1193,8 +1194,9 @@ <h4>Container Identification</h4>
<section id="rendition-mapping-proc-model" class="informative">
<h3>Processing Model</h3>

<p>This section provides an informative model by which the Rendition Mapping Document could be processed
by a Reading System. It does not address how or when a Reading System should switch Renditions. </p>
<p>This section provides a non-normative model by which the Rendition Mapping Document could be
processed by a Reading System. It does not address how or when a Reading System should switch
Renditions. </p>

<p>The desired outcome of the Rendition Mapping Document's mapping capabilities is to display content in
the new Rendition that is equivalent to their location in the current Rendition, so that a user
Expand Down
118 changes: 59 additions & 59 deletions epub33/overview/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,7 @@
<body>
<section id="abstract">
<p>This document provides a starting point for content authors and software developers wishing to understand
the EPUB® 3 specifications. It consists entirely of informative overview material that describes the
the EPUB® 3 specifications. It consists entirely of non-normative overview material that describes the
features available in EPUB 3.</p>

</section>
Expand Down Expand Up @@ -109,27 +109,28 @@ <h2>Documents</h2>
<dt> Working Group Notes: </dt>
<dd>
<ul>
<li>EPUB Accessibility - EU Accessibility Act Mapping [[EPUB-A11Y-EAA-MAPPING]]: aims to demonstrate
that the technical requirements of the <a href="https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32019L0882">European Accessibility Act</a> related to ebooks are met
by the EPUB standard.</li>
<li>EPUB Accessibility - EU Accessibility Act Mapping [[EPUB-A11Y-EAA-MAPPING]]: aims to
demonstrate that the technical requirements of the <a
href="https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32019L0882">European
Accessibility Act</a> related to ebooks are met by the EPUB standard.</li>
<li>EPUB Accessibility Techniques 1.1 [[EPUB-A11Y-TECH-11]]: provides guidance on how to meet
the EPUB Accessibility 1.1 [[EPUB-A11Y-11]] discovery and accessibility requirements for EPUB
Publications. </li>
the EPUB Accessibility 1.1 [[EPUB-A11Y-11]] discovery and accessibility requirements for
EPUB Publications. </li>
<li>EPUB Multiple-Rendition Publications 1.1 [[EPUB-MULTI-REND-11]]: defines the creation and
rendering of EPUB Publications consisting of more than one Rendition. </li>
<li>EPUB 3 Structural Semantics Vocabulary 1.1 [[EPUB-SSV-11]]: defines a set of properties relating to the description of structural semantics of written works.</li>
<li>EPUB 3 Structural Semantics Vocabulary 1.1 [[EPUB-SSV-11]]: defines a set of properties
relating to the description of structural semantics of written works.</li>
<li>EPUB 3 Text-to-Speech Enhancements 1.0 [[EPUB-TTS-10]]: describes authoring features and
reading system support for improving the voicing of EPUB 3 publications. </li>
</ul>
</dd>
</dl>
<p>This overview document concentrates on the authoring format of EPUB 3.3.</p>

<div class="note">
The recommendation-track documents include detailed change logs on the substantive changes since the previous official releases. See the change log for
<a data-cite="epub-33#change-log">EPUB 3.3</a>, <a data-cite="epub-rs-33#change-log">EPUB Reading Systems 3.3</a>, and <a data-cite="epub-a11y-11#change-log">EPUB Accessibility 1.1</a>,
respectively.
</div>
<div class="note"> The recommendation-track documents include detailed change logs on the substantive
changes since the previous official releases. See the change log for <a data-cite="epub-33#change-log"
>EPUB 3.3</a>, <a data-cite="epub-rs-33#change-log">EPUB Reading Systems 3.3</a>, and <a
data-cite="epub-a11y-11#change-log">EPUB Accessibility 1.1</a>, respectively. </div>

</section>
<section id="sec-features">
Expand Down Expand Up @@ -174,14 +175,13 @@ <h2>Package Document</h2>
><code>collection</code> element</a> [[EPUB-33]], which allows grouping of logically related
<a>Publication Resources</a>. This element exists to enable the development of specialized
content identification, processing, and rendering features such as the ability to define embedded
preview content or assemble an index or dictionary from its constituent XHTML Content
Documents.</p>
preview content or assemble an index or dictionary from its constituent XHTML Content Documents.</p>

<p class="note"> The <code>collection</code> element is not currently used in any specifications that are
actively maintained by the EPUB 3 Working Group. </p>
<p class="note"> The <code>collection</code> element is not currently used in any specifications that
are actively maintained by the EPUB 3 Working Group. </p>

<p>The Package Document is specified in the dedicated <a data-cite="epub-33#sec-package-doc"
>section</a> of [[EPUB-33]].</p>
<p>The Package Document is specified in the dedicated <a data-cite="epub-33#sec-package-doc">section</a>
of [[EPUB-33]].</p>
</section>

<section id="sec-nav">
Expand Down Expand Up @@ -230,12 +230,13 @@ <h3>Navigation Document</h3>

<p>Note that EPUB Reading Systems are not <em>required</em> to use these advanced XHTML features,
such as ruby annotations, when generating a Reading System specific table of contents. However,
EPUB Creators may also include the Navigation Document in the <a data-cite="epub-33#sec-spine-elem"
>spine</a> [[EPUB-33]] to make use of the richer markup.</p>
EPUB Creators may also include the Navigation Document in the <a
data-cite="epub-33#sec-spine-elem">spine</a> [[EPUB-33]] to make use of the richer
markup.</p>

<p>Navigation Documents also provide a flexible means of tailoring the navigation display using CSS
and the <a data-cite="epub-33#sec-nav-doc-use-spine"><code>hidden</code> attribute</a> [[EPUB-33]]
while not impacting access to information for accessible Reading Systems.</p>
and the <a data-cite="epub-33#sec-nav-doc-use-spine"><code>hidden</code> attribute</a>
[[EPUB-33]] while not impacting access to information for accessible Reading Systems.</p>

<p>The structure and semantics of Navigation Documents are defined in the dedicated <a
data-cite="epub-33#sec-nav">section</a> of [[EPUB-33]].</p>
Expand Down Expand Up @@ -445,9 +446,9 @@ <h1>Global Language Support</h1>

<p> EPUB 3 leverages the features in XHTML, SVG, CSS, or MathML for global language support, and it also
relies on [[Unicode]] for encoding the content. This means that content documents in EPUB 3 have the
possibility to use different character sets and express bidirectional text, ruby annotations, or typography
for many different languages and cultures. Features have also been added to the various components
defined by EPUB 3 to ensure language support. </p>
possibility to use different character sets and express bidirectional text, ruby annotations, or
typography for many different languages and cultures. Features have also been added to the various
components defined by EPUB 3 to ensure language support. </p>

<section id="sec-gls-metadata">
<h2>Metadata</h2>
Expand Down Expand Up @@ -533,11 +534,11 @@ <h2>Navigation</h2>
flexible navigation system.</p>

<p>The Navigation Document can also be reused in the body of an EPUB Publication by including it in the
<a data-cite="epub-33#sec-spine-elem"><code>spine</code></a>. To avoid the situation in
highly structured documents where it might not be desirable to display the complete table of contents to
<a data-cite="epub-33#sec-spine-elem"><code>spine</code></a>. To avoid the situation in highly
structured documents where it might not be desirable to display the complete table of contents to
users in the body of the publication, the display level can be modified using the <a
data-cite="epub-33#sec-nav-doc-use-spine"><code>hidden</code> attribute</a> [[EPUB-33]]. This attribute is
ignored by Reading Systems when they render the table of contents outside the <a
data-cite="epub-33#sec-nav-doc-use-spine"><code>hidden</code> attribute</a> [[EPUB-33]]. This
attribute is ignored by Reading Systems when they render the table of contents outside the <a
data-cite="epub-33#sec-spine-elem"><code>spine</code></a> (e.g., in their own specialized
views), which avoids minimizing the information that is available.</p>

Expand All @@ -561,27 +562,27 @@ <h2>Semantic Markup</h2>
[[DPUB-ARIA-1.0]] roles, enhancing the ability of Assistive Technologies to interact with the
content.</p>

<p>EPUB 3 also includes the <code>epub:type</code> attribute, which allows the inclusion of additional information
to any element in an EPUB Content Document to express its purpose and meaning within the
work. Refer to the section on <a data-cite="epub-33#app-structural-semantics">Expressing Structural Semantics</a> [EPUB-33]
for more information.</p>
<p>EPUB 3 also includes the <code>epub:type</code> attribute, which allows the inclusion of additional
information to any element in an EPUB Content Document to express its purpose and meaning within the
work. Refer to the section on <a data-cite="epub-33#app-structural-semantics">Expressing Structural
Semantics</a> [EPUB-33] for more information.</p>
</section>

<section id="sec-access-layout">
<h2>Dynamic Layouts</h2>

<p>At its core, EPUB is designed for dynamic layout: content is typically intended to be formatted on
the fly rather than being typeset in a paginated manner in advance. This core capability is useful
for optimizing rendering onto different-sized device screens or window sizes, and it facilitates
and simplifies content accessibility.</p>
for optimizing rendering onto different-sized device screens or window sizes, and it facilitates and
simplifies content accessibility.</p>

<p>While it is possible to incorporate more highly formatted content in EPUB — for example via bitmap
images or SVG graphics, or even use of CSS explicit positioning and/or table elements to achieve
particular visual layouts — EPUB Creators are strongly discouraged from utilizing such techniques.
These techniques are not reliable in EPUB since many Reading Systems render content in a
paginated manner rather than creating a single scrolling <a>Viewport</a> and since each Reading System
might define its own pagination algorithm. In general, it is preferable to achieve visual richness by
using CSS Style Sheets without absolute sizing or positioning.</p>
These techniques are not reliable in EPUB since many Reading Systems render content in a paginated
manner rather than creating a single scrolling <a>Viewport</a> and since each Reading System might
define its own pagination algorithm. In general, it is preferable to achieve visual richness by
using CSS Style Sheets without absolute sizing or positioning.</p>

<p class="ednote"> If and when the WG publishes a fxl accessibility note then it is worth referring to
it from here </p>
Expand All @@ -591,13 +592,14 @@ <h2>Dynamic Layouts</h2>
<h2>Aural Renditions and Media Overlays</h2>

<p>Aural renderings of content are important for accessibility and are a desirable feature for many
users. A baseline to facilitate aural rendering is to utilize semantic HTML designed for
dynamic layout. Refer to <a href="#sec-tts"></a> for more information on how to use the native
facilities that XHTML Content Documents include.</p>
users. A baseline to facilitate aural rendering is to utilize semantic HTML designed for dynamic
layout. Refer to <a href="#sec-tts"></a> for more information on how to use the native facilities
that XHTML Content Documents include.</p>

<p><a data-cite="epub-33#sec-media-overlays">Media Overlays</a> [[EPUB-33]] provide the ability to
synchronize the text and audio content of an EPUB Publication. Beyond benefiting accessibility,
overlays have other applications, e.g., synchronizing text and audio as a tool for learning to read.</p>
overlays have other applications, e.g., synchronizing text and audio as a tool for learning to
read.</p>
</section>

<!-- <section id="sec-access-fallbacks">
Expand Down Expand Up @@ -642,14 +644,12 @@ <h3>OEB, OCF and EPUB 2: 1999—2010</h3>

<p>It was realized that a need existed for a format standard that could be used for delivery as well as
interchange, and work began in late 2005 on a single-file container format for OEPBS, which was
approved by the IDPF as the OEBPS Container Format (OCF) in 2006.

Work on a 2.0 revision of OEBPS began in parallel which was renamed EPUB 2.0 in October 2007 and approved in
September 2010. This revision consisted of a triumvirate of specifications: Open Package Format (OPF),
Open Publication Format (OPF), and OCF. EPUB 2.0.1, which was a maintenance update to the 2.0 specification
set, primarily intended to clarify and correct errata in the specifications. See [[OPF-201]] [[OPS-201]]
[[OCF-201]].
</p>
approved by the IDPF as the OEBPS Container Format (OCF) in 2006. Work on a 2.0 revision of OEBPS
began in parallel which was renamed EPUB 2.0 in October 2007 and approved in September 2010. This
revision consisted of a triumvirate of specifications: Open Package Format (OPF), Open Publication
Format (OPF), and OCF. EPUB 2.0.1, which was a maintenance update to the 2.0 specification set,
primarily intended to clarify and correct errata in the specifications. See [[OPF-201]] [[OPS-201]]
[[OCF-201]]. </p>

</section>
<section id="epub30">
Expand All @@ -658,12 +658,12 @@ <h3>EPUB 3.0: 2010</h3>
<p>Work on a major revision of the EPUB specifications began in 2010, with the goal of aligning EPUB
more closely with HTML, and in the process bringing new, native multimedia features, sophisticated
CSS layout rendering and font embedding, scripted interactivity, enhanced global language support,
and improved accessibility. A new specification for EPUB Media Overlays was also introduced, allowing for
text and audio synchronization in EPUB Publications. To better align the specification names with
the standard, the Open Package Format specification was renamed EPUB Publications and the Open
Publication Format specification was renamed EPUB Content Documents. The EPUB 3.0 specifications
were approved in October 2011. See [[EPUBPublications-30]] [[EPUBContentDocs-30]] [[OCF-30]]
[[EPUBMediaOverlays-30]] [[EPUBChanges-30]].</p>
and improved accessibility. A new specification for EPUB Media Overlays was also introduced,
allowing for text and audio synchronization in EPUB Publications. To better align the specification
names with the standard, the Open Package Format specification was renamed EPUB Publications and the
Open Publication Format specification was renamed EPUB Content Documents. The EPUB 3.0
specifications were approved in October 2011. See [[EPUBPublications-30]] [[EPUBContentDocs-30]]
[[OCF-30]] [[EPUBMediaOverlays-30]] [[EPUBChanges-30]].</p>
</section>

<section id="epub301">
Expand All @@ -683,8 +683,8 @@ <h3>EPUB 3.1: 2017</h3>
is always valid to use; a revision of EPUB is not needed). The use of CSS was also clarified, and
the use of EPUB-specific properties reduced.</p>
<p>Many EPUB-specific features were also removed from the standard, in particular content switching,
triggers, and bindings. This change necessitated a new Package Document version number. See [[EPUB-31]]
[[EPUBPackages-31]] [[EPUBContentDocs-31]] [[OCF-31]] [[EPUBMediaOverlays-31]]
triggers, and bindings. This change necessitated a new Package Document version number.
See [[EPUB-31]] [[EPUBPackages-31]] [[EPUBContentDocs-31]] [[OCF-31]] [[EPUBMediaOverlays-31]]
[[EPUBChanges-31]]</p>
</section>

Expand Down
Loading

0 comments on commit e81e90c

Please sign in to comment.