Skip to content

Commit a24a3f0

Browse files
committed
Use new data-cite attribute for links within external specs.
1 parent 5a14568 commit a24a3f0

File tree

4 files changed

+89
-90
lines changed

4 files changed

+89
-90
lines changed

spec/latest/common/terms.html

Lines changed: 28 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<section>
33
<h1>General Terminology</h1>
44
<p>This document uses the following terms as defined in JSON [[!RFC7159]]. Refer
5-
to the <em>JSON Grammar</em> section in [[!RFC7159]] for formal definitions.</p>
5+
to the <a data-cite="rfc7159#section-2">JSON Grammar section</a> in [[!RFC7159]] for formal definitions.</p>
66

77
<dl class="termlist">
88
<dt><dfn data-lt="arrays">array</dfn></dt><dd>
@@ -13,15 +13,15 @@ <h1>General Terminology</h1>
1313
the collection is <em>unordered</em> by default. While order is
1414
preserved in regular JSON arrays, it is not in regular JSON-LD arrays
1515
unless specifically defined (see
16-
<cite><a href="http://www.w3.org/TR/json-ld/#sets-and-lists" class="externalDFN">Sets and Lists</a></cite> in
16+
<a data-cite="JSON-LD#sets-and-lists" class="externalDFN">Sets and Lists</a> in
1717
the JSON-LD specification [[JSON-LD]]).</dd>
1818
<dt><dfn data-lt="JSON objects">JSON object</dfn></dt><dd>
1919
In the JSON serialization, an object structure is represented as a pair of curly brackets surrounding zero or
2020
more key-value pairs. A key is a <a>string</a>. A single colon comes after
2121
each key, separating the key from the value. A single comma separates a value
2222
from a following key. In JSON-LD the keys in an object MUST be unique.
2323
In the <em>abstract representation</em> a <a>JSON object</a> is equivalent to a
24-
<a href="http://www.w3.org/TR/WebIDL/#dfn-dictionary" class="externalDFN"><dfn data-lt="dictionaries">dictionary</dfn></a> (see [[WebIDL-2]]).</dd>
24+
<a data-cite="WebIDL#dfn-dictionary" class="externalDFN"><dfn data-lt="dictionaries">dictionary</dfn></a> (see [[WebIDL]]).</dd>
2525
<dt><dfn>null</dfn></dt><dd>
2626
The use of the <a>null</a> value within JSON-LD is used to
2727
ignore or reset values. A key-value pair in the <code>@context</code> where
@@ -37,9 +37,9 @@ <h1>General Terminology</h1>
3737
that the octal and hexadecimal formats are not used and that leading
3838
zeros are not allowed.
3939
In the <em>abstract representation</em>, a <a>number</a> is equivalent to either
40-
a <a href="http://www.w3.org/TR/WebIDL/#dfn-long" class="externalDFN">long</a>
41-
or <a href="http://www.w3.org/TR/WebIDL/#dfn-double" class="externalDFN">double</a>, depending
42-
on if the number has a non-zero fractional part (see [[WebIDL-2]]).</dd>
40+
a <a data-cote="WebIDL#idl-long" class="externalDFN">long</a>
41+
or <a data-cite="WebIDL#idl-double" class="externalDFN">double</a>, depending
42+
on if the number has a non-zero fractional part (see [[WebIDL]]).</dd>
4343
<dt><dfn>scalar</dfn></dt><dd>
4444
A scalar is either a JSON <a>string</a>, <a>number</a>, <a>true</a>,
4545
or <a>false</a>.</dd>
@@ -49,14 +49,14 @@ <h1>General Terminology</h1>
4949
character is represented as a single character string.</dd>
5050
<dt><dfn>true</dfn> and <dfn>false</dfn></dt><dd>
5151
Values that are used to express one of two possible
52-
<a href="http://www.w3.org/TR/WebIDL/#idl-boolean" class="externalDFN">boolean</a> states.</dd>
52+
<a data-cite="WebIDL#idl-boolean" class="externalDFN">boolean</a> states.</dd>
5353
</dl>
5454

5555
<p>Furthermore, the following terminology is used throughout this document:</p>
5656

