@@ -605,7 +605,7 @@ <h2>Syntax Tokens and Keywords</h2>
605
605
(other than for type-<a>scoped contexts</a>, which default to `false`).
606
606
Setting this to `false` causes term definitions created within that context
607
607
to be removed when entering a new <a>node object</a>.</dd>
608
- <dt class="changed">`@source `</dt><dd class="changed">
608
+ <dt class="changed">`@import `</dt><dd class="changed">
609
609
Used in a <a>context definition</a> to load an external context
610
610
within which the containing <a>context definition</a> is merged.
611
611
This can be useful to add JSON-LD 1.1 features to JSON-LD 1.0 contexts.</dd>
@@ -3631,7 +3631,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
3631
3631
due to the way that rollback is defined in [[[JSON-LD11-API]]].</p>
3632
3632
</section>
3633
3633
3634
- <section class="informative changed"><h2>Sourced Contexts</h2>
3634
+ <section class="informative changed"><h2>Imported Contexts</h2>
3635
3635
<p>JSON-LD 1.0 included mechanisms for modifying the <a>context</a> that
3636
3636
is in effect. This included the capability to load and process a remote
3637
3637
<a>context</a> and then apply further changes to it via new <a>contexts</a>.
@@ -3642,39 +3642,39 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
3642
3642
1.0 <a>context</a>, and apply JSON-LD 1.1 features to it prior to
3643
3643
processing.</p>
3644
3644
3645
- <p>By using the `@source ` keyword in a <a>context</a>, another remote
3646
- <a>context</a>, referred to as a sourced <a>context</a>, can be loaded and
3645
+ <p>By using the `@import ` keyword in a <a>context</a>, another remote
3646
+ <a>context</a>, referred to as an imported <a>context</a>, can be loaded and
3647
3647
modified prior to processing. The modifications are expressed in the
3648
- <a>context</a> that includes the `@source ` keyword, referred to as the
3649
- wrapping <a>context</a>. Once a sourced <a>context</a> is loaded, the
3648
+ <a>context</a> that includes the `@import ` keyword, referred to as the
3649
+ wrapping <a>context</a>. Once an imported <a>context</a> is loaded, the
3650
3650
contents of the wrapping <a>context</a> are merged into it prior to
3651
3651
processing. The merge operation will cause each key-value pair in the
3652
- wrapping <a>context</a> to be added to the loaded sourced <a>context</a>,
3652
+ wrapping <a>context</a> to be added to the loaded imported <a>context</a>,
3653
3653
with the wrapping <a>context</a> key-value pairs taking precedence.</p>
3654
3654
3655
3655
<p>By enabling existing <a>contexts</a> to be reused and edited inline prior
3656
3656
to processing, context-wide keywords can be applied to adjust all term
3657
- definitions in the sourced <a>context</a>. Similarly, term definitions can
3657
+ definitions in the imported <a>context</a>. Similarly, term definitions can
3658
3658
be replaced prior to processing, enabling adjustments that, for instance, ensure term
3659
3659
definitions match previously protected terms or that they include
3660
3660
additional type coercion information.</p>
3661
3661
3662
- <p>The following examples illustrate how `@source ` can be used to express
3663
- a type-scoped <a>context</a> that loads a sourced <a>context</a> and
3662
+ <p>The following examples illustrate how `@import ` can be used to express
3663
+ a type-scoped <a>context</a> that loads an imported <a>context</a> and
3664
3664
sets `@propagate` to `true` and how to make similar modifications.</p>
3665
3665
3666
3666
<p>Suppose there was a <a>context</a> that could be referenced remotely
3667
- via the URL <code>http ://example .org/remote-context</code>:</p>
3667
+ via the URL <code>https ://json-ld .org/contexts/ remote-context.jsonld </code>:</p>
3668
3668
3669
3669
<pre class="example nohighlight" data-transform="updateExample"
3670
- title="A remote context to be sourced in a type-scoped context">
3670
+ title="A remote context to be imported in a type-scoped context">
3671
3671
<!--
3672
3672
{
3673
3673
"@context": {
3674
3674
"Type1": "http://example.com/vocab/Type1",
3675
3675
"Type2": "http://example.com/vocab/Type2",
3676
3676
"term1": "http://example.com/vocab#term1",
3677
- "term2": "http://example.com/vocab#term2", ####,
3677
+ "term2": "http://example.com/vocab#term2"####,
3678
3678
...####
3679
3679
}
3680
3680
}
@@ -3693,7 +3693,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
3693
3693
"@id": "http://example.com/vocab#MyType",
3694
3694
"@context": {
3695
3695
"@version": 1.1,
3696
- "@source ": "https://example.com/ remote-context",
3696
+ "@import ": "https://json-ld.org/contexts/ remote-context.jsonld ",
3697
3697
"@propagate": true
3698
3698
}
3699
3699
}
@@ -3702,7 +3702,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
3702
3702
-->
3703
3703
</pre>
3704
3704
3705
- <p>The effect would be the same as if the entire sourced <a>context</a>
3705
+ <p>The effect would be the same as if the entire imported <a>context</a>
3706
3706
had been copied into the type-scoped <a>context</a>:</p>
3707
3707
3708
3708
<pre class="example nohighlight" data-transform="updateExample"
@@ -3718,7 +3718,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
3718
3718
"Type1": "http://example.com/vocab/Type1",
3719
3719
"Type2": "http://example.com/vocab/Type2",
3720
3720
"term1": "http://example.com/vocab#term1",
3721
- "term2": "http://example.com/vocab#term2",####,
3721
+ "term2": "http://example.com/vocab#term2",####
3722
3722
...####
3723
3723
"@propagate": true
3724
3724
}
@@ -3729,7 +3729,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
3729
3729
</pre>
3730
3730
3731
3731
<p>Similarly, the wrapping <a>context</a> may replace term definitions or
3732
- set other context-wide keywords that may effect how the sourced
3732
+ set other context-wide keywords that may effect how the imported
3733
3733
<a>context</a> term definitions will be processed:</p>
3734
3734
3735
3735
<pre class="example nohighlight" data-transform="updateExample"
@@ -3738,7 +3738,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
3738
3738
{
3739
3739
"@context": {
3740
3740
"@version": 1.1,
3741
- "@source ": "https://example .org/remote-context",
3741
+ "@import ": "https://json-ld .org/contexts/ remote-context.jsonld ",
3742
3742
"@vocab": "http://example.org/vocab#",
3743
3743
#### ↑ This will replace any previous @vocab definition prior to processing it####
3744
3744
"term1": {
@@ -3751,7 +3751,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
3751
3751
-->
3752
3752
</pre>
3753
3753
3754
- <p>Again, the effect would be the same as if the entire sourced <a>context</a>
3754
+ <p>Again, the effect would be the same as if the entire imported <a>context</a>
3755
3755
had been copied into the <a>context</a>:</p>
3756
3756
3757
3757
<pre class="example nohighlight" data-transform="updateExample"
@@ -3775,7 +3775,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
3775
3775
-->
3776
3776
</pre>
3777
3777
3778
- <p class="note ">The result of loading a sourced <a>contexts</a> must be
3778
+ <p class="warning ">The result of loading imported <a>contexts</a> must be
3779
3779
an object, not an array.</p>
3780
3780
</section>
3781
3781
@@ -11969,14 +11969,14 @@ <h2>Context Definitions</h2>
11969
11969
<p>An <a>expanded term definition</a> MUST be a <a>map</a>
11970
11970
composed of zero or more keys from
11971
11971
<code>@id</code>,
11972
+ <code class="changed">@import</code>,
11972
11973
<code>@reverse</code>,
11973
11974
<code>@type</code>,
11974
11975
<code>@language</code>,
11975
11976
<code>@container</code>,
11976
11977
<code class="changed">@context</code>,
11977
- <code class="changed">@prefix</code>,
11978
- <code class="changed">@propagate</code>, or
11979
- <code class="changed">@source</code>.
11978
+ <code class="changed">@prefix</code>, or
11979
+ <code class="changed">@propagate</code>.
11980
11980
An <a>expanded term definition</a> SHOULD NOT contain any other keys.</p>
11981
11981
11982
11982
<p>If the term being defined is not a <a>compact IRI</a> or
@@ -12046,7 +12046,7 @@ <h2>Context Definitions</h2>
12046
12046
<p class="changed">If the <a>expanded term definition</a> contains the <code>@propagate</code>
12047
12047
<a>keyword</a>, its value MUST be <code>true</code> or <code>false</code>.</p>
12048
12048
12049
- <p class="changed">If the <a>expanded term definition</a> contains the <code>@source </code>
12049
+ <p class="changed">If the <a>expanded term definition</a> contains the <code>@import </code>
12050
12050
<a>keyword</a>, its value MUST be an <a>absolute IRI</a> or <a>relative IRI</a>.</p>
12051
12051
12052
12052
<p><a>Terms</a> MUST NOT be used in a circular manner. That is,
@@ -12207,10 +12207,10 @@ <h2>Keywords</h2>
12207
12207
12208
12208
<p>See <a class="sectionRef" href="#sets-and-lists"></a> for further discussion on sets and lists.</p>
12209
12209
</dd>
12210
- <dt class="changed">`@source `</dt><dd class="changed">
12211
- The `@source ` keyword MUST NOT be aliased, and MAY be used in a <a>context definition</a>.
12210
+ <dt class="changed">`@import `</dt><dd class="changed">
12211
+ The `@import ` keyword MUST NOT be aliased, and MAY be used in a <a>context definition</a>.
12212
12212
Its value MUST be an <a>absolute IRI</a> or <a>relative IRI</a>.
12213
- See <a class="sectionRef" href="#sourced -contexts"></a> for a further discussion.
12213
+ See <a class="sectionRef" href="#imported -contexts"></a> for a further discussion.
12214
12214
</dd>
12215
12215
<dt><code>@type</code></dt><dd>
12216
12216
The <code>@type</code> keyword MAY be aliased and MAY be used as a key in a <a>node object</a> or a <a>value object</a>.
@@ -13161,7 +13161,7 @@ <h2>Changes since JSON-LD Community Group Final Report</h2>
13161
13161
<li>By default, all contexts are propagated when traversing <a>node objects</a>, other than
13162
13162
type-scoped contexts. This can be controlled using the <code>@propagate</code>
13163
13163
<a>entry</a> in a <a>local context</a>.</li>
13164
- <li>A context may contain a <code>@source </code> <a>entry</a> used to reference a remote context
13164
+ <li>A context may contain an <code>@import </code> <a>entry</a> used to reference a remote context
13165
13165
within a context, allowing <code>JSON-LD 1.1</code> features to be added to contexts originally
13166
13166
authored for <code>JSON-LD 1.0</code>.</li>
13167
13167
</ul>
0 commit comments