Skip to content

Commit f0751b1

Browse files
ihermaniherman
committed
deprecated the rendition:orientation property
1 parent 9f042dc commit f0751b1

File tree

3 files changed

+27
-144
lines changed

3 files changed

+27
-144
lines changed

‎epub34/authoring/index.html‎

Lines changed: 11 additions & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -7421,87 +7421,6 @@ <h6>Layout overrides</h6>
74217421
</section>
74227422
</section>
74237423

7424-
<section id="orientation" data-epubcheck="true"
7425-
data-tests="https://w3c.github.io/epub-structural-tests/#08-layout_layout.feature_L74,https://w3c.github.io/epub-structural-tests/#08-layout_layout.feature_L79,https://w3c.github.io/epub-structural-tests/#08-layout_layout.feature_L86,https://w3c.github.io/epub-structural-tests/#08-layout_layout.feature_L93">
7426-
<h5>Orientation</h5>
7427-
7428-
<p>The <code>rendition:orientation</code> property specifies which orientation the [=EPUB
7429-
publication=] is intended to be rendered in. </p>
7430-
7431-
<p id="property-orientation-global">When the <a href="#orientation"
7432-
><code>rendition:orientation</code> property</a> is specified on a [^meta^] element,
7433-
it indicates that the intended orientation applies globally (i.e., for all [=EPUB spine |
7434-
spine=] items).</p>
7435-
7436-
<p>One of the following values MUST be used with the <code>rendition:orientation</code>
7437-
property:</p>
7438-
7439-
<dl class="variablelist">
7440-
<dt>landscape</dt>
7441-
<dd>
7442-
<p>Render the content in landscape orientation.</p>
7443-
</dd>
7444-
7445-
<dt>portrait</dt>
7446-
<dd>
7447-
<p>Render the content in portrait orientation.</p>
7448-
</dd>
7449-
7450-
<dt>auto</dt>
7451-
<dd>
7452-
<p>The content is not orientation constrained. Default value.</p>
7453-
</dd>
7454-
</dl>
7455-
7456-
<p id="fxl-orientation-duplication">The <code>rendition:orientation</code> property MUST NOT be
7457-
declared more than once. In addition, it MUST NOT be declared using the <a
7458-
href="#attrdef-refines"><code>refines</code> attribute</a>. Refer to <a
7459-
href="#orientation-overrides"></a> for setting the property for individual [=EPUB
7460-
content documents=].</p>
7461-
7462-
<aside class="example" id="fxl-ex2" title="Specifying global landscape orientation">
7463-
<p>In this example, items in the spine are to be rendered in landscape mode.</p>
7464-
7465-
<pre>&lt;package …&gt;
7466-
&lt;metadata …&gt;
7467-
…
7468-
&lt;meta
7469-
property="rendition:layout"&gt;
7470-
pre-paginated
7471-
&lt;/meta&gt;
7472-
7473-
&lt;meta
7474-
property="rendition:orientation"&gt;
7475-
landscape
7476-
&lt;/meta&gt;
7477-
&lt;/metadata&gt;
7478-
…
7479-
&lt;/package&gt;</pre>
7480-
</aside>
7481-
7482-
<section id="orientation-overrides" data-epubcheck="true"
7483-
data-tests="https://w3c.github.io/epub-structural-tests/#08-layout_layout.feature_L102,https://w3c.github.io/epub-structural-tests/#08-layout_layout.feature_L107">
7484-
<h6>Orientation overrides</h6>
7485-
7486-
<p id="property-orientation-local">The following properties MAY be specified on [=EPUB spine
7487-
| spine=] [^itemref^] elements to override the <a href="#property-orientation-global"
7488-
>global value</a>:</p>
7489-
7490-
<dl>
7491-
<dt id="orientation-auto">rendition:orientation-auto</dt>
7492-
<dd>The [=reading system=] determines the orientation to render the spine item in.</dd>
7493-
7494-
<dt id="orientation-landscape">rendition:orientation-landscape</dt>
7495-
<dd>Render the given spine item in landscape orientation.</dd>
7496-
7497-
<dt id="orientation-portrait">rendition:orientation-portrait</dt>
7498-
<dd>Render the given spine item in portrait orientation.</dd>
7499-
</dl>
7500-
7501-
<p>A spine item MUST NOT declare more than one of these overrides.</p>
7502-
</section>
7503-
</section>
7504-
75057424
<section id="spread" data-epubcheck="true"
75067425
data-tests="https://w3c.github.io/epub-structural-tests/#08-layout_layout.feature_L117,https://w3c.github.io/epub-structural-tests/#08-layout_layout.feature_L122,https://w3c.github.io/epub-structural-tests/#08-layout_layout.feature_L129,https://w3c.github.io/epub-structural-tests/#08-layout_layout.feature_L136,https://w3c.github.io/epub-structural-tests/#08-layout_layout.feature_L143,https://w3c.github.io/epub-structural-tests/#08-layout_layout.feature_L178">
75077426
<h5>Synthetic spreads</h5>
@@ -11073,6 +10992,13 @@ <h3>Deprecated features</h3>
1107310992
href="https://www.w3.org/publishing/epub32/epub-packages.html#sec-collection-elem"
1107410993
>new collection types</a> [[epubpackages-32]]</p>
1107510994
</li>
10995+
10996+
<li>
10997+
<p id="orientation"><a href="https://www.w3.org/TR/epub-33/#orientation">
10998+
<code>rendition:orientation</code></a> and
10999+
<a href="https://www.w3.org/TR/epub-33/#orientation-overrides">orientation overrides</a>
11000+
properties [[epub-33]]</p>
11001+
</li>
1107611002
</ul>
1107711003
</dd>
1107811004