5757
<dl class="termlist">
5858
<dt><dfn data-lt="absolute IRIs">absolute IRI</dfn></dt><dd>
59-
An absolute <a>IRI</a> is defined in [[!RFC3987]] containing a <em>scheme</em> along with a <em>path</em> and
59+
An <a data-cite="rfc3987#section-1.3">absolute IRI</a>> is defined in [[!RFC3987]] containing a <em>scheme</em> along with a <em>path</em> and
6060
optional <em>query</em> and fragment segments.</dd>
6161
<dt><dfn data-lt="base IRIs">base IRI</dfn></dt><dd>
6262
The <a>base IRI</a> is an <a>absolute IRI</a> established in the <a>context</a>,
@@ -79,9 +79,9 @@ <h1>General Terminology</h1>
7979
each IRI contained within a common vocabulary identified by <a>prefix</a>.</dd>
8080
<dt><dfn data-lt="contexts">context</dfn></dt><dd>
8181
A a set of rules for interpreting a <a>JSON-LD document</a> as specified in
82-
<cite><a href="http://www.w3.org/TR/json-ld/#the-context">The Context</a></cite> of the [[JSON-LD]] specification.</dd>
82+
<cite><a data-cite="JSON-LD#the-context">The Context</a> of the [[JSON-LD]] specification.</dd>
8383
<dt><dfn>datatype IRI</dfn></dt><dd>
84-
A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-datatype-iri" class="externalDFN">datatype IRI</a>
84+
A <a data-cite="rdf11-concepts#dfn-datatype-iri" class="externalDFN">datatype IRI</a>
8585
as specified by [[RDF11-CONCEPTS]].</dd>
8686
<dt><dfn>default graph</dfn></dt><dd>
8787
The default graph is the only graph in a JSON-LD document which has no <a>graph name</a>.
@@ -132,7 +132,7 @@ <h1>General Terminology</h1>
132132
an <a>array</a> of zero or more of the above possibilities.
133133
</dd>
134134
<dt><dfn data-lt="IRIs|Internationalized Resource Identifier"><abbr title="Internationalized Resource Identifier">IRI</abbr></dfn></dt><dd>
135-
An Internationalized Resource Identifier as described in [[!RFC3987]].</dd>
135+
An <a data-cite="rfc3987">Internationalized Resource Identifier</a> as described in [[!RFC3987]].</dd>
136136
<dt><dfn data-lt="JSON-LD documents">JSON-LD document</dfn></dt><dd>
137137
A <a>JSON-LD document</a> is a serialization of a collection of
138138
<a>graphs</a> and comprises exactly one
@@ -143,7 +143,7 @@ <h1>General Terminology</h1>
143143
<a>language-tagged string</a>.</dd>
144144
<dt><dfn data-lt="keywords">keyword</dfn></dt><dd>
145145
A JSON key that is specific to JSON-LD, specified in the JSON-LD Syntax specification [[!JSON-LD]]
146-
in the section titled <cite><a href="http://www.w3.org/TR/json-ld/#syntax-tokens-and-keywords">Syntax Tokens and Keywords</a></cite>.</dd>
146+
in the section titled <a data-cite="JSON-LD#syntax-tokens-and-keywords">Syntax Tokens and Keywords</a>.</dd>
147147
<dt><dfn data-lt="language maps">language map</dfn></dt><dd>
148148
An <a>language map</a> is a <a>JSON object</a> value of a <a>term</a> defined with
149149
<code>@container</code> set to <code>@language</code>, whose keys MUST be <a>strings</a> representing
@@ -155,17 +155,17 @@ <h1>General Terminology</h1>
155155
<dt><dfn data-lt="language-tagged strings">language-tagged string</dfn></dt><dd>
156156
A <a>language-tagged string</a> consists of a string and a non-empty language
157157
tag as defined by [[!BCP47]]. The language tag MUST be well-formed according to
158-
<a href="http://tools.ietf.org/html/bcp47#section-2.2.9">section 2.2.9 Classes of Conformance</a>
158+
<a data-cite="bcp47#section-2.2.9">section 2.2.9 Classes of Conformance</a>
159159
of [[!BCP47]], and is normalized to lowercase.</dd>
160160
<dt><dfn>Linked Data</dfn></dt><dd>
161161
A set of documents, each containing a representation of a <a>linked data graph</a>.</dd>
162162
<dt><dfn data-lt="graph|graphs">linked data graph</dfn></dt><dd>
163163
A labeled directed graph, i.e., a set of <a>nodes</a>
164164
connected by <a>edges</a>,
165-
as specified in the <cite><a href="http://www.w3.org/TR/json-ld/#data-model">Data Model</a></cite>
165+
as specified in the <a data-cite="JSON-LD#data-model">Data Model</a>
166166
section of the JSON-LD specification [[!JSON-LD]].
167167
A <a>linked data graph</a> is a generalized representation of a
168-
<cite><a href="http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-graph">RDF graph</a></cite>
168+
<a data-cite="rdf11-concepts#dfn-rdf-graph">RDF graph</a>
169169
as defined in [[!RDF-CONCEPTS]].</dd>
170170
<dt><dfn data-lt="lists">list</dfn></dt><dd>
171171
A <a>list</a> is an ordered sequence of <a>IRIs</a>,
@@ -184,7 +184,6 @@ <h1>General Terminology</h1>
184184
A <a>nested property</a> is a <a>property</a> which is contained within an object referenced by
185185
a semantically meaningless <em>nesting property</em>.
186186
</dd>
187-
(the <a>graph name</a>) and a <a>graph</a>.</dd>
188187
<dt><dfn data-lt="nodes">node</dfn></dt><dd>
189188
Every <a>node</a> is an <a>IRI</a>, a <a>blank node</a>,
190189
a <a>JSON-LD value</a>, or a <a>list</a>.
@@ -216,29 +215,29 @@ <h1>General Terminology</h1>
216215
A piece of information that contains four items; a <a>subject</a>, a <a>property</a>,
217216
an <a>object</a>, and a <a>graph name</a>.</dd>
218217
<dt><dfn>RDF collection</dfn></dt><dd>
219-
A <a href="http://www.w3.org/TR/rdf-schema/#ch_collectionvocab" class="externalDFN">collection</a>
218+
A <a data-cite="rdf-schema#ch_collectionvocab" class="externalDFN">collection</a>
220219
as specified by [[RDF-SCHEMA]].</dd>
221220
<dt><dfn>RDF dataset</dfn></dt><dd>
222-
A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-dataset" class="externalDFN">dataset</a>
221+
A <a data-cite="rdf11-concepts#dfn-rdf-dataset" class="externalDFN">dataset</a>
223222
as specified by [[RDF11-CONCEPTS]] representing a collection of
224-
<a href="http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-graph">RDF graphs</a>.</dd>
223+
<a data-cite="rdf11-concepts#dfn-rdf-graph">RDF graphs</a>.</dd>
225224
<dt><dfn data-lt="RDF literals">RDF literal</dfn></dt><dd>
226-
A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-literal" class="externalDFN">literal</a>
225+
A <a data-cite="rdf11-concepts#dfn-literal" class="externalDFN">literal</a>
227226
as specified by [[RDF11-CONCEPTS]].</dd>
228227
<dt><dfn>RDF object</dfn></dt><dd>
229-
An <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-object" class="externalDFN">object</a>
228+
An <a data-cite="rdf11-concepts#dfn-object" class="externalDFN">object</a>
230229
as specified by [[RDF11-CONCEPTS]].</dd>
231-
<dt><dfn data-lt="predicate|RDF predicates">RDF predicate</dfn></dt><dd>
232-
A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-predicate" class="externalDFN">predicate</a>
230+
<dt><dfn data-lt="predicate|predicates|RDF predicates">RDF predicate</dfn></dt><dd>
231+
A <a data-cite="rdf11-concepts#dfn-predicate" class="externalDFN">predicate</a>
233232
as specified by [[RDF11-CONCEPTS]].</dd>
234233
<dt><dfn>RDF resource</dfn></dt><dd>
235-
A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-resource" class="externalDFN">resource</a>
234+
A <a data-cite="rdf11-concepts#dfn-resource" class="externalDFN">resource</a>
236235
as specified by [[RDF11-CONCEPTS]].</dd>
237236
<dt><dfn>RDF subject</dfn></dt><dd>
238-
A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-subject" class="externalDFN">subject</a>
237+
A <a data-cite="rdf11-concepts#dfn-subject" class="externalDFN">subject</a>
239238
as specified by [[RDF11-CONCEPTS]].</dd>
240239
<dt><dfn data-lt="triple|triples|RDF triples">RDF triple</dfn></dt><dd>
241-
A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-triple" class="externalDFN">triple</a>
240+
A <a data-cite="rdf11-concepts#dfn-rdf-triple" class="externalDFN">triple</a>
242241
as specified by [[RDF11-CONCEPTS]].</dd>
243242
<dt><dfn data-lt="relative IRIs">relative IRI</dfn></dt><dd>
244243
A relative IRI is an <a>IRI</a> that is relative to some other <a>absolute IRI</a>.</dd>
@@ -265,8 +264,8 @@ <h1>General Terminology</h1>
265264
are merged with the map value when expanding.</dd>
266265
<dt><dfn>typed literal</dfn></dt><dd>
267266
A <a>typed literal</a> is a <a>literal</a> with an associated <a>IRI</a>
268-
which indicates the literal's datatype. See <cite><a
269-
href="http://www.w3.org/TR/rdf11-concepts/#dfn-typed-literal">languaged-tagged literal</a></cite> in [[!RDF-CONCEPTS]].</dd>
267+
which indicates the literal's datatype. See <a
268+
data-cite="rdf11-concepts#dfn-typed-literal">languaged-tagged literal</a> in [[!RDF-CONCEPTS]].</dd>
270269
<dt><dfn data-lt="typed values">typed value</dfn></dt><dd>
271270
A <a>typed value</a> consists of a value, which is a <a>string</a>, and a type,
272271
which is an <a>IRI</a>.</dd>
@@ -321,7 +320,7 @@ <h1>Algorithm Terms</h1>
321320
A <a>JSON-LD Processor</a> is a system which can perform the algorithms defined in [[JSON-LD-API]].</dd>
322321
<dt><dfn>map of flattened subjects</dfn></dt><dd>
323322
A map of subjects that is the result of the
324-
<a href="https://www.w3.org/TR/json-ld-api/#node-map-generation">Node Map Generation algorithm</a>.</dd>
323+
<a data-cite="JSON-LD-API#node-map-generation">Node Map Generation algorithm</a>.</dd>
325324
<dt><dfn>object embed flag</dfn></dt><dd>
326325
A flag specifying that <a>node objects</a> should be directly embedded in the output,
327326
instead of being referred to by their <a>IRI</a>.</dd>

