Skip to content

Commit 34b7178

Browse files
committed
export all normatively defined terms
I broke my own rule of systematically exporting normative definitions... I strongly felt that the following terms were defined for internal purposes only, more precisely to help define other terms, so I chose to not export them. - IRI equality - Blank node equality - Literal equality - Triple equality - isomorphic RDF-term mapping I experimented with scoped definition [1] for genetic terms such as 'atomic', 'node', 'subject'... but I found that the ergonomic toll was not worth it. In particular, there is no hint in the HTML that the definition requires some additional context to be used. [1] https://respec.org/docs/#scoped-concepts
1 parent 27f19dc commit 34b7178

File tree

1 file changed

+33
-33
lines changed

1 file changed

+33
-33
lines changed

spec/index.html

Lines changed: 33 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -586,11 +586,11 @@ <h3>RDF Version Announcement</h3>
586586
<p>This specification establishes two conformance levels:</p>
587587

588588
<ul>
589-
<li><dfn class="export" data-lt="full">Full conformance</dfn>
589+
<li><dfn class="export" data-local-lt="full">Full conformance</dfn>
590590
supports <a data-lt="RDF graph">graphs</a> and <a data-lt="RDF dataset">datasets</a>
591591
with <a>triples</a> that contain <a>triple terms</a>.
592592
</li>
593-
<li><dfn class="export" data-lt="basic">Basic conformance</dfn>
593+
<li><dfn class="export" data-local-lt="basic">Basic conformance</dfn>
594594
only supports <a data-lt="RDF graph">graphs</a> or <a data-lt="RDF dataset">datasets</a>
595595
with <a>triples</a> that do not contain <a>triple terms</a>.</li>
596596
</ul>
@@ -602,7 +602,7 @@ <h3>RDF Version Announcement</h3>
602602
<section id="defined-version-labels">
603603
<h3>Version Labels</h3>
604604
<p>
605-
A <dfn>version label</dfn> is a string that identifies the syntax and semantics conformance
605+
A <dfn class="export">version label</dfn> is a string that identifies the syntax and semantics conformance
606606
for the RDF data.
607607
</p>
608608
<table id="tab-version-labels" class="simple">
@@ -681,8 +681,8 @@ <h4>Client Considerations</h4>
681681
<h3>Strings in RDF</h3>
682682

683683
<p>RDF uses Unicode [[Unicode]] as the fundamental representation for string values.
684-
Within this, and related specifications, the term <dfn id="dfn-rdf-string">string</dfn>,
685-
or <a data-lt="string">RDF string</a>,
684+
Within this, and related specifications, the term <dfn id="dfn-rdf-string" class="export" data-local-lt="string">RDF string</dfn>,
685+
or simply [=string=],
686686
is used to describe an ordered sequence of zero or more
687687
<a data-cite="I18N-GLOSSARY#dfn-code-point" class="lint-ignore">Unicode code points</a>
688688
which are <a data-cite="I18N-GLOSSARY#dfn-scalar-value" class="lint-ignore">Unicode scalar values</a>.
@@ -705,7 +705,7 @@ <h3>Strings in RDF</h3>
705705
<section id="section-rdf-graph">
706706
<h2>RDF Graphs</h2>
707707

708-
<p>An <dfn>RDF graph</dfn> is a set of <a>RDF triples</a>.</p>
708+
<p>An <dfn class="export">RDF graph</dfn> is a set of <a>RDF triples</a>.</p>
709709

710710
<p>An [=RDF triple=] that is an element of an [=RDF graph=] is also said to be <dfn id="dfn-asserted-triple" class=export data-lt="asserted triple|asserted triples" data-lt-no-plural=""
711711
>asserted</dfn> in that [=RDF graph=]
@@ -736,7 +736,7 @@ <h3>Triples</h3>
736736

737737
<p>The three components (|s|, |p|, |o|) of an [=RDF triple=] are respectively called the <dfn class=export >subject</dfn>, <dfn class=export >predicate</dfn> and <dfn class=export >object</dfn> of the triple.</p>
738738