@@ -11547,6 +11473,10 @@ <h2>Change log</h2>
1154711473
<details id="changes-epub-33" open="open">
1154811474
<summary>Substantive changes since <a href="https://www.w3.org/TR/epub-33/">EPUB 3.3</a></summary>
1154911475
<ul>
11476+
<li>10-Nov-2025: Deprecated the <code>rendition:orientation</code> property, as well as
11477+
its override equivalents. See <a href="https://github.com/w3c/epub-specs/issues/2751">issue 2751</a>, and
11478+
the related <a href="https://w3c.github.io/pm-wg/minutes/2025-11-10-f2f.html#3397">Working Group resolution</a>.
11479+
</li>
1155011480
<li>10-Oct-2025: Added caution that SHA-1 is being phased out so other methods of protecting fonts
1155111481
than the font obfuscation are advised. See <a
1155211482
href="https://github.com/w3c/epub-specs/issues/2807">issue 2807</a>.</li>

‎epub34/authoring/vocab/rendering.html‎

Lines changed: 15 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,22 @@
11
<section id="app-rendering-vocab">
22
<h3>Package rendering vocabulary</h3>
3-
3+
44
<p>The prefix URL for <a href="#sec-default-vocab">referencing these properties</a> is
55
<code>http://www.idpf.org/vocab/rendition/#</code>.</p>
6-
6+
77
<p>The "<code>rendition:</code>" prefix is <a href="#sec-metadata-reserved-prefixes">reserved for
88
use</a> with the package rendering properties and does not have to be declared in the
99
[=package document=].</p>
10-
10+
1111
<div class="note">
1212
<p>Unlike the other vocabularies in this appendix, the properties in the Package Rendering Vocabulary
1313
consist of a mix of properties (expressed in [^meta^] elements)
1414
and [=EPUB spine | spine=] overrides (expressed on [^itemref^] elements).</p>
15-
15+
1616
<p>The usage requirements are also defined in <a href="#sec-rendering-control"></a> not in this appendix.
1717
The following table provides a map to the properties, overrides, and where they are defined.</p>
1818
</div>
19-
19+
2020
<table class="tabledef">
2121
<thead>
2222
<tr>
@@ -36,17 +36,6 @@ <h3>Package rendering vocabulary</h3>
3636
</td>
3737
<td><a href="#layout"></a></td>
3838
</tr>
39-
<tr>
40-
<td><code>rendition:orientation</code></td>
41-
<td>
42-
<ul>
43-
<li><code>rendition:orientation-auto</code></li>
44-
<li><code>rendition:orientation-landscape</code></li>
45-
<li><code>rendition:orientation-portrait</code></li>
46-
</ul>
47-
</td>
48-
<td><a href="#orientation"></a></td>
49-
</tr>
5039
<tr>
5140
<td><code>rendition:spread</code></td>
5241
<td>
@@ -93,20 +82,20 @@ <h3>Package rendering vocabulary</h3>
9382
</tr>
9483
</tbody>
9584
</table>
96-
85+
9786
<section id="sec-rendering-custom-properties" data-epubcheck="true" data-tests="https://w3c.github.io/epub-structural-tests/#D-vocabularies_package-rendering-vocab.feature_L19">
9887
<h4>Custom rendering properties</h4>
99-
100-
<p>Custom properties and [=EPUB spine | spine=] overrides can be included in the
101-
[=package document=] to address rendering issues specific to particular
88+
89+
<p>Custom properties and [=EPUB spine | spine=] overrides can be included in the
90+
[=package document=] to address rendering issues specific to particular
10291
[=reading systems=], as defined by the developers of those reading systems.</p>
103-
104-
<p>The only restrictions are that such properties MUST NOT be defined with a
105-
<code>rendition:</code> prefix and MUST NOT conflict behaviorally with properties
92+
93+
<p>The only restrictions are that such properties MUST NOT be defined with a
94+
<code>rendition:</code> prefix and MUST NOT conflict behaviorally with properties
10695
in the <a href="app-rendering-vocab">package rendering vocabulary</a>.</p>
107-
108-
<p>If extensions are needed for use by multiple independent reading systems, the
109-
preferred method is to extend the package rendering vocabulary through a revision
96+
97+
<p>If extensions are needed for use by multiple independent reading systems, the
98+
preferred method is to extend the package rendering vocabulary through a revision
11099
to this standard.</p>
111100
</section>
112101
</section>

