Skip to content

Commit 6553091

Browse files
authored
Merge pull request #2804 from w3c/editorial/issue-2216
Remove epub creator from authoring and rs specs
2 parents f652120 + 41578d9 commit 6553091

9 files changed

Lines changed: 1196 additions & 1309 deletions

File tree

‎epub34/authoring/index.html‎

Lines changed: 1011 additions & 1113 deletions
Large diffs are not rendered by default.

‎epub34/authoring/vocab/item-properties.html‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<html><head></head><body><section id="app-item-properties-vocab" class="vocab">
1+
<section id="app-item-properties-vocab" class="vocab">
22
<h3>Manifest properties vocabulary</h3>
33

44
<p>The properties in this vocabulary are usable in the manifest [^item^]
@@ -235,4 +235,3 @@ <h4>switch</h4>
235235
</table>
236236
</section>
237237
</section>
238-
</body></html>

‎epub34/authoring/vocab/itemref-properties.html‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<html><head></head><body><section id="app-itemref-properties-vocab" class="vocab">
1+
<section id="app-itemref-properties-vocab" class="vocab">
22
<h3>Spine properties vocabulary</h3>
33

44
<p>The properties in this vocabulary are usable in the spine [^itemref^] element's
@@ -79,4 +79,3 @@ <h4>Examples</h4>
7979
</aside>
8080
</section>
8181
</section>
82-
</body></html>

‎epub34/authoring/vocab/link.html‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<html><head></head><body><section id="app-link-vocab" class="vocab">
1+
<section id="app-link-vocab" class="vocab">
22
<h3>Metadata link vocabulary</h3>
33

44
<p>The properties in this vocabulary are usable in the metadata [^link^]
@@ -186,4 +186,3 @@ <h5>onix</h5>
186186
</section>
187187
</section>
188188
</section>
189-
</body></html>

‎epub34/authoring/vocab/meta-property.html‎

Lines changed: 25 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<html><head></head><body><section id="app-meta-property-vocab" class="vocab">
1+
<section id="app-meta-property-vocab" class="vocab">
22
<h3>Meta properties vocabulary</h3>
33