739-
<p>The set of <span id="dfn-nodes"><!-- obsolete term--></span><dfn data-lt="node">nodes</dfn> of an <a>RDF graph</a>
739+
<p>The set of <span id="dfn-nodes"><!-- obsolete term--></span><dfn class="export" data-lt="RDF node">nodes</dfn> of an <a>RDF graph</a>
740740
is the set of <a>subjects</a> and <a>objects</a> of the <a>asserted triples</a> of the graph.
741741
It is possible for a [=predicate=] [=IRI=] to also occur as a [=node=] in
742742
the same graph.</p>
@@ -763,13 +763,13 @@ <h3>RDF Terms</h3>
763763

764764
<p><a>IRIs</a>, <a>literals</a>,
765765
<a>blank nodes</a>, and <a>triple terms</a> are collectively known as
766-
<span id="dfn-rdf-terms"><!-- obsolete term--></span><dfn data-lt="rdf term">RDF terms</dfn>.</p>
766+
<span id="dfn-rdf-terms"><!-- obsolete term--></span><dfn class="export" data-lt="rdf term">RDF terms</dfn>.</p>
767767

768768
<p>
769769
[=IRIs=], [=literals=] and [=blank nodes=] are said to be <dfn class="export" data-lt-no-plural>atomic</dfn> [=RDF terms=].
770770
</p>
771771

772-
<p><dfn>RDF term equality</dfn>:
772+
<p><dfn class="export">RDF term equality</dfn>:
773773
Two [=RDF terms=] |t| and <var>t'</var> are equal (the same [=RDF term=]) if and only if
774774
one of the following four conditions holds:</p>
775775

@@ -799,7 +799,7 @@ <h3>RDF Terms</h3>
799799
[=triple term=] [=appearing=] in that graph.</p>
800800

801801
<p>
802-
An [=RDF term=] is said to be <dfn>ground</dfn> if any of the following three conditions holds:
802+
An [=RDF term=] is said to be <dfn class="export">ground</dfn> if any of the following three conditions holds:
803803
</p>
804804

805805
<ul>
@@ -819,7 +819,7 @@ <h3>RDF Terms</h3>
819819
<section id="section-IRIs">
820820
<h3>IRIs</h3>
821821

822-
<p>An <dfn data-lt="iri"><abbr title="Internationalized Resource Identifier">IRI</abbr></dfn>
822+
<p>An <dfn class="export" data-lt="iri"><abbr title="Internationalized Resource Identifier">IRI</abbr></dfn>
823823
(Internationalized Resource Identifier) within an RDF graph
824824
is a <a>string</a> that conforms to the syntax
825825
defined in RFC 3987 [[!RFC3987]].</p>
@@ -929,34 +929,34 @@ <h3>Literals</h3>
929929

930930
<p>Literals are used for values such as strings, numbers, and dates.</p>
931931

932-
<p>A <dfn data-local-lt="RDF literal">literal</dfn> consists of
932+
<p>A <dfn class="export" data-lt="RDF literal">literal</dfn> consists of
933933
two, three, or four components, as below:</p>
934934

935935
<ol>
936-
<li>A <dfn>lexical form</dfn>, being an <a data-lt="string">RDF string</a>.
937-
<li>A <dfn>datatype IRI</dfn>, being an <a>IRI</a>
936+
<li>A <dfn class="export">lexical form</dfn>, being an <a data-lt="string">RDF string</a>.
937+
<li>A <dfn class="export">datatype IRI</dfn>, being an <a>IRI</a>
938938
identifying a datatype that determines how the lexical form maps
939939
to a <a>literal value</a>.</li>
940940
<li>If and only if the <a>datatype IRI</a> is
941941
<code>http://www.w3.org/1999/02/22-rdf-syntax-ns#langString</code> or
942942
<code>http://www.w3.org/1999/02/22-rdf-syntax-ns#dirLangString</code>, a
943-
non-empty <dfn>language tag</dfn> as defined by [[!BCP47]]. The
943+
non-empty <dfn class="export">language tag</dfn> as defined by [[!BCP47]]. The
944944
language tag MUST be well-formed according to
945945
<a data-cite="bcp47#section-2.2.9">section 2.2.9</a>
946946
of [[!BCP47]],
947947
and MUST be treated accordingly, that is, in a case-insensitive manner.
948948
Two [[!BCP47]]-complying strings that differ only by case represent the same [=language tag=].</li>
949949
<li>If and only if the <a>datatype IRI</a> is
950950
<code>http://www.w3.org/1999/02/22-rdf-syntax-ns#dirLangString</code>,
951-
a <dfn>base direction</dfn> that MUST be one of the following:<ul>
951+
a <dfn class="export">base direction</dfn> that MUST be one of the following:<ul>
952952
<li>`ltr`, indicating that the initial text direction is set to left-to-right</li>
953953
<li>`rtl`, indicating that the initial text direction is set to right-to-left</li>
954954
</ul></li>
955955
</ol>
956956