spec/latest/json-ld-api/index.html

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -177,8 +177,8 @@ <h1>Introduction</h1>
177177
</ul>
178178

179179
<p>To understand the basics in this specification you must first be familiar with
180-
JSON, which is detailed in [[!RFC7159]]. You must also understand the
181-
JSON-LD syntax defined in [[!JSON-LD]], which is the base syntax used by all
180+
<a data-cite="rfc7159">JSON</a>, which is detailed in [[!RFC7159]]. You must also understand the
181+
<a data-cite="JSON-LD">JSON-LD syntax</a> defined in [[!JSON-LD]], which is the base syntax used by all
182182
of the algorithms in this document. To understand the API and how it is
183183
intended to operate in a programming environment, it is useful to have working
184184
knowledge of the JavaScript programming language [[ECMASCRIPT-6.0]] and
@@ -717,16 +717,16 @@ <h3>Algorithm</h3>
717717
<ol class="algorithm">
718718
<li>Set <em>context</em> to the result of resolving <em>value</em> against
719719
the base IRI which is established as specified in
720-
<cite><a href="http://tools.ietf.org/html/rfc3986#section-5.1">section 5.1 Establishing a Base URI</a></cite>
720+
<a data-cite="rfc3986#section-5.1">section 5.1 Establishing a Base URI</a>
721721
of [[!RFC3986]]. Only the basic algorithm in
722-
<cite><a href="http://tools.ietf.org/html/rfc3986#section-5.2">section 5.2</a></cite>
722+
<a data-cite="rfc3986#section-5.2">section 5.2</a>
723723
of [[!RFC3986]] is used; neither
724-
<cite><a href="http://tools.ietf.org/html/rfc3986#section-6.2.2">Syntax-Based Normalization</a></cite> nor
725-
<cite><a href="http://tools.ietf.org/html/rfc3986#section-6.2.3">Scheme-Based Normalization</a></cite>
724+
<a data-cite="rfc3986#section-6.2.2">Syntax-Based Normalization</a> nor
725+
<a data-cite="rfc3986#section-6.2.3">Scheme-Based Normalization</a>
726726
are performed. Characters additionally allowed in IRI
727727
references are treated in the same way that unreserved
728728
characters are treated in URI references, per
729-
<cite><a href="http://tools.ietf.org/html/rfc3987#section-6.5">section 6.5</a></cite>
729+
<a data-cite="rfc3987#section-6.5">section 6.5</a>
730730
of [[!RFC3987]].</li>
731731
<li>If <em>context</em> is in the <em>remote contexts</em> array, a
732732
<a data-link-for="JsonLdErrorCode">recursive context inclusion</a>
@@ -1152,13 +1152,13 @@ <h3>Algorithm</h3>
11521152
<li>Otherwise, if <em>document relative</em> is <code>true</code>,
11531153
set <em>value</em> to the result of resolving <em>value</em> against
11541154
the <a>base IRI</a>. Only the basic algorithm in
1155-
<cite><a href="http://tools.ietf.org/html/rfc3986#section-5.2">section 5.2</a></cite>
1155+
<a data-cite="rfc3986#section-5.2">section 5.2</a>
11561156
of [[!RFC3986]] is used; neither
1157-
<cite><a href="http://tools.ietf.org/html/rfc3986#section-6.2.2">Syntax-Based Normalization</a></cite> nor
1158-
<cite><a href="http://tools.ietf.org/html/rfc3986#section-6.2.3">Scheme-Based Normalization</a></cite>
1157+
<a data-cite="rfc3986#section-6.2.2">Syntax-Based Normalization</a> nor
1158+
<a data-cite="rfc3986#section-6.2.3">Scheme-Based Normalization</a>
11591159
are performed. Characters additionally allowed in IRI references are treated
11601160
in the same way that unreserved characters are treated in URI references, per
1161-
<cite><a href="http://tools.ietf.org/html/rfc3987#section-6.5">section 6.5</a></cite>
1161+
<a data-cite="rfc3987#section-6.5">section 6.5</a>
11621162
of [[!RFC3987]].</li>
11631163
<li>Return <em>value</em> as is.</li>
11641164
</ol>
@@ -3299,7 +3299,7 @@ <h3>Algorithm</h3>
32993299
part (the result of a modulo&#8209;1 operation) or <em>value</em> is a <a>number</a>
33003300
and <em>datatype</em> equals <code>xsd:double</code>, convert <em>value</em> to a
33013301
<a>string</a> in <a>canonical lexical form</a> of
3302-
an <code>xsd:double</code> as defined in [[!XMLSCHEMA11-2]]
3302+
an <a data-cite="xmlschema11-2#dt-double"><code>xsd:double</code></a> as defined in [[!XMLSCHEMA11-2]]
33033303
and described in
33043304
<a class="sectionRef" href="#data-round-tripping"></a>.
33053305
If <em>datatype</em> is <code>null</code>, set it to
@@ -3309,7 +3309,7 @@ <h3>Algorithm</h3>
33093309
is a <a>number</a> and <em>datatype</em>
33103310
equals <code>xsd:integer</code>, convert <em>value</em> to a
33113311
<a>string</a> in <a>canonical lexical form</a> of
3312-
an <code>xsd:integer</code> as defined in [[!XMLSCHEMA11-2]]
3312+
an <a data-cite="xmlschema11-2#dt-integer"><code>xsd:integer</code></a> as defined in [[!XMLSCHEMA11-2]]
33133313
and described in
33143314
<a class="sectionRef" href="#data-round-tripping"></a>.
33153315
If <em>datatype</em> is <code>null</code>, set it to
@@ -3386,7 +3386,7 @@ <h2>Serialize RDF as JSON-LD Algorithm</h2>
33863386
<a>named graphs</a> into a JSON-LD document.</p>
33873387

33883388
<p>In the RDF abstract syntax, <a>RDF literals</a> have a
3389-
<a href="http://www.w3.org/TR/rdf11-concepts/#dfn-lexical-form"><dfn>lexical form</dfn></a>, as defined
3389+
<a data-cite="rdf11-concepts#dfn-lexical-form"><dfn>lexical form</dfn></a>, as defined
33903390
in [[RDF11-CONCEPTS]]. The form of these literals is used when creating <a>JSON-LD values</a> based on these literals.</p>
33913391

33923392
<section class="informative">
@@ -3673,7 +3673,7 @@ <h3>Algorithm</h3>
36733673
<li>Otherwise, if <em>value</em> is a
36743674
<a>language-tagged string</a>
36753675
add a member <code>@language</code> to <em>result</em> and set its value to the
3676-
<a href="http://www.w3.org/TR/rdf11-concepts/#dfn-language-tag" class="externalDFN">language tag</a>
3676+
<a data-cite="rdf11-concepts#dfn-language-tag" class="externalDFN">language tag</a>
36773677
of <em>value</em>.</li>
36783678
<li>Otherwise, set <em>type</em> to the
36793679
<a>datatype IRI</a>

0 commit comments

Comments
 (0)