44
<p>The properties in this vocabulary are usable in the [^meta^]
@@ -145,11 +145,10 @@ <h5>belongs-to-collection</h5>
145145
collections.</p>
146146
<p>It is also possible to chain these properties using the <a href="#attrdef-refines"><code>refines</code> attribute</a> to indicate that one collection is
147147
itself a member of another collection.</p>
148-
<p>To allow [=reading systems=] to organize collections and avoid naming collisions (e.g.,
149-
unrelated collections might share a similar name, or different editions of a
150-
collection could be released), [=EPUB creators=] SHOULD provide an identifier that uniquely
151-
identifies the instance of the collection. The <code>dcterms:identifier</code>
152-
property must carry this identifier.</p>
148+
<p>A unique identifier SHOULD be provided for each instance of a collection using a
149+
<code>dcterms:identifier</code> property. This will allow [=reading systems=] to organize
150+
collections and avoid naming collisions (e.g., unrelated collections might share a similar
151+
name, or different editions of a collection could be released).</p>
153152
<p>The collection MAY more precisely define its nature by attaching a <a href="#collection-type"><code>collection-type</code></a> property.</p>
154153
<p>The position of the EPUB publication within the collection MAY be provided by
155154
attaching a <a href="#group-position"><code>group-position</code> property</a>.</p>
@@ -207,8 +206,8 @@ <h5>collection-type</h5>
207206
<p>The <code>collection-type</code> property indicates the form or nature of a
208207
collection.</p>
209208
<p>When the <code>collection-type</code> value is drawn from a code list or other formal
210-
enumeration, [=EPUB creators=] SHOULD attach a <a href="#attrdef-scheme"><code>scheme</code>
211-
attribute</a> to identify its source.</p>
209+
enumeration, a <a href="#attrdef-scheme"><code>scheme</code>
210+
attribute</a> SHOULD be attached to identify its source.</p>
212211
<p>This specification also defines the following collection types when no scheme is
213212
specified:</p>
214213
<dl>
@@ -228,7 +227,7 @@ <h5>collection-type</h5>
228227
</dd>
229228
</dl>
230229
<div class="note">
231-
<p>Although [=reading systems=] are not required to support these values, specifying
230+
<p>Although [=reading systems=] do not have to support these values, specifying
232231
them provides the option to group related [=EPUB publications=] in more meaningful
233232
ways.</p>
234233
</div>
@@ -379,7 +378,7 @@ <h5>group-position</h5>
379378
<p>The <code>group-position</code> property indicates the numeric position in which the
380379
[=EPUB publication=] is ordered relative to other works belonging to the same group
381380
(whether all EPUB publications or not).</p>
382-
<p>[=EPUB creators=] can attach the <code>group-position</code> property to any metadata
381+
<p>The <code>group-position</code> property can be attached to any metadata
383382
property that establishes the group but it is typically associated with the <a href="#belongs-to-collection"><code>belongs-to-collection</code>
384383
property</a>.</p>
385384
<p>An EPUB publication can belong to more than one group.</p>
@@ -462,8 +461,8 @@ <h5>identifier-type</h5>
462461
<p>The <code>identifier-type</code> property indicates the form or nature of an
463462
<code>identifier</code>.</p>
464463
<p>When the <code>identifier-type</code> value is drawn from a code list or other formal
465-
enumeration, [=EPUB creators=] SHOULD attach a <a href="#attrdef-scheme"><code>scheme</code>
466-
attribute</a> to identify its source.</p>
464+
enumeration, a <a href="#attrdef-scheme"><code>scheme</code>
465+
attribute</a> SHOULD be attached to identify its source.</p>
467466
</td>
468467
</tr>
469468
<tr>
@@ -520,13 +519,13 @@ <h5>The <code>pageBreakSource</code> property</h5>
520519
<td>
521520
<p>Provides a unique identifier for the source of the page break markers in an <a
522521
href="https://www.w3.org/TR/epub/#dfn-epub-publication">EPUB publication</a>.</p>
523-
<p>The identifier should be expressed as a URN when the value conforms to a recognized
522+
<p>It is advised to use a URN as the value when the identifier conforms to a recognized
524523
scheme such as an ISBN.</p>
525-
<p>If a unique identifier does not exist for the source, EPUB creators should use a text
526-
description that identifies the source as clearly as possible (e.g., the title of a word
524+
<p>If a unique identifier does not exist for the source, it is advised to use a text description
525+
that identifies the source as clearly as possible (e.g., the title of a word
527526
processing document).</p>
528527
<p>If the page break markers are unique to the EPUB publication (e.g., for a digital-only
529-
edition), EPUB creators MUST specify the value "<code>none</code>".</p>
528+
edition), the value "<code>none</code>" MUST be specified.</p>
530529
</td>
531530
</tr>
532531
<tr>
@@ -598,12 +597,12 @@ <h5>role</h5>
598597
<code>contributor</code> or <code>publisher</code> in the creation of an EPUB
599598
publication.</p>
600599
<p>When the <code>role</code> value is drawn from a code list or other formal
601-
enumeration, [=EPUB creators=] SHOULD attach a <a href="#attrdef-scheme"><code>scheme</code>
602-
attribute</a> to identify its source.</p>
603-
<p>When attaching multiple roles to an individual or organization, the importance of the
604-
roles should match the document order of their containing <code>meta</code> elements
605-
(i.e., the first <code>meta</code> element encountered should contain the most
606-
important role).</p>
600+
enumeration, a <a href="#attrdef-scheme"><code>scheme</code>
601+
attribute</a> SHOULD be attached to identify its source.</p>
602+
<p>When assigning multiple roles to an individual or organization, associate each role in a
603+
separate <code>meta</code> element and ensure the document order of the elements reflects
604+
the importance of the roles played (i.e., the first <code>meta</code> element encountered
605+
contains the most important role).</p>
607606
</td>
608607
</tr>
609608
<tr>
@@ -681,12 +680,12 @@ <h5>role</h5>
681680
</section>
682681
<section id="sec-source-of" data-epubcheck="true" data-tests="https://w3c.github.io/epub-structural-tests/#D-vocabularies_meta-properties.feature_L170,https://w3c.github.io/epub-structural-tests/#D-vocabularies_meta-properties.feature_L175,https://w3c.github.io/epub-structural-tests/#D-vocabularies_meta-properties.feature_L182,https://w3c.github.io/epub-structural-tests/#D-vocabularies_meta-properties.feature_L189,https://w3c.github.io/epub-structural-tests/#D-vocabularies_meta-properties.feature_L196">
683682
<h5>source-of</h5>
684-
<p>The <code>source-of</code> property is no longer recommended for use in EPUB publications. To indicate
683+
<p>It is no longer advised to use the <code>source-of</code> property in EPUB publications. To indicate
685684
the source of pagination for an EPUB publication, refer to the <a
686685
href="#sec-pageBreakSource"><code>pageBreakSource</code> property definition</a>.</p>
687686
<div class="note">
688687
<p>The <code>source-of</code> property will not be officially deprecated due to the existing base of EPUB
689-
publications in which it is used, but it should be treated by EPUB creators as though it is deprecated.
688+
publications in which it is used, but it is advised to treat it as though it is deprecated.
690689
For information on its use, refer to <a data-cite="epub-33#source-of"><code>source-of</code> property
691690
definition</a> in [[epub-33]].</p>
692691
</div>
@@ -765,8 +764,8 @@ <h5>title-type</h5>
765764
<p>The <code>title-type</code> property indicates the form or nature of a
766765
<code>title</code>.</p>
767766
<p>When the <code>title-type</code> value is drawn from a code list or other formal
768-
enumeration, [=EPUB creators=] SHOULD attach a <a href="#attrdef-scheme"><code>scheme</code>
769-
attribute</a> to identify its source. When a scheme is not specified, [=reading systems=]
767+
enumeration, a <a href="#attrdef-scheme"><code>scheme</code>
768+
attribute</a> SHOULD be attached to identify its source. When a scheme is not specified, [=reading systems=]
770769
SHOULD recognize the following title type values:
771770
<code>main</code>, <code>subtitle</code>, <code class="value">short</code>,
772771
<code>collection</code>, <code class="value">edition</code> and
@@ -979,4 +978,3 @@ <h5>Examples</h5>
979978
</aside>
980979
</section>
981980
</section>
982-
</body></html>

