Skip to content

Commit

Permalink
Editorial: add IDs for en-GB terms
Browse files Browse the repository at this point in the history 
In preparation for switching to en-US without breaking links.
Part of whatwg#654.
  • Loading branch information
@annevk
annevk authored and Alice Boxhall committed Jan 7, 2019
1 parent 92e940b commit 9b9052b
Showing 1 changed file with 90 additions and 79 deletions.
169 changes: 90 additions & 79 deletions source
View file
Original file line number Diff line number Diff line change
Expand Up @@ -610,7 +610,7 @@

<div w-nodev>

<h4>Serialisability of script execution</h4>
<h4 id="serialisability-of-script-execution">Serialisability of script execution</h4>

<!-- NON-NORMATIVE SECTION -->

Expand Down Expand Up @@ -5618,8 +5618,9 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d

</ol>

<p>A string is a <dfn>valid normalised local date and time string</dfn> representing a date and
time if it consists of the following components in the given order:</p>
<p>A string is a <dfn id="valid-normalised-local-date-and-time-string" data-noexport="">valid
normalised local date and time string</dfn> representing a date and time if it consists of the
following components in the given order:</p>

<ol>

Expand Down Expand Up @@ -6530,26 +6531,28 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
</div>


<h4>Colours</h4>
<h4 id="colours">Colours</h4>

<p>A <dfn>simple colour</dfn> consists of three 8-bit numbers in the range 0..255, representing the
red, green, and blue components of the colour respectively, in the sRGB colour space. <ref spec=SRGB></p>
<p>A <dfn id="simple-colour">simple colour</dfn> consists of three 8-bit numbers in the range
0..255, representing the red, green, and blue components of the colour respectively, in the sRGB
colour space. <ref spec=SRGB></p>

