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

Tweaks to 1627 #1635

Merged
merged 4 commits into from
Apr 12, 2021
Merged

Tweaks to 1627 #1635

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
e4c597a
add link/reference to rs spec;
mattgarrish Apr 12, 2021
ae367e0
fix links
mattgarrish Apr 12, 2021
826594f
remove nested ul in change log
mattgarrish Apr 12, 2021
e199846
Merge branch 'css-dir-property-issue-1614' into editorial/issue-1614
mattgarrish Apr 12, 2021
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
59 changes: 38 additions & 21 deletions epub33/core/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4045,25 +4045,22 @@ <h4>Introduction</h4>
<section id="sec-css-req">
<h4>CSS Requirements</h4>

<p>A CSS style sheets has to meet the following requirements:</p>
<p>A CSS style sheet has to meet the following requirements:</p>

<ul class="conformance-list">
<li>
<p id="confreq-css-props">It MAY include any CSS properties, with the following
exceptions:</p>
<ul class="conformance-list">
<li>
<p id="confreq-css-props-exc-direction">It MUST NOT use the <a
href="https://www.w3.org/TR/css3-writing-modes/#direction"><code>direction</code> property</a> [[!CSS-Writing-Modes-3]] for [[!HTML]] or [[!SVG]] Content Documents. Use the [[!HTML]] <a href="https://html.spec.whatwg.org/multipage/dom.html#the-dir-attribute"><code>dir</code> attribute</a>,
respectively the [[!SVG]] <a href="https://www.w3.org/TR/SVG2/text.html#DirectionProperty"><code>direction</code> attribute</a>, to set the
inline base direction.
</p>
<p id="confreq-css-props-exc-direction">It MUST NOT include the <a
href="https://www.w3.org/TR/css3-writing-modes/#direction"
><code>direction</code> property</a> [[!CSS-Writing-Modes-3]].</p>
</li>
<li>
<p id="confreq-css-props-exc-unicode-bidi">It MUST NOT use the <a
href="https://www.w3.org/TR/css3-writing-modes/#unicode-bidi"><code>unicode-bidi</code> property</a> [[!CSS-Writing-Modes-3]] for [[!HTML]] Content Documents. Use the [[!HTML]] <a href="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-bdo-element"><code>bdo</code> element</a>
and the <a href="https://html.spec.whatwg.org/multipage/dom.html#the-dir-attribute"><code>dir</code> attribute</a> to control bidirectionality.
</p>
<p id="confreq-css-props-exc-unicode-bidi">It MUST NOT include the <a
href="https://www.w3.org/TR/css3-writing-modes/#unicode-bidi"
><code>unicode-bidi</code> property</a> [[!CSS-Writing-Modes-3]].</p>
</li>
<li>
<p id="confreq-css-props-exc-unicode-bidi-svg">It MUST NOT use the <a
Expand All @@ -4075,16 +4072,39 @@ <h4>CSS Requirements</h4>
</ul>
</li>
<li>
<p id="confreq-css-prefixed">It MAY include the prefixed properties defined in <a href="#sec-css-prefixed"></a>.</p>
<p id="confreq-css-prefixed">It MAY include the prefixed properties defined in <a
href="#sec-css-prefixed"></a>.</p>
</li>
<li>
<p id="confreq-css-encoding">It MUST be encoded in UTF-8 or UTF-16 [[!Unicode]].</p>
</li>
</ul>

<p class=note>
The reason of the restrictions on the <code>direction</code> and the <code>unicode-bidi</code> properties is the fact that Reading Systems may not implement, or may switch off, CSS processing.
</p>
<div class="note">
<p>The use of the <code>direction</code> and <code>unicode-bidi</code> properties is restricted
because Reading Systems may not implement, or may switch off, CSS processing. EPUB Creators
must use the following format-specific methods when control over these aspects of the
rendering is needed:</p>

<ul>
<li>
<p>the <a href="https://html.spec.whatwg.org/multipage/dom.html#the-dir-attribute"
><code>dir</code> attribute</a> [[!HTML]] and <a
href="https://www.w3.org/TR/SVG/text.html#DirectionProperty"
><code>direction</code> attribute</a> [[!SVG]] for inline base
directionality.</p>
</li>
<li>
<p>the <a
href="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-bdo-element"
><code>bdo</code> element</a> with the <a
href="https://html.spec.whatwg.org/multipage/dom.html#the-dir-attribute"
><code>dir</code> attribute</a> [[!HTML]] and the <a
href="https://www.w3.org/TR/SVG/styling.html#PresentationAttributes"
><code>unicode-bidi</code> attribute</a> [[!SVG]] for bidirectionality.</p>
</li>
</ul>
</div>
</section>

