From d1250faeb87bdf08e08a6a8924c453266307e06c Mon Sep 17 00:00:00 2001 From: Gregg Kellogg Date: Mon, 19 Aug 2019 16:30:30 -0700 Subject: [PATCH] Update Embedding JSON-LD in HTML Documents to reference the "HTML script extraction" feature that processors may implement. Also, removes processor levels describing this as a processor supporting "HTML script extraction". For #213. --- index.html | 56 ++++++------------------------------------------------ 1 file changed, 6 insertions(+), 50 deletions(-) diff --git a/index.html b/index.html index 17c32479..1d07a201 100644 --- a/index.html +++ b/index.html @@ -678,52 +678,6 @@

Syntax Tokens and Keywords

These are used within this document as part of a compact IRI as a shorthand for the resulting absolute IRI, such as dcterms:title used to represent http://purl.org/dc/terms/title.

- -
-

Processor Levels

- - - -

JSON-LD mostly uses the JSON syntax [[RFC8259]] along with - various micro-syntaxes based on XML Schema datatypes [[XMLSCHEMA11-2]]. - However, it has become increasingly common to include JSON within - a script element - within an HTML document [[HTML]], - as described in . - As not all processors operate in an environment which can include HTML, - this specification describes various categories of JSON-LD processors.

- -

A pure JSON Processor only requires the use of a - JSON processor and is restricted to processing documents retrieved - with a JSON content type (e.g., application/ld+json or other JSON type).

- -

A full Processor is capable of processing JSON-LD embedded in HTML, - in addition to the capabilities of a pure JSON Processor.

- -
-

Additional Processor Levels

- -

In addition to the normatively defined processor levels, an additional processor - level is defined for reference.

- -

A event-based JSON Processor processes a stream of characters - expecting an event after each syntactic element is encountered. - Such processors are sensitive to the order of the members of JSON objects, - which can have a performance impact if the members of JSON objects are encountered in an unexpected order. - An event-based JSON Processor may process JSON-LD embedded in HTML.

- -

An event-based JSON Processor - may be sensitive to processing certain keywords in order, including - @context, @id, and @type.

-
-
@@ -9807,7 +9761,7 @@

Graph Containers

of JSON-LD (see ). This includes a general mechanism for loading remote documents, including referenced JSON-LD documents and remote contexts, - and extracting embedded JSON-LD from other formats such as [[HTML]]. + and potentially extracting embedded JSON-LD from other formats such as [[HTML]]. This is more fully described in Remote Document and Context Retrieval in [[JSON-LD11-API]].

@@ -11007,7 +10961,10 @@

Graph Containers

Embedding JSON-LD in HTML Documents

-

This section describes features available to a full Processor.

+

This section describes features available + with a documentLoader supporting HTML script extraction. + See Remote Document and Context Retrieval + for more information.

JSON-LD content can be easily embedded in HTML [[HTML]] by placing @@ -12734,7 +12691,7 @@

Privacy Considerations

(see [[?fingerprinting-guidance]]), and and provide an opportunity for a man-in-the-middle attack. To protect against this, publishers should consider caching remote contexts for future use, - or use the documentLoader + or use the documentLoader to maintain a local version of such contexts.

@@ -13374,7 +13331,6 @@

Changes since JSON-LD Community Group Final Report

Define the rdf:JSON datatype.
  • Term definitions with keys which are of the form of a compact IRI or absolute IRI MUST NOT expand to an IRI other than the expansion of the key itself.
    • -
  • Define different processor modes: pure JSON Processor, event-based JSON processor, and full Processor.
  • A frame may also be located within an HTML document, identified using type application/ld+json;profile=http://www.w3.org/ns/json-ld#frame.
  • Term definitions can now be protected,