test RDF in a data island in the HTML

[bourgeoa]

@melvincarvalho
How can I help you ?

• I can create a branch
• I can review your code. The problem is I don't know how dataIsland is defined in HTML ? which tag ? I suppose we need to parse the html content
  • just as reminder a container/ with index.html automatically serves index.html
  • how do you expect to render RDF ? with an accept Header

An Html file with a dataIsland example may help me to understand.

[melvincarvalho]

@bourgeoa thanks for looking at this

A structured data island is simply:

<script type="application/ld+json" id="data">
{
  "json-ld": "goes here"
}
</script>

Then the content of the script would be whatever the JSON-LD is for that resource

So in the case where we have mashlib in a script an extra script tag is inserted with the data too

This would make all of the different mime types give back consistent RDF

Does that make sense?

[TallTed]

It's probably worth noting that such data islands may be in additional formats (media types), either in parallel with or instead of JSON-LD. At OpenLink Software, we commonly inject data islands in both JSON-LD and Turtle. Other media types have also been used in experiments but are not commonly parsed, so are not commonly injected.

[melvincarvalho]

@TallTed, do you have an example we could use as a template for learning,

[TallTed]

This article should be a help.

[bourgeoa]

So my understanding is the following :
For a file example.html

• data island is defined by these 2 elements :
  • a script tag. (Can there be multiple occurences ? consider only one for now)
  • a type the type can be any RDF contentType : turtle, jsonld, or XML
    nota : if multiple occurences of data island is allowed then a third parameter is needed.
    The id must be unique for the HTML document. It is not specific to script tag. may be 'data-*'
• text/html shall be considered an RDF by the server
  What should be the result of :
  • 'GET' on an html document with an Accept header contentType
    • return a script tag content with a type=any RDF contentType, content being converted to contentType
  • 'POST', 'PUT', DELETE have an action on the HTML document, including the data island
  • 'PATCH' has an action on the data island.

[bourgeoa]

The PR #1715 implements the following :

• a script block <script type="RDF contentType" id="data">RDF content</script>.
• id is not a MUST and not used by NSS
• a data island can be discovered from anywhere in the HTML resource.
• Both tags </script> and closing tag </script> are needed.
• the created or modified data island script is always inserted just before the closing </head> tag

Data island is fetched with :

• GET and returns an RDF resource depending on the RDF contentType Accept Header :
  • text/turtle, text/n3, application/ld+json, application/rdf+xml
  • no Accept Header or text/html return the usual HTML resource
• PATCH creates or modifies the HTML resource :
  • by default a new data island is created with a text/turtle contentType.
  • an existing data island is modified using the existing data island type parameter.

Question :
Should PATCH allow to store the data island using Accept Header ?
is using the Accept Header SOLID compliant ?

[melvincarvalho]

This is fantastic!

Could the default be application/ld+json or configurable, say, in the NSS config? Reason being that parsing JSON is native to the browser and easy

Unsure about the PATCH operation, isnt that server wide?

[melvincarvalho]

I tried running the dataIsland branch locally and managed to log in. But I was unable to see a data island in the webid profile that was created. Will have a look to see if there's anything obvious that can be fixed