Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add reading system conformance section #2305

Merged
merged 8 commits into from
May 31, 2022
Merged

Add reading system conformance section #2305

Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
5d7a4ce
add reading system conformance section
mattgarrish May 20, 2022
4f0cec5
add change log entry
mattgarrish May 20, 2022
a2b7071
Update epub33/rs/index.html
mattgarrish May 20, 2022
519dcae
Update epub33/rs/index.html
mattgarrish May 20, 2022
886a687
rewrite to remove support ambiguity around supporting recommended/opt…
mattgarrish May 22, 2022
ced7ae3
Merge branch 'feature/rs-conformance' of https://github.com/w3c/epub-…
mattgarrish May 22, 2022
3c39fa0
Merge branch 'main' into feature/rs-conformance
mattgarrish May 27, 2022
64e2799
Merge branch 'main' into feature/rs-conformance
mattgarrish May 31, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions epub33/rs/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -219,6 +219,29 @@ <h4>Relationship to SVG</h4>
</section>
</section>
</section>
<section id="sec-rs-conformance">
<h3>Reading system conformance</h3>

<p>Whether a reading system has to support a feature is mentioned at the beginning of its section. To be
conformant with this specification, reading systems MUST support all required features as well as all
applicable conditionally-required features (e.g., to support image rendering if the reading system has a
mattgarrish marked this conversation as resolved.
Show resolved Hide resolved
mattgarrish marked this conversation as resolved.
Show resolved Hide resolved
[=viewport=]) as defined in their respective sections.</p>

<p>When supporting recommended and optional features, reading systems MUST meet all normative requirements
as defined in their respective sections.</p>

<p>When reading system developers opt not to support a recommended or optional feature, it does not always
mean none of the normative requirements of the section apply. In some cases, there may be alternative
requirements when not implementing a feature (e.g., to <a href="#confreq-rs-scripted-flbk">process
fallbacks</a> when scripting is not supported). Reading systems MUST meet these alternative
requirements when not supporting a feature.</p>

<div class="note">
<p>EPUB publications frequently contain information not required by this specification (e.g., [=package
document=] metadata). Reading systems may use this additional information for any purposes (e.g., to
improve the user interface).</p>
</div>
</section>
<section id="sec-pub-resources">
<h3>Publication resource processing</h3>

Expand Down Expand Up @@ -2541,6 +2564,8 @@ <h2>Change log</h2>
>Working Group's issue tracker</a>.</p>

<ul>
<li>27-May-2022: Added reading system conformance section. See <a
href="https://github.com/w3c/epub-specs/issues/2271">issue 2271</a>.</li>
<li>27-May-2022: Added recommendation to only load remote resources referenced via https. See <a
href="https://github.com/w3c/epub-specs/issues/2263">issue 2263</a>.</li>
<li>20-May-2022: Removed the recommendation to prevent access to persistent storage from "unrelated
Expand Down