Skip to content

Commit c7602c1

Browse files
author
reffy-bot
committed
Update of ED report from new reffy run
Using reffy commit 19.2.3.
1 parent 86f8f4e commit c7602c1

File tree

11 files changed

+492
-698
lines changed

11 files changed

+492
-698
lines changed

ed/algorithms/epub-34.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
{
88
"name": "manifest plane",
99
"href": "https://w3c.github.io/epub-specs/epub34/authoring/#dfn-manifest-plane",
10-
"html": "To <dfn class=\"export\" data-lt-no-plural=\"\" data-export=\"\" id=\"dfn-manifest-plane\" tabindex=\"0\" aria-haspopup=\"dialog\" data-dfn-type=\"dfn\">manifest plane</dfn> defines all the resources of an\n\t\t\t\t\t\t<a data-link-type=\"dfn|abstract-op\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-epub-publication\" class=\"internalDFN\" id=\"ref-for-dfn-epub-publication-21\">EPUB publication</a>. It is analogous to the <a data-link-type=\"dfn|abstract-op\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-package-document\" class=\"internalDFN\" id=\"ref-for-dfn-package-document-11\">package document</a> <a data-link-type=\"dfn|abstract-op\" data-lt=\"EPUB manifest\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-epub-manifest\" class=\"internalDFN\" id=\"ref-for-dfn-epub-manifest-2\">manifest</a>,\n\t\t\t\t\t\tbut includes resources not present in that list.",
10+
"html": "To <dfn class=\"export\" data-lt-no-plural=\"\" data-export=\"\" id=\"dfn-manifest-plane\" tabindex=\"0\" aria-haspopup=\"dialog\" data-dfn-type=\"dfn\">manifest plane</dfn> defines all the resources of an\n\t\t\t\t\t\t<a data-link-type=\"dfn|abstract-op\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-epub-publication\" class=\"internalDFN\" id=\"ref-for-dfn-epub-publication-19\">EPUB publication</a>. It is analogous to the <a data-link-type=\"dfn|abstract-op\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-package-document\" class=\"internalDFN\" id=\"ref-for-dfn-package-document-11\">package document</a> <a data-link-type=\"dfn|abstract-op\" data-lt=\"EPUB manifest\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-epub-manifest\" class=\"internalDFN\" id=\"ref-for-dfn-epub-manifest-2\">manifest</a>,\n\t\t\t\t\t\tbut includes resources not present in that list.",
1111
"rationale": "To <dfn>"
1212
},
1313
{
@@ -47,7 +47,7 @@
4747
"html": "<p>Set the <a data-link-type=\"dfn|abstract-op\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-container-root-url\" class=\"internalDFN\" id=\"ref-for-dfn-container-root-url-6\">container root URL</a> to <code>https://a.example.org/A/</code>.</p>\n\t\t\t\t\t\t\t<details class=\"explanation\">\n\t\t\t\t\t\t\t\t<summary>Explanation</summary>\n\t\t\t\t\t\t\t\t<p>The goal of the algorithm is to detect whether <var>url</var> could be seen as\n\t\t\t\t\t\t\t\t\t\"leaking\" outside the container. To do that, the standard <a data-link-type=\"dfn\" data-lt=\"url parser\" data-cite=\"url\" data-cite-path=\"\" data-cite-frag=\"concept-url-parser\" href=\"https://url.spec.whatwg.org/#concept-url-parser\" id=\"ref-for-index-term-url-parser-4\">URL parsing algorithm</a> is used with an artificial root URL; the detection of the \"leak\" is done\n\t\t\t\t\t\t\t\t\tby comparing the result of the parsing with the presence of the first test path\n\t\t\t\t\t\t\t\t\tsegment (<code>A</code>). (Note that the artificial container root URL wilfully\n\t\t\t\t\t\t\t\t\tviolates, for the purpose of this algorithm, the <a href=\"https://w3c.github.io/epub-specs/epub34/authoring/#sec-root-url-properties\">required properties</a> by using that first test path segment.)</p>\n\t\t\t\t\t\t\t</details>"
4848
},
4949
{
50-
"html": "<p>Let <var>base</var> be the <a data-cite=\"url#concept-base-url\" href=\"https://url.spec.whatwg.org/#concept-base-url\" id=\"ref-for-index-term-base-4\">base URL</a> that must be\n\t\t\t\t\t\t\t\tused to parse <var>url</var> as defined by the context (document or environment) where\n\t\t\t\t\t\t\t\t\t<var>url</var> is used, and according to the content URL of the <a data-link-type=\"dfn|abstract-op\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-package-document\" class=\"internalDFN\" id=\"ref-for-dfn-package-document-16\">package document</a>\n\t\t\t\t\t\t\t\t(see <a href=\"https://w3c.github.io/epub-specs/epub34/authoring/#sec-parse-package-urls\" class=\"sec-ref\"><bdi class=\"secno\">5.2 </bdi>Parsing URLs in the package document</a>).</p>\n\t\t\t\t\t\t\t<details class=\"explanation\">\n\t\t\t\t\t\t\t\t<summary>Explanation</summary>\n\t\t\t\t\t\t\t\t<p>In the case of a URL in the package document the <var>base</var> variable is set to\n\t\t\t\t\t\t\t\t\tthe content URL of the package document. In the case of a document within the\n\t\t\t\t\t\t\t\t\t\t<code>META-INF</code> directory, the <var>base</var> variable is set to the\n\t\t\t\t\t\t\t\t\tcontainer root URL (see <a href=\"https://w3c.github.io/epub-specs/epub34/authoring/#sec-parsing-urls-metainf\" class=\"sec-ref\"><bdi class=\"secno\">4.2.6.2 </bdi>Parsing URLs in the <code>META-INF</code> directory</a>). In the case of a\n\t\t\t\t\t\t\t\t\tURL in an <a data-link-type=\"dfn|abstract-op\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-xhtml-content-document\" class=\"internalDFN\" id=\"ref-for-dfn-xhtml-content-document-9\">XHTML content document</a>, the base URL used for parsing is defined by\n\t\t\t\t\t\t\t\t\tthe <a data-cite=\"html#resolving-urls\" href=\"https://html.spec.whatwg.org/multipage/#resolving-urls\" id=\"ref-for-index-term-html-standard-1\">HTML standard</a>. Typically, it will be the\n\t\t\t\t\t\t\t\t\tcontent URL of the content document (unless the <a href=\"https://w3c.github.io/epub-specs/epub34/authoring/#sec-xhtml-deviations-base\">discouraged</a>\n\t\t\t\t\t\t\t\t\t<code>base</code> element is used).</p>\n\t\t\t\t\t\t\t</details>"
50+
"html": "<p>Let <var>base</var> be the <a data-cite=\"url#concept-base-url\" href=\"https://url.spec.whatwg.org/#concept-base-url\" id=\"ref-for-index-term-base-4\">base URL</a> that is used\n\t\t\t\t\t\t\t\tto parse <var>url</var> as defined by the context (document or environment) where\n\t\t\t\t\t\t\t\t\t<var>url</var> is used, and according to the content URL of the <a data-link-type=\"dfn|abstract-op\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-package-document\" class=\"internalDFN\" id=\"ref-for-dfn-package-document-16\">package document</a>\n\t\t\t\t\t\t\t\t(see <a href=\"https://w3c.github.io/epub-specs/epub34/authoring/#sec-parse-package-urls\" class=\"sec-ref\"><bdi class=\"secno\">5.2 </bdi>Parsing URLs in the package document</a>).</p>\n\t\t\t\t\t\t\t<details class=\"explanation\">\n\t\t\t\t\t\t\t\t<summary>Explanation</summary>\n\t\t\t\t\t\t\t\t<p>In the case of a URL in the package document the <var>base</var> variable is set to\n\t\t\t\t\t\t\t\t\tthe content URL of the package document. In the case of a document within the\n\t\t\t\t\t\t\t\t\t\t<code>META-INF</code> directory, the <var>base</var> variable is set to the\n\t\t\t\t\t\t\t\t\tcontainer root URL (see <a href=\"https://w3c.github.io/epub-specs/epub34/authoring/#sec-parsing-urls-metainf\" class=\"sec-ref\"><bdi class=\"secno\">4.2.6.2 </bdi>Parsing URLs in the <code>META-INF</code> directory</a>). In the case of a\n\t\t\t\t\t\t\t\t\tURL in an <a data-link-type=\"dfn|abstract-op\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-xhtml-content-document\" class=\"internalDFN\" id=\"ref-for-dfn-xhtml-content-document-9\">XHTML content document</a>, the base URL used for parsing is defined by\n\t\t\t\t\t\t\t\t\tthe <a data-cite=\"html#resolving-urls\" href=\"https://html.spec.whatwg.org/multipage/#resolving-urls\" id=\"ref-for-index-term-html-standard-1\">HTML standard</a>. Typically, it will be the\n\t\t\t\t\t\t\t\t\tcontent URL of the content document (unless the <a href=\"https://w3c.github.io/epub-specs/epub34/authoring/#sec-xhtml-deviations-base\">discouraged</a>\n\t\t\t\t\t\t\t\t\t<code>base</code> element is used).</p>\n\t\t\t\t\t\t\t</details>"
5151
},
5252
{
5353
"html": "Let <var>testURLRecord</var> be the result of applying the <a data-link-type=\"dfn\" data-cite=\"url\" data-cite-path=\"\" data-cite-frag=\"concept-url-parser\" href=\"https://url.spec.whatwg.org/#concept-url-parser\" id=\"ref-for-index-term-url-parser-5\">URL parser</a> to <var>url</var>,\n\t\t\t\t\t\t\twith <var>base</var>."
@@ -56,10 +56,10 @@
5656
"html": "Let <var>testURLStringA</var> be the result of applying the <a data-link-type=\"dfn\" data-cite=\"url\" data-cite-path=\"\" data-cite-frag=\"concept-url-serializer\" href=\"https://url.spec.whatwg.org/#concept-url-serializer\" id=\"ref-for-index-term-url-serializer-1\">URL Serializer</a> to\n\t\t\t\t\t\t\t\t<var>testURLRecord</var>."
5757
},
5858
{
59-
"html": "<p>Set the <a data-link-type=\"dfn|abstract-op\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-container-root-url\" class=\"internalDFN\" id=\"ref-for-dfn-container-root-url-7\">container root URL</a> to <code>https://b.example.org/B/</code>.</p>\n\t\t\t\t\t\t\t<details class=\"explanation\">\n\t\t\t\t\t\t\t\t<summary>Explanation</summary>\n\t\t\t\t\t\t\t\t<p>The reasons to repeat the same steps twice with different, and artificial, settings\n\t\t\t\t\t\t\t\t\tof the container root URL is to avoid collision which may occur if the\n\t\t\t\t\t\t\t\t\t\t<var>url</var> string also includes <code>/A/</code>. Consider, for example, the\n\t\t\t\t\t\t\t\t\tcase where <var>url</var> is <code>../../A/doc.xhtml</code>.</p>\n\t\t\t\t\t\t\t</details>"
59+
"html": "<p>Set the <a data-link-type=\"dfn|abstract-op\" href=\"https://w3c.github.io/epub-specs/epub34/authoring/#dfn-container-root-url\" class=\"internalDFN\" id=\"ref-for-dfn-container-root-url-7\">container root URL</a> to <code>https://b.example.org/B/</code>.</p>\n\t\t\t\t\t\t\t<details class=\"explanation\">\n\t\t\t\t\t\t\t\t<summary>Explanation</summary>\n\t\t\t\t\t\t\t\t<p>The reasons to repeat the same steps twice with different, and artificial, settings\n\t\t\t\t\t\t\t\t\tof the container root URL is to avoid collision which can occur if the\n\t\t\t\t\t\t\t\t\t\t<var>url</var> string also includes <code>/A/</code>. Consider, for example, the\n\t\t\t\t\t\t\t\t\tcase where <var>url</var> is <code>../../A/doc.xhtml</code>.</p>\n\t\t\t\t\t\t\t</details>"
6060
},
6161
{
62-
"html": "Set <var>base</var> to be the <a data-cite=\"url#concept-base-url\" href=\"https://url.spec.whatwg.org/#concept-base-url\" id=\"ref-for-index-term-base-5\">base URL</a> that must be\n\t\t\t\t\t\t\tused to parse <var>url</var> as defined by the context (document or environment) where\n\t\t\t\t\t\t\t\t<var>url</var> is used, and according to the content URL of the package document (see <a href=\"https://w3c.github.io/epub-specs/epub34/authoring/#sec-parse-package-urls\" class=\"sec-ref\"><bdi class=\"secno\">5.2 </bdi>Parsing URLs in the package document</a>)."
62+
"html": "Set <var>base</var> to be the <a data-cite=\"url#concept-base-url\" href=\"https://url.spec.whatwg.org/#concept-base-url\" id=\"ref-for-index-term-base-5\">base URL</a> that is used\n\t\t\t\t\t\t\tto parse <var>url</var> as defined by the context (document or environment) where\n\t\t\t\t\t\t\t\t<var>url</var> is used, and according to the content URL of the package document (see <a href=\"https://w3c.github.io/epub-specs/epub34/authoring/#sec-parse-package-urls\" class=\"sec-ref\"><bdi class=\"secno\">5.2 </bdi>Parsing URLs in the package document</a>)."
6363
},
6464
{
6565
"html": "Set <var>testURLRecord</var> to be the result of applying the <a data-link-type=\"dfn\" data-cite=\"url\" data-cite-path=\"\" data-cite-frag=\"concept-url-parser\" href=\"https://url.spec.whatwg.org/#concept-url-parser\" id=\"ref-for-index-term-url-parser-6\">URL parser</a> to\n\t\t\t\t\t\t\t\t<var>url</var>, with <var>base</var>."

ed/algorithms/epub-rs-34.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
"rationale": ".algorithm",
1212
"steps": [
1313
{
14-
"html": "<p>Let <var>baseURL</var>, <var>expandedURL</var>, <var>propertyPrefix</var>, and\n\t\t\t\t\t\t\t<var>propertyReference</var> be empty <a data-link-type=\"dfn\" data-cite=\"infra\" data-cite-path=\"\" data-cite-frag=\"string\" href=\"https://infra.spec.whatwg.org/#string\" id=\"ref-for-index-term-string-3\">strings</a>.</p>\n\t\t\t\t\t<details class=\"explanation\">\n\t\t\t\t\t\t<summary>Explanation</summary>\n\t\t\t\t\t\t<p>In this algorithm:</p>\n\t\t\t\t\t\t<ul>\n\t\t\t\t\t\t\t<li><var>baseURL</var> will hold the base URL associated with the value, whether this URL is\n\t\t\t\t\t\t\t\tassigned by the EPUB creator, corresponds to a default vocabulary, or comes from a\n\t\t\t\t\t\t\t\treserved prefix.</li>\n\t\t\t\t\t\t\t<li><var>expandedURL</var> will hold the final URL that results from the concatenation of\n\t\t\t\t\t\t\t\tthe base URL and property reference.</li>\n\t\t\t\t\t\t\t<li><var>propertyPrefix</var> will hold the property's <a data-cite=\"epub-34#property.ebnf.prefix\" href=\"https://www.w3.org/TR/epub-34/#property.ebnf.prefix\" id=\"ref-for-index-term-prefix-1\">prefix</a> [<cite><a class=\"bibref\" data-link-type=\"biblio\" href=\"https://w3c.github.io/epub-specs/epub34/rs/#bib-epub-34\" title=\"EPUB 3.4\">epub-34</a></cite>] (i.e., the value\n\t\t\t\t\t\t\t\tbefore the colon). Properties from a default vocabulary will not have a prefix, but all\n\t\t\t\t\t\t\t\tothers will.</li>\n\t\t\t\t\t\t\t<li><var>propertyReference</var> will hold the property's <a data-cite=\"epub-34#property.ebnf.reference\" href=\"https://www.w3.org/TR/epub-34/#property.ebnf.reference\" id=\"ref-for-index-term-reference-1\">reference</a> [<cite><a class=\"bibref\" data-link-type=\"biblio\" href=\"https://w3c.github.io/epub-specs/epub34/rs/#bib-epub-34\" title=\"EPUB 3.4\">epub-34</a></cite>] (i.e., the\n\t\t\t\t\t\t\t\tvalue after the prefix). All valid properties require a reference.</li>\n\t\t\t\t\t\t</ul>\n\t\t\t\t\t</details>"
14+
"html": "<p>Let <var>baseURL</var>, <var>expandedURL</var>, <var>propertyPrefix</var>, and\n\t\t\t\t\t\t\t<var>propertyReference</var> be empty <a data-link-type=\"dfn\" data-cite=\"infra\" data-cite-path=\"\" data-cite-frag=\"string\" href=\"https://infra.spec.whatwg.org/#string\" id=\"ref-for-index-term-string-3\">strings</a>.</p>\n\t\t\t\t\t<details class=\"explanation\">\n\t\t\t\t\t\t<summary>Explanation</summary>\n\t\t\t\t\t\t<p>In this algorithm:</p>\n\t\t\t\t\t\t<ul>\n\t\t\t\t\t\t\t<li><var>baseURL</var> will hold the base URL associated with the value, whether this URL is\n\t\t\t\t\t\t\t\tassigned in a <code>prefix</code> attribute, corresponds to a default vocabulary, or\n\t\t\t\t\t\t\t\tcomes from a reserved prefix.</li>\n\t\t\t\t\t\t\t<li><var>expandedURL</var> will hold the final URL that results from the concatenation of\n\t\t\t\t\t\t\t\tthe base URL and property reference.</li>\n\t\t\t\t\t\t\t<li><var>propertyPrefix</var> will hold the property's <a data-cite=\"epub-34#property.ebnf.prefix\" href=\"https://www.w3.org/TR/epub-34/#property.ebnf.prefix\" id=\"ref-for-index-term-prefix-1\">prefix</a> [<cite><a class=\"bibref\" data-link-type=\"biblio\" href=\"https://w3c.github.io/epub-specs/epub34/rs/#bib-epub-34\" title=\"EPUB 3.4\">epub-34</a></cite>] (i.e., the value\n\t\t\t\t\t\t\t\tbefore the colon). Properties from a default vocabulary will not have a prefix, but all\n\t\t\t\t\t\t\t\tothers will.</li>\n\t\t\t\t\t\t\t<li><var>propertyReference</var> will hold the property's <a data-cite=\"epub-34#property.ebnf.reference\" href=\"https://www.w3.org/TR/epub-34/#property.ebnf.reference\" id=\"ref-for-index-term-reference-1\">reference</a> [<cite><a class=\"bibref\" data-link-type=\"biblio\" href=\"https://w3c.github.io/epub-specs/epub34/rs/#bib-epub-34\" title=\"EPUB 3.4\">epub-34</a></cite>] (i.e., the\n\t\t\t\t\t\t\t\tvalue after the prefix). All valid properties require a reference.</li>\n\t\t\t\t\t\t</ul>\n\t\t\t\t\t</details>"
1515
},
1616
{
1717
"html": "Obtain the values of <var>propertyPrefix</var> and <var>propertyReference</var> as follows:",
@@ -74,7 +74,7 @@
7474
"html": "Set <var>expandedURL</var> to the concatenated values of <var>baseURL</var> and\n\t\t\t\t\t\t<var>propertyReference</var>. Do not add a separator when concatenating the values."
7575
},
7676
{
77-
"html": "<p>If <var>expandedURL</var> is not a <a data-link-type=\"dfn\" data-cite=\"url\" data-cite-path=\"\" data-cite-frag=\"valid-url-string\" href=\"https://url.spec.whatwg.org/#valid-url-string\" id=\"ref-for-index-term-valid-url-string-1\">valid URL string</a>, the value is invalid. Return <a data-cite=\"infra#nulls\" href=\"https://infra.spec.whatwg.org/#nulls\" id=\"ref-for-index-term-null-6\">null</a>.</p>\n\t\t\t\t\t<p>Otherwise, return <var>expandedURL</var>.</p>\n\t\t\t\t\t<details class=\"explanation\">\n\t\t\t\t\t\t<summary>Explanation</summary>\n\t\t\t\t\t\t<p>Although an expanded value may be obtained, it is not necessarily the case that it is a valid\n\t\t\t\t\t\t\tURL. This is only likely to occur when the EPUB creator assigns an invalid base URL to a\n\t\t\t\t\t\t\tprefix.</p>\n\t\t\t\t\t</details>"
77+
"html": "<p>If <var>expandedURL</var> is not a <a data-link-type=\"dfn\" data-cite=\"url\" data-cite-path=\"\" data-cite-frag=\"valid-url-string\" href=\"https://url.spec.whatwg.org/#valid-url-string\" id=\"ref-for-index-term-valid-url-string-1\">valid URL string</a>, the value is invalid. Return <a data-cite=\"infra#nulls\" href=\"https://infra.spec.whatwg.org/#nulls\" id=\"ref-for-index-term-null-6\">null</a>.</p>\n\t\t\t\t\t<p>Otherwise, return <var>expandedURL</var>.</p>\n\t\t\t\t\t<details class=\"explanation\">\n\t\t\t\t\t\t<summary>Explanation</summary>\n\t\t\t\t\t\t<p>Although an expanded value might be obtained, it is not necessarily the case that it is a\n\t\t\t\t\t\t\tvalid URL. This is only likely to occur when an invalid base URL is assigned to a\n\t\t\t\t\t\t\tprefix.</p>\n\t\t\t\t\t</details>"
7878
}
7979
]
8080
}

ed/dfns/epub-34.json

Lines changed: 0 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -211,29 +211,6 @@
211211
"definedIn": "dt",
212212
"links": []
213213
},
214-
{
215-
"id": "dfn-epub-creator",
216-
"href": "https://w3c.github.io/epub-specs/epub34/authoring/#dfn-epub-creator",
217-
"linkingText": [
218-
"EPUB creator"
219-
],
220-
"localLinkingText": [],
221-
"type": "dfn",
222-
"for": [],
223-
"access": "public",
224-
"informative": false,
225-
"heading": {
226-
"id": "sec-terminology",
227-
"href": "https://w3c.github.io/epub-specs/epub34/authoring/#sec-terminology",
228-
"title": "Terminology",
229-
"alternateIds": [
230-
"x1-4-terminology"
231-
],
232-
"number": "1.4"
233-
},
234-
"definedIn": "dt",
235-
"links": []
236-
},
237214
{
238215
"id": "dfn-epub-manifest",
239216
"href": "https://w3c.github.io/epub-specs/epub34/authoring/#dfn-epub-manifest",

0 commit comments

Comments
 (0)