<p>A string is a <dfn>valid simple colour</dfn> if it is exactly seven characters long, and the
first character is a U+0023 NUMBER SIGN character (#), and the remaining six characters are all
<span>ASCII hex digits</span>, with the first two digits representing the red component, the
middle two digits representing the green component, and the last two digits representing the blue
component, in hexadecimal.</p>
<p>A string is a <dfn id="valid-simple-colour">valid simple colour</dfn> if it is exactly seven
characters long, and the first character is a U+0023 NUMBER SIGN character (#), and the remaining
six characters are all <span>ASCII hex digits</span>, with the first two digits representing the
red component, the middle two digits representing the green component, and the last two digits
representing the blue component, in hexadecimal.</p>

<p>A string is a <dfn>valid lowercase simple colour</dfn> if it is a <span>valid simple
colour</span> and doesn't use any characters in the range U+0041 LATIN CAPITAL LETTER A to U+0046
LATIN CAPITAL LETTER F.</p>
<p>A string is a <dfn id="valid-lowercase-simple-colour">valid lowercase simple colour</dfn> if it
is a <span>valid simple colour</span> and doesn't use any characters in the range U+0041 LATIN
CAPITAL LETTER A to U+0046 LATIN CAPITAL LETTER F.</p>

<div w-nodev>

<p>The <dfn>rules for parsing simple colour values</dfn> are as given in the following algorithm.
When invoked, the steps must be followed in the order given, aborting at the first step that
returns a value. This algorithm will return either a <span>simple colour</span> or an error.</p>
<p>The <dfn id="rules-for-parsing-simple-colour-values">rules for parsing simple colour
values</dfn> are as given in the following algorithm. When invoked, the steps must be followed in
the order given, aborting at the first step that returns a value. This algorithm will return
either a <span>simple colour</span> or an error.</p>

<ol>

Expand Down Expand Up @@ -6579,8 +6582,8 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d

</ol>

<p>The <dfn>rules for serialising simple colour values</dfn> given a <span>simple colour</span> are
as given in the following algorithm:</p>
<p>The <dfn id="rules-for-serialising-simple-colour-values">rules for serialising simple colour
values</dfn> given a <span>simple colour</span> are as given in the following algorithm:</p>

<ol>

Expand All @@ -6598,10 +6601,11 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d

<hr>

<p>Some obsolete legacy attributes parse colours in a more complicated manner, using the <dfn>rules
for parsing a legacy colour value</dfn>, which are given in the following algorithm. When invoked,
the steps must be followed in the order given, aborting at the first step that returns a value.
This algorithm will return either a <span>simple colour</span> or an error.</p>
<p>Some obsolete legacy attributes parse colours in a more complicated manner, using the
<dfn id="rules-for-parsing-a-legacy-colour-value">rules for parsing a legacy colour value</dfn>,
which are given in the following algorithm. When invoked, the steps must be followed in the order
given, aborting at the first step that returns a value. This algorithm will return either a
<span>simple colour</span> or an error.</p>

<ol>

Expand Down Expand Up @@ -21784,7 +21788,7 @@ interface <dfn>HTMLHyperlinkElementUtils</dfn> {
operation.</p>

<p>An element implementing the <code>HTMLHyperlinkElementUtils</code> mixin has an associated <dfn
data-noexport="">reinitialise url</dfn> algorithm, which runs these steps:</p>
id="reinitialise-url" data-noexport="">reinitialise url</dfn> algorithm, which runs these steps:</p>

<ol>
<li><p>If element's <span data-x="concept-hyperlink-url">url</span> is non-null, its <span
Expand Down Expand Up @@ -26511,8 +26515,9 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
no descriptor at all accompanying its URL. Normalising a <span>source set</span> gives every <span>image
source</span> a <span>pixel density descriptor</span>.</p>

<p>When asked to <dfn>normalise the source densities</dfn> of a <span>source set</span> <var>source set</var>,
the user agent must do the following:</p>
<p>When asked to <dfn id="normalise-the-source-densities" data-noexport="">normalise the source
densities</dfn> of a <span>source set</span> <var>source set</var>, the user agent must do the
following:</p>

<ol>

Expand Down Expand Up @@ -36494,8 +36499,9 @@ red:89
if called with an <var>index</var> argument greater than or equal to the number of ranges
represented by the object.</p>

<p>When a <code>TimeRanges</code> object is said to be a <dfn>normalised <code>TimeRanges</code>
object</dfn>, the ranges it represents must obey the following criteria:</p>
<p>When a <code>TimeRanges</code> object is said to be a <dfn id="normalised-timeranges-object"
data-noexport="">normalised <code>TimeRanges</code> object</dfn>, the ranges it represents must
obey the following criteria:</p>

<ul>

Expand Down Expand Up @@ -59420,8 +59426,8 @@ callback <dfn>BlobCallback</dfn> = void (<span>Blob</span>? blob);</pre>

<li><p><span>Queue a task</span> to <span data-x="es-invoking-callback-functions">invoke</span>
the <code>BlobCallback</code> <var>callback</var> with <var>result</var> as its argument. The
<span>task source</span> for this task is the <dfn>canvas blob serialisation task
source</dfn>.</p></li>
<span>task source</span> for this task is the <dfn
id="canvas-blob-serialisation-task-source">canvas blob serialisation task source</dfn>.</p></li>

</ol>

Expand Down Expand Up @@ -62170,24 +62176,24 @@ try {
returned. (Such objects are opaque and therefore only useful for assigning to other attributes or
for comparison to other gradients or patterns.)</p>

<p>The <dfn>serialisation of a colour</dfn> for a colour value is a string, computed as follows: if
it has alpha equal to 1.0, then the string is a lowercase six-digit hex value, prefixed with a "#"
character (U+0023 NUMBER SIGN), with the first two digits representing the red component, the next
two digits representing the green component, and the last two digits representing the blue
component, the digits being <span>lowercase ASCII hex digits</span>. Otherwise, the colour value
has alpha less than 1.0, and the string is the colour value in the CSS <code data-x="">rgba()</code>
functional-notation format: the literal string "<code data-x="">rgba</code>" (U+0072 U+0067 U+0062
U+0061) followed by a U+0028 LEFT PARENTHESIS, a base-ten integer in the range 0-255 representing
the red component (using <span>ASCII digits</span> in the shortest form possible), a literal
U+002C COMMA and U+0020 SPACE, an integer for the green component, a comma and a space, an integer
for the blue component, another comma and space, a U+0030 DIGIT ZERO, if the alpha value is
greater than zero then a U+002E FULL STOP (representing the decimal point), if the alpha value is
greater than zero then one or more <span>ASCII digits</span> representing the fractional part of
the alpha<!-- value with no trailing zeros (implied by next sentence)-->, and finally a U+0029
RIGHT PARENTHESIS. User agents must express the fractional part of the alpha value, if any, with
the level of precision necessary for the alpha value, when reparsed, to be interpreted as the same
alpha value.</p> <!-- if people complain this is unreadable, expand it into a <dl> with two nested
<ol>s -->
<p>The <dfn id="serialisation-of-a-colour">serialisation of a colour</dfn> for a colour value is a
string, computed as follows: if it has alpha equal to 1.0, then the string is a lowercase
six-digit hex value, prefixed with a "#" character (U+0023 NUMBER SIGN), with the first two digits
representing the red component, the next two digits representing the green component, and the last
two digits representing the blue component, the digits being <span>lowercase ASCII hex
digits</span>. Otherwise, the colour value has alpha less than 1.0, and the string is the colour
value in the CSS <code data-x="">rgba()</code> functional-notation format: the literal string
"<code data-x="">rgba</code>" (U+0072 U+0067 U+0062 U+0061) followed by a U+0028 LEFT PARENTHESIS,
a base-ten integer in the range 0-255 representing the red component (using <span>ASCII
digits</span> in the shortest form possible), a literal U+002C COMMA and U+0020 SPACE, an integer
for the green component, a comma and a space, an integer for the blue component, another comma and
space, a U+0030 DIGIT ZERO, if the alpha value is greater than zero then a U+002E FULL STOP
(representing the decimal point), if the alpha value is greater than zero then one or more
<span>ASCII digits</span> representing the fractional part of the alpha<!-- value with no trailing
zeros (implied by next sentence)-->, and finally a U+0029 RIGHT PARENTHESIS. User agents must
express the fractional part of the alpha value, if any, with the level of precision necessary for
the alpha value, when reparsed, to be interpreted as the same alpha value.</p> <!-- if people
complain this is unreadable, expand it into a <dl> with two nested <ol>s -->

<p>When the context is created, the <code
data-x="dom-context-2d-fillStyle">fillStyle</code> and <code
Expand Down Expand Up @@ -65547,7 +65553,7 @@ dictionary <dfn>ImageBitmapRenderingContextSettings</dfn> {

<div w-nodev>

<h5>Colour spaces and colour correction</h5>
<h5 id="colour-spaces-and-colour-correction">Colour spaces and colour correction</h5>

<p>The <code>canvas</code> APIs must perform colour correction at only two points: when rendering
images with their own gamma correction and colour space information onto a bitmap, to convert the
Expand Down Expand Up @@ -65584,13 +65590,14 @@ dictionary <dfn>ImageBitmapRenderingContextSettings</dfn> {



<h5>Serialising bitmaps to a file</h5>
<h5 id="serialising-bitmaps-to-a-file">Serialising bitmaps to a file</h5>

<div w-nodev>

<p>When a user agent is to create <dfn>a serialisation of the bitmap as a file</dfn>, given an
optional <var>type</var> and <var>quality</var>, it must create an image file in the format given
by <var>type</var>, or if <var>type</var> was not supplied, in the PNG format. <ref spec=PNG></p>
<p>When a user agent is to create <dfn id="a-serialisation-of-the-bitmap-as-a-file">a
serialisation of the bitmap as a file</dfn>, given an optional <var>type</var> and
<var>quality</var>, it must create an image file in the format given by <var>type</var>, or if
<var>type</var> was not supplied, in the PNG format. <ref spec=PNG></p>

<p>The image file's pixel data must be the bitmap's pixel data scaled to one image pixel per
coordinate space unit, and if the file format used supports encoding resolution metadata, the
Expand Down Expand Up @@ -72301,9 +72308,9 @@ END:VCARD</pre>
<dfn>canceled activation steps</dfn> defined for that element, if any.</p>

<p>When a user agent is to <dfn>run post-click activation steps</dfn> on an element, it must run
the <dfn>activation behaviour</dfn> defined for that element, if any. Activation behaviours can
refer to the <code data-x="event-click">click</code> event that was fired by the steps above
leading up to this point.</p>
the <dfn id="activation-behaviour">activation behaviour</dfn> defined for that element, if any.
Activation behaviours can refer to the <code data-x="event-click">click</code> event that was
fired by the steps above leading up to this point.</p>

<p id="allowed-to-show-a-popup">An algorithm is <dfn data-export="">triggered by user
activation</dfn> if any of the following conditions is true:</p>
Expand Down Expand Up @@ -79568,8 +79575,9 @@ callback <dfn>FrameRequestCallback</dfn> = void (<span>DOMHighResTimeStamp</span

<hr>

<p>The <dfn data-export="">Unicode serialisation of an origin</dfn> is the string obtained by
applying the following algorithm to the given <span>origin</span> <var>origin</var>:</p>
<p>The <dfn id="unicode-serialisation-of-an-origin" data-export="">Unicode serialisation of an
origin</dfn> is the string obtained by applying the following algorithm to the given
<span>origin</span> <var>origin</var>:</p>

<ol>
<li><p>If <var>origin</var> is an <span data-x="concept-origin-opaque">opaque origin</span>, then
Expand Down Expand Up @@ -79601,8 +79609,9 @@ callback <dfn>FrameRequestCallback</dfn> = void (<span>DOMHighResTimeStamp</span
data-x="">xn--maraa-rta.example</code>", null, null) is "<code
data-x="">https://maraña.example</code>".</p>

<p>The <dfn data-export="">ASCII serialisation of an origin</dfn> is the string obtained by
applying the following algorithm to the given <span>origin</span> <var>origin</var>:</p>
<p>The <dfn id="ascii-serialisation-of-an-origin" data-export="">ASCII serialisation of an
origin</dfn> is the string obtained by applying the following algorithm to the given
<span>origin</span> <var>origin</var>:</p>

<ol>
<li><p>If <var>origin</var> is an <span data-x="concept-origin-opaque">opaque origin</span>, then
Expand Down Expand Up @@ -82294,10 +82303,10 @@ State: &lt;OUTPUT NAME=I>1&lt;/OUTPUT> &lt;INPUT VALUE="Increment" TYPE=BUTTON O
data-x="javascript protocol">dereferencing a <code>javascript:</code> URL</span> and when
performing <span>an overridden reload</span>.</p>

<p><dfn data-x="initialise the Document object" data-export="">Initialising a new
<code>Document</code> object</dfn>: when a <code>Document</code> is created as part of the above
steps, the user agent will be required to additionally run the following algorithm after
creating the new object:</p>
<p><dfn id="initialise-the-document-object" data-x="initialise the Document object"
data-export="">Initialising a new <code>Document</code> object</dfn>: when a
<code>Document</code> is created as part of the above steps, the user agent will be required to
additionally run the following algorithm after creating the new object:</p>

<ol>
<li><p>Let <var>window</var> be null.</p></li>
Expand Down Expand Up @@ -90372,8 +90381,9 @@ document.body.appendChild(frame)</pre>

<hr>

<p>The <dfn>timer initialisation steps</dfn>, which are invoked with some method arguments, a <var>method context</var>, a <var>repeat</var> flag which can be true or false, and
optionally (and only if the <var>repeat</var> flag is true) a <var>previous
<p>The <dfn id="timer-initialisation-steps">timer initialisation steps</dfn>, which are invoked
with some method arguments, a <var>method context</var>, a <var>repeat</var> flag which can be
true or false, and optionally (and only if the <var>repeat</var> flag is true) a <var>previous
handle</var>, are as follows:</p>

<ol>
Expand Down Expand Up @@ -108345,11 +108355,12 @@ document.body.appendChild(text);
<!--/HTMLPARSER-->


<h3>Serialising HTML fragments</h3>
<h3 id="serialising-html-fragments">Serialising HTML fragments</h3>

<p>The following steps form the <dfn>HTML fragment serialisation algorithm</dfn>. The algorithm
takes as input a DOM <code>Element</code>, <code>Document</code>, or <code>DocumentFragment</code>
referred to as <var>the node</var>, and returns a string.</p>
<p>The following steps form the <dfn id="html-fragment-serialisation-algorithm"
data-export="">HTML fragment serialisation algorithm</dfn>. The algorithm takes as input a DOM
<code>Element</code>, <code>Document</code>, or <code>DocumentFragment</code> referred to as
<var>the node</var>, and returns a string.</p>

<p class="note">This algorithm serialises the <em>children</em> of the node being serialised, not
the node itself.</p>
Expand Down Expand Up @@ -108395,8 +108406,8 @@ document.body.appendChild(text);
attribute's value, <span data-x="escaping a string">escaped as described below</span> in
<i>attribute mode</i>, and a second U+0022 QUOTATION MARK character (&quot;).</p>

<p>An <dfn>attribute's serialised name</dfn> for the purposes of the previous paragraph must
be determined as follows:</p>
<p>An <dfn id="attribute's-serialised-name" data-noexport="">attribute's serialised
name</dfn> for the purposes of the previous paragraph must be determined as follows:</p>

<dl class="switch">

Expand Down Expand Up @@ -109020,11 +109031,11 @@ document.body.appendChild(text);
<!--//HTMLPARSER-->


<h3>Serialising XHTML fragments</h3>
<h3 id="serialising-xhtml-fragments">Serialising XHTML fragments</h3>

<p>The <dfn>XML fragment serialisation algorithm</dfn> for a <code>Document</code> or
<code>Element</code> node either returns a fragment of XML that represents that node or throws an
exception.</p>
<p>The <dfn id="xml-fragment-serialisation-algorithm">XML fragment serialisation algorithm</dfn>
for a <code>Document</code> or <code>Element</code> node either returns a fragment of XML that
represents that node or throws an exception.</p>

<p>For <code>Document</code>s, the algorithm must return a string in the form of a <a
href="https://www.w3.org/TR/xml/#sec-well-formed">document entity</a>, if none of the error cases
Expand Down Expand Up @@ -110919,7 +110930,7 @@ details[open] > summary {

<div w-nodev>

<h4>The <code>input</code> element as a colour well</h4>
<h4 id="the-input-element-as-a-colour-well">The <code>input</code> element as a colour well</h4>

<p>An <code>input</code> element whose <code data-x="attr-input-type">type</code> attribute is in
the <span data-x="attr-input-type-color">Colour</span> state is expected to render as an
Expand Down Expand Up @@ -111466,8 +111477,8 @@ details[open] > summary {

</ol>

<p>The <dfn>frame border colour</dfn> of a <code>frameset</code> or <code>frame</code> element
is the colour obtained from the following algorithm:</p>
<p>The <dfn id="frame-border-colour">frame border colour</dfn> of a <code>frameset</code> or
<code>frame</code> element is the colour obtained from the following algorithm:</p>

<ol>

Expand Down

0 comments on commit 9b9052b

Please sign in to comment.