957-
<p>A literal is a <dfn>language-tagged string</dfn> if the [=language tag=]
957+
<p>A literal is a <dfn class="export">language-tagged string</dfn> if the [=language tag=]
958958
is present and the [=base direction=] is <em>not</em> present.
959-
A literal is a <dfn id="dfn-dir-lang-string">directional language-tagged string</dfn>
959+
A literal is a <dfn id="dfn-dir-lang-string" class="export">directional language-tagged string</dfn>
960960
if both the [=language tag=] and the [=base direction=] are present.
961961
</p>
962962

@@ -1023,7 +1023,7 @@ <h2>Representation of literals</h2>
10231023
<section>
10241024
<h2>Literal value</h2>
10251025

1026-
<p>The <dfn>literal value</dfn> associated with a <a>literal</a> is defined as follows.</p>
1026+
<p>The <dfn class="export">literal value</dfn> associated with a <a>literal</a> is defined as follows.</p>
10271027

10281028
<ul>
10291029
<li>If the literal is a <a>language-tagged string</a>,
@@ -1038,7 +1038,7 @@ <h2>Literal value</h2>
10381038
of the <a>datatype</a>, then the literal value is the result of applying
10391039
the <a>lexical-to-value mapping</a> of the datatype to the
10401040
<a>lexical form</a>.</li>
1041-
<li>Otherwise, the literal is <dfn data-lt-no-plural>ill-typed</dfn> and no literal value can be
1041+
<li>Otherwise, the literal is <dfn class="export" data-lt-no-plural>ill-typed</dfn> and no literal value can be
10421042
associated with the literal. Such a case produces a semantic
10431043
[=inconsistency=], but it is not <em>syntactically</em> ill-formed.
10441044
Implementations SHOULD accept [=ill-typed=] literals and produce RDF
@@ -1072,7 +1072,7 @@ <h2>Literal value</h2>
10721072
<section id="section-blank-nodes">
10731073
<h3>Blank Nodes</h3>
10741074

1075-
<p><dfn data-lt="blank node">Blank nodes</dfn> are disjoint from
1075+
<p><dfn class="export" data-lt="blank node">Blank nodes</dfn> are disjoint from
10761076
<a>IRIs</a> and <a>literals</a>. Otherwise,
10771077
the set of possible blank nodes is arbitrary. RDF makes no reference to
10781078
any internal structure of blank nodes.</p>
@@ -1236,15 +1236,15 @@ <h3>Replacing Blank Nodes with IRIs</h3>
12361236
<section id="section-dataset">
12371237
<h2>RDF Datasets</h2>
12381238

1239-
<p>An <dfn>RDF dataset</dfn> is a collection of
1239+
<p>An <dfn class="export">RDF dataset</dfn> is a collection of
12401240
<a>RDF graphs</a>, and comprises:</p>
12411241

12421242
<ul>
1243-
<li>Exactly one <dfn>default graph</dfn>, being an <a>RDF graph</a>.
1243+
<li>Exactly one <dfn class="export">default graph</dfn>, being an <a>RDF graph</a>.
12441244
The default graph does not have a name and MAY be empty.</li>
1245-
<li>Zero or more <span id="dfn-named-graphs"><!-- obsolete term--></span><dfn data-lt="named graph">named graphs</dfn>.
1245+
<li>Zero or more <span id="dfn-named-graphs"><!-- obsolete term--></span><dfn class="export" data-lt="named graph">named graphs</dfn>.
12461246
Each named graph is a pair consisting of an <a>IRI</a> or a blank node
1247-
(the <dfn>graph name</dfn>), and an <a>RDF graph</a>.
1247+
(the <dfn class="export">graph name</dfn>), and an <a>RDF graph</a>.
12481248
Graph names are unique within an RDF dataset.</li>
12491249
</ul>
12501250