‎epub34/rs/index.html‎

Lines changed: 1 addition & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
// previousMaturity: "REC",
2222
// errata: "https://w3c.github.io/epub-specs/epub34/errata.html",
2323
copyrightStart: "1999",
24-
editors: [
24+
editors: [
2525
{
2626
name: "Matt Garrish",
2727
company: "DAISY Consortium",
@@ -1527,42 +1527,6 @@ <h5>The <code>rendition:layout</code> property</h5>
15271527
</dl>
15281528
</section>
15291529

1530-
<section id="orientation">
1531-
<h5>The <code>rendition:orientation</code> property</h5>
1532-
1533-
<p id="fxl-orientation-default" data-tests="#lay-fxl-orientation-default" data-cite="epub-34"
1534-
>The default value <code>auto</code> MUST be assumed by EPUB reading systems as the global
1535-
value if no [^meta^] element carrying the <a data-cite="epub-34#orientation"
1536-
><code>rendition:orientation</code> property</a> occurs in the <a
1537-
data-cite="epub-34#elemdef-opf-metadata">package document metadata</a> [[epub-34]].</p>
1538-
1539-
<p>The <code>rendition:orientation</code> property values have the following processing
1540-
requirements:</p>
1541-
1542-
<dl class="variablelist">
1543-
<dt id="def-orientation-auto">auto</dt>
1544-
<dd>
1545-
<p>The reading system determines the orientation in which to render [=EPUB content
1546-
documents=].</p>
1547-
</dd>
1548-
1549-
<dt id="def-orientation-landscape" data-tests="#lay-fxl-orientation-landscape"
1550-
>landscape</dt>
1551-
<dd>
1552-
<p>Reading systems that support multiple orientations SHOULD render EPUB content
1553-
documents in landscape orientation.</p>
1554-
</dd>
1555-
1556-
<dt id="def-orientation-portrait">portrait</dt>
1557-
<dd>
1558-
<p>Reading systems that support multiple orientations SHOULD render EPUB content
1559-
documents in portrait orientation.</p>
1560-
</dd>
1561-
</dl>
1562-
1563-
<p>The means by which they convey the intent is implementation specific.</p>
1564-
</section>
1565-
15661530
<section id="spread">
15671531
<h5>The <code>rendition:spread</code> property</h5>
15681532

0 commit comments

Comments
 (0)