‎epub34/authoring/vocab/overlays.html‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
1-
<html><head></head><body><section id="app-overlays-vocab" class="vocab">
1+
2+
<section id="app-overlays-vocab" class="vocab">
23
<h3>Media overlays vocabulary</h3>
34
<p>The properties in this vocabulary are usable in the [^meta^] element's
45
<code>property</code> attribute.</p>
@@ -18,7 +19,7 @@ <h4>active-class</h4>
1819
</tr>
1920
<tr>
2021
<th>Description:</th>
21-
<td>[=EPUB creator=]-defined CSS class name to apply to the currently playing [=EPUB content document=]
22+
<td>The CSS class name to apply to the currently playing [=EPUB content document=]
2223
element.</td>
2324
</tr>
2425
<tr>
@@ -152,4 +153,3 @@ <h4>playback-active-class</h4>
152153
</table>
153154
</section>
154155
</section>
155-
</body></html>

‎epub34/authoring/vocab/rendering.html‎

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<html><head></head><body><section id="app-rendering-vocab">
1+
<section id="app-rendering-vocab">
22
<h3>Package rendering vocabulary</h3>
33

44
<p>The prefix URL for <a href="#sec-default-vocab">referencing these properties</a> is
@@ -97,18 +97,16 @@ <h3>Package rendering vocabulary</h3>
9797
<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">
9898
<h4>Custom rendering properties</h4>
9999

100-
<p>[=Reading system=] developers may introduce functionality not defined in this specification to address
101-
reading system-specific issues rendering [=EPUB content documents=].</p>
100+
<p>Custom properties and [=EPUB spine | spine=] overrides can be included in the
101+
[=package document=] to address rendering issues specific to particular
102+
[=reading systems=], as defined by the developers of those reading systems.</p>
102103

103-
<p>To facilitate this experimentation, [=EPUB creators=] MAY include custom properties and [=EPUB spine | spine=]
104-
overrides for use in the [=package document=] provided they do not use the <code>rendition:</code>
105-
prefix.</p>
106-
107-
<div class="note">
108-
<p>Custom properties should only address rendering issues specific to a particular reading system. This
109-
specification should be extended to provide extensions that multiple independent reading systems can
110-
use.</p>
111-
</div>
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
106+
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
110+
to this standard.</p>
112111
</section>
113112
</section>
114-
</body></html>

‎epub34/overview/index.html‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!DOCTYPE html>
2-
<html lang="en-US">
2+
<html lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
33
<head>
44
<meta charset="utf-8" />
55
<title>EPUB 3 Overview</title>
@@ -651,9 +651,9 @@ <h3>Notes</h3>
651651
EPUB Accessibility 1.1.1 [[epub-a11y-111]] discovery and accessibility requirements for EPUB
652652
publications. </li>
653653
<li>
654-
[[[epub-a11y-exemption]]] [[epub-a11y-exemption]]: the <code>exemption</code> property allows EPUB creators to indicate that an EPUB publication that does
655-
not meet accessibility conformance requirements has an exemption under the applicable jurisdiction's
656-
laws.
654+
[[[epub-a11y-exemption]]] [[epub-a11y-exemption]]: the <code>exemption</code> property is used
655+
to indicate that an EPUB publication that does not meet accessibility conformance requirements
656+
has an exemption under the applicable jurisdiction's laws.
657657
</li>
658658
<li>
659659
[[[epub-fxl-a11y]]] [[epub-fxl-a11y]]: provides guidance on how to make fixed-layout EPUB publications accessible.

0 commit comments

Comments
 (0)