@@ -1348,15 +1348,15 @@ <h2>Datatypes</h2>
13481348
<code><a>rdf:JSON</a></code>, <code><a>rdf:HTML</a></code>, and <code><a>rdf:XMLLiteral</a></code>.
13491349
</p>
13501350

1351-
<p>A <dfn>datatype</dfn> consists of a <a>lexical space</a>,
1351+
<p>A <dfn class="export">datatype</dfn> consists of a <a>lexical space</a>,
13521352
a <a>value space</a> and a <a>lexical-to-value mapping</a>, and
13531353
is identified by one or more <a>IRIs</a>.</p>
13541354

1355-
<p>The <dfn>lexical space</dfn> of a datatype is a set of <a>strings</a>.</p>
1355+
<p>The <dfn class="export">lexical space</dfn> of a datatype is a set of <a>strings</a>.</p>
13561356

1357-
<p>The <dfn>lexical-to-value mapping</dfn> of a datatype is a set of
1357+
<p>The <dfn class="export">lexical-to-value mapping</dfn> of a datatype is a set of
13581358
pairs whose first element belongs to the <a>lexical space</a>,
1359-
and the second element belongs to the <dfn>value space</dfn>
1359+
and the second element belongs to the <dfn class="export">value space</dfn>
13601360
of the datatype. Each member of the lexical space is paired with exactly
13611361
one value, and is a <em>lexical representation</em>
13621362
of that value. The mapping can be seen as a function
@@ -1432,7 +1432,7 @@ <h3>The XML Schema Built-in Datatypes</h3>
14321432
is the name of a datatype, denote the built-in datatypes defined in
14331433
<em>[[[XMLSCHEMA11-2]]]</em> [[!XMLSCHEMA11-2]]. The XML Schema built-in types
14341434
listed in the following table are the
1435-
<dfn>RDF-compatible XSD types</dfn>. Their use is RECOMMENDED.</p>
1435+
<dfn class="export">RDF-compatible XSD types</dfn>. Their use is RECOMMENDED.</p>
14361436

14371437
<p>Readers might note that the only safe datatypes for transferring
14381438
binary information are `xsd:hexBinary` and `xsd:base64Binary`.</p>
@@ -1735,7 +1735,7 @@ <h3>The <code>rdf:HTML</code> Datatype</h3>
17351735
<p>RDF provides for HTML content as a possible <a>literal value</a>.
17361736
This allows markup in literal values. Such content is indicated
17371737
in an <a>RDF graph</a> using a <a>literal</a> whose <a>datatype</a>
1738-
is set to <code><dfn>rdf:HTML</dfn></code>.</p>
1738+
is set to <code><dfn class="export">rdf:HTML</dfn></code>.</p>
17391739

17401740
<p>The <code>rdf:HTML</code> datatype is defined as follows:</p>
17411741

@@ -1788,7 +1788,7 @@ <h3>The <code>rdf:XMLLiteral</code> Datatype</h3>
17881788

17891789
<p>RDF provides for XML content as a possible <a>literal value</a>.
17901790
Such content is indicated in an <a>RDF graph</a> using a <a>literal</a>
1791-
whose <a>datatype</a> is set to <code><dfn>rdf:XMLLiteral</dfn></code>.</p>
1791+
whose <a>datatype</a> is set to <code><dfn class="export">rdf:XMLLiteral</dfn></code>.</p>
17921792

17931793
<p>The <code>rdf:XMLLiteral</code> datatype is defined as follows:</p>
17941794

@@ -1839,7 +1839,7 @@ <h3>The <code>rdf:JSON</code> Datatype</h3>
18391839
<p>RDF provides for JSON content as a possible <a>literal value</a>.
18401840
This includes allowing markup in literal values. Such content is indicated in an
18411841
<a>RDF graph</a> as a <a>literal</a> whose <a>datatype</a> is set
1842-
to <code><dfn>rdf:JSON</dfn></code>.</p>
1842+
to <code><dfn class="export">rdf:JSON</dfn></code>.</p>
18431843

18441844
<p>The <code>rdf:JSON</code> datatype is defined as follows:</p>
18451845

0 commit comments

Comments
 (0)