<section id="sec-css-prefixed">
Expand Down Expand Up @@ -9364,13 +9384,10 @@ <h3>Substantive Changes since the <a href="https://www.w3.org/TR/2021/WD-epub-33
-->

<ul>
<ul>
<li>12-Apr-2021: Added a reference to the SVG <code>direction</code> attribute in
<a href="#sec-css-req"></a>.
See <a href="https://github.com/w3c/epub-specs/issues/1613">issue 1614</a>.
</li>
</ul>
</ul>
<li>12-Apr-2021: Added a reference to the SVG <code>direction</code> attribute in <a
href="#sec-css-req"></a>. See <a href="https://github.com/w3c/epub-specs/issues/1613">issue
1614</a>.</li>
</ul>
</section>

<section id="changes-older">
Expand Down
32 changes: 16 additions & 16 deletions epub33/rs/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -483,11 +483,11 @@ <h3>Collections</h3>
<section id="sec-contentdocs">
<h2>Content Document Processing</h2>

<p>
The definition of EPUB Content Documents includes various authoring restrictions to optimize the cross-compatibility of
content (e.g., <a href="https://www.w3.org/TR/epub-33/#sec-css-req">prohibiting CSS for setting language and direction</a>).
<strong>Unless stated otherwise in this specification, Reading Systems MAY support these restricted features</strong>.
</p>
<p>The definition of <a href="https://www.w3.org/TR/epub-33/#sec-contentdocs">EPUB Content Documents</a>
[[!EPUB-33]] includes various authoring restrictions to optimize the cross-compatibility of content
(e.g., <a href="https://www.w3.org/TR/epub-33/#sec-css-req">prohibiting CSS for setting language and
direction</a> [[EPUB-33]]). Unless stated otherwise in this specification, Reading Systems MAY support these
restricted features.</p>

<section id="sec-xhtml">
<h3>XHTML Content Documents</h3>
Expand Down Expand Up @@ -632,7 +632,8 @@ <h3>MathML</h3>
<code>annotation-xml</code> elements.</p>
</li>
<li>
<p id="confreq-mathml-rs-render">MUST, if it has a <a>Viewport</a>, support visual rendering of Presentation MathML.</p>
<p id="confreq-mathml-rs-render">MUST, if it has a <a>Viewport</a>, support visual
rendering of Presentation MathML.</p>
</li>
</ul>
<p class="note">Reading Systems may choose to use third-party libraries such as MathJax to
Expand Down Expand Up @@ -696,12 +697,12 @@ <h3>SVG Content Documents</h3>
href="#sec-scripted-content"></a>.</p>
</li>
<li>
<p id="confreq-svg-rs-css">MUST, if it has a <a>Viewport</a>, support the visual rendering of SVG using CSS as defined in <a
href="https://www.w3.org/TR/SVG/styling.html">Styling</a> [[!SVG]] and it SHOULD support
all properties defined in the <a href="https://www.w3.org/TR/SVG/propidx.html">Property
Index</a> [[!SVG]]. In the case of embedded SVG, a Reading
System MUST also conform to the constraints defined in <a href="#sec-xhtml-svg-css"
></a>.</p>
<p id="confreq-svg-rs-css">MUST, if it has a <a>Viewport</a>, support the visual rendering of
SVG using CSS as defined in <a href="https://www.w3.org/TR/SVG/styling.html">Styling</a>
[[!SVG]] and it SHOULD support all properties defined in the <a
href="https://www.w3.org/TR/SVG/propidx.html">Property Index</a> [[!SVG]]. In the case
of embedded SVG, a Reading System MUST also conform to the constraints defined in <a
href="#sec-xhtml-svg-css"></a>.</p>
</li>
<li>
<p id="confreq-svg-rs-text">SHOULD support user selection and searching of text within SVG
Expand Down Expand Up @@ -2060,10 +2061,9 @@ <h3>Substantive Changes since the <a href="https://www.w3.org/TR/2021/WD-epub-rs
-->

<ul>
<li>09-Apr-2021: Added section clarifying all the conformance requirements on
establishing the primary language and base direction of Publication Resources.
See <a href="https://github.com/w3c/epub-specs/pull/1613">pull request 1613</a>.
</li>
<li>09-Apr-2021: Added section clarifying all the conformance requirements on establishing the
primary language and base direction of Publication Resources. See <a
href="https://github.com/w3c/epub-specs/pull/1613">pull request 1613</a>. </li>
</ul>
</section>

Expand Down