You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jena.apache.org by gi...@apache.org on 2022/01/12 13:37:04 UTC
[jena-site] branch asf-site updated: Updated site from main (4cd0557baa0461f139913d3766a7fca181853635)
This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/jena-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 7c1cb28 Updated site from main (4cd0557baa0461f139913d3766a7fca181853635)
7c1cb28 is described below
commit 7c1cb28f1e59c7032544f83ff20d2ce63c361175
Author: jenkins <bu...@apache.org>
AuthorDate: Wed Jan 12 13:37:02 2022 +0000
Updated site from main (4cd0557baa0461f139913d3766a7fca181853635)
---
content/documentation/index.xml | 2 +-
content/documentation/rdf-star/index.html | 41 +++++++++++++++++--------------
content/index.xml | 2 +-
content/sitemap.xml | 4 +--
4 files changed, 27 insertions(+), 22 deletions(-)
diff --git a/content/documentation/index.xml b/content/documentation/index.xml
index 844f5d9..e895134 100644
--- a/content/documentation/index.xml
+++ b/content/documentation/index.xml
@@ -1618,7 +1618,7 @@ The supported datatypes (including those required by SPARQL 1.1), including full
<guid>https://jena.apache.org/documentation/rdf-star/</guid>
<description>RDF-star is an extension to RDF that provides a way for one triple to refer to another triple. RDF* is the name of the original work which is described in Olaf Hartig&rsquo;s blog entry.
Example:
-&lt;&lt;:johnfoaf:name&#34;John Smith&#34;&gt;&gt;dct:source&lt;http://example/directory&gt;.The part &lt;&lt; :john foaf:name &quot;John Smith&quot; &gt;&gt; is an embedded triple and refers to the triple with subject :john, property foaf:name and object &quot;John Smith&quot;.
+&lt;&lt;:johnfoaf:name&#34;John Smith&#34;&gt;&gt;dct:source&lt;http://example/directory&gt;.The part &lt;&lt; :john foaf:name &quot;John Smith&quot; &gt;&gt; is a quoted triple and refers to the triple with subject :john, property foaf:name and object &quot;John Smith&quot;.
Triple terms can be in the subject or object position.</description>
</item>
diff --git a/content/documentation/rdf-star/index.html b/content/documentation/rdf-star/index.html
index e88dab2..8a803e1 100644
--- a/content/documentation/rdf-star/index.html
+++ b/content/documentation/rdf-star/index.html
@@ -178,25 +178,26 @@ original work which is described in
<a href="https://blog.liu.se/olafhartig/2019/01/10/position-statement-rdf-star-and-sparql-star/">Olaf Hartig’s blog entry</a>.</p>
<p>Example:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-turtle" data-lang="turtle"><span style=""><<</span><span style="color:#bbb"> </span><span style="color:#00f;font-weight:bold">:</span><span style="color:#008000;font-weight:bold">john</span><span style="color:#bbb"> </span><span style="color:#00f;font-weight:bold">foaf:</span><span style="color:#008000;font-weight:bold">name</span><span style="color:#bbb"> </s [...]
-</span></code></pre></div><p>The part <code><< :john foaf:name "John Smith" >></code> is an embedded triple and refers to the triple with subject <code>:john</code>, property <code>foaf:name</code> and object <code>"John Smith"</code>.</p>
+</span></code></pre></div><p>The part <code><< :john foaf:name "John Smith" >></code> is a quoted triple and refers to the triple with subject <code>:john</code>, property <code>foaf:name</code> and object <code>"John Smith"</code>.</p>
<p>Triple terms can be in the subject or object position.</p>
<p>Jena provides support for RDF-star and the related SPARQL-star.</p>
<ul>
<li>Turtle, N-Triples, TriG and N-Quads extended for Triple Terms syntax,
input and output. There is no output in RDF/XML.</li>
-<li>SPARQL extended with Triple Term syntax for graph matching</li>
-<li>SPARQL Result formats for JSON and XML extended to support Triple Terms in results.</li>
+<li>SPARQL extended with Triple Term syntax for graph matching.</li>
+<li>SPARQL Result formats for JSON and XML extended to support quoted triples in results.</li>
<li>Support in the Model API.</li>
+<li>Translation to and from RDF reification.</li>
</ul>
<p>All this is active by default in Fuseki.</p>
<p>The aim is to follow the definition of the <a href="https://w3c.github.io/rdf-star/">RDF-star community</a>.</p>
<p>Storage in databases <a href="/documentation/tdb">TDB1</a> and <a href="/documentation/tdb2/">TDB2</a>
as well as in-memory databases is supported.</p>
<h2 id="rdf-star">RDF-star</h2>
-<p>RDF-star syntax for embedded triples is added to the parsers for Turtle, N-Triples, TriG and N-Quads.</p>
-<p>Datasets may have graphs that have embedded triples that refer to triples anywhere, not just in the same graph.</p>
+<p>RDF-star syntax for quoted triples is added to the parsers for Turtle, N-Triples, TriG and N-Quads.</p>
+<p>Datasets may have graphs that have quoted triples that refer to triples anywhere, not just in the same graph.</p>
<h2 id="sparql-star">SPARQL-star</h2>
-<p>Matches for embedded triples:</p>
+<p>Matches for quoted triples:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-sparql" data-lang="sparql"><span style="color:#a2f;font-weight:bold">SELECT</span> <span style="color:#b8860b">?name</span> { <span style="color:#666"><<</span>:<span style="color:#008000;font-weight:bold">john</span> <span style="color:#00f;font-weight:bold">foaf</span>:<span style="color:#008000;font-weight:bold">name</span> <span style="color:#b8860b">?name [...]
</code></pre></div><p>Insert triples terms into the default graph to record the graph source.</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-sparql" data-lang="sparql"><span style="color:#a2f;font-weight:bold">INSERT</span> { <span style="color:#666"><<</span><span style="color:#b8860b">?s</span> <span style="color:#b8860b">?p</span> <span style="color:#b8860b">?o</span><span style="color:#666">>></span> <span style="color:#00f;font-weight:bold">dct</span>:<span style="color:#008000;font-weig [...]
@@ -213,9 +214,8 @@ as well as in-memory databases is supported.</p>
</code></pre></div><div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-sparql" data-lang="sparql"><span style="color:#a2f;font-weight:bold">SELECT</span> (<span style="color:#666"><<</span> <span style="color:#b8860b">?s</span> <span style="color:#b8860b">?p</span> <span style="color:#b8860b">?o</span><span style="color:#666">>></span> <span style="color:#a2f;font-weight:bold">AS</span> <span style="color [...]
<span style="color:#b8860b">?s</span> <span style="color:#b8860b">?p</span> <span style="color:#b8860b">?o</span>
}
-</code></pre></div><h3 id="sparql-functions-related-to-embedded-triples">SPARQL Functions related to embedded triples</h3>
-<p>These functions cause an expression error if passed the wrong type of arguments. <code>afn:</code>
-is a prefix for <code><http://jena.apache.org/ARQ/function#></code>.</p>
+</code></pre></div><h3 id="sparql-functions-related-to-quoted-triples">SPARQL Functions related to quoted triples</h3>
+<p>These functions cause an expression error if passed the wrong type of arguments.</p>
<table>
<thead>
<tr>
@@ -226,30 +226,30 @@ is a prefix for <code><http://jena.apache.org/ARQ/function#></code>.</p>
<tbody>
<tr>
<td><code>TRIPLE(?s, ?p, ?o)</code></td>
-<td>Create an embedded triple from s/p/o</td>
+<td>Create a quoted triple from s/p/o</td>
</tr>
<tr>
<td><code>isTRIPLE(?t)</code></td>
-<td>Return true if the argument value is an embedded triple</td>
+<td>Return true if the argument value is a quoted triple</td>
</tr>
<tr>
<td><code>SUBJECT(?t)</code></td>
-<td>Return the subject of the embedded triple</td>
+<td>Return the subject of the quoted triple</td>
</tr>
<tr>
<td><code>PREDICATE(?t)</code></td>
-<td>Return the predicate (property) of the embedded triple</td>
+<td>Return the predicate (property) of the quoted triple</td>
</tr>
<tr>
<td><code>OBJECT(?t)</code></td>
-<td>Return the object of the embedded triple</td>
+<td>Return the object of the quoted triple</td>
</tr>
</tbody>
</table>
<h3 id="sparql-results">SPARQL results</h3>
<p>The syntaxes for SPARQL results from a SELECT query, <code>application/sparql-results+json</code>,
-<code>application/sparql-results+xml</code> are extended to include embedded triples:</p>
-<p>The embedded triple <code><< _:b0 <http://example/p> 123 >></code> is encoded, in
+<code>application/sparql-results+xml</code> are extended to include quoted triples:</p>
+<p>The quoted triple <code><< _:b0 <http://example/p> 123 >></code> is encoded, in
<code>application/sparql-results+json</code> as:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-json" data-lang="json"> {
<span style="color:#008000;font-weight:bold">"type"</span>: <span style="color:#b44">"triple"</span> ,
@@ -271,15 +271,20 @@ is a prefix for <code><http://jena.apache.org/ARQ/function#></code>.</p>
<span style="color:#008000;font-weight:bold"></object></span>
<span style="color:#008000;font-weight:bold"></triple></span>
</code></pre></div><h2 id="model-api">Model API</h2>
-<p>RDF-star embedded triples are treated as <code>Resource</code> to preserve the typed Model API.
+<p>RDF-star quoted triples are treated as <code>Resource</code> to preserve the typed Model API.
They occur in the subject and object positions.</p>
-<p>A <code>Resource</code> contains a <code>Statement</code> object if the underlying RDF term is an RDF-star embedded triple.</p>
+<p>A <code>Resource</code> contains a <code>Statement</code> object if the underlying RDF term is an RDF-star quoted triple.</p>
<p>New methods include:</p>
<ul>
<li><code>Statement Resource.getStatement()</code></li>
<li><code>Resource Model.createResource(Statement)</code></li>
<li><code>Resource ResourceFactory.createStatement</code></li>
</ul>
+<h2 id="reification">Reification</h2>
+<p><code>org.apache.jena.system.RDFStar</code> provides functions to translate RDF-star into
+RDF reification, and translate it back again to RDF-star.</p>
+<p>Translating back to RDF-star relies on the consistency constraint that there is
+only one reification for each unique quoted triple term.</p>
</div>
diff --git a/content/index.xml b/content/index.xml
index 5805a8c..164b15d 100644
--- a/content/index.xml
+++ b/content/index.xml
@@ -1901,7 +1901,7 @@ The supported datatypes (including those required by SPARQL 1.1), including full
<guid>https://jena.apache.org/documentation/rdf-star/</guid>
<description>RDF-star is an extension to RDF that provides a way for one triple to refer to another triple. RDF* is the name of the original work which is described in Olaf Hartig&rsquo;s blog entry.
Example:
-&lt;&lt;:johnfoaf:name&#34;John Smith&#34;&gt;&gt;dct:source&lt;http://example/directory&gt;.The part &lt;&lt; :john foaf:name &quot;John Smith&quot; &gt;&gt; is an embedded triple and refers to the triple with subject :john, property foaf:name and object &quot;John Smith&quot;.
+&lt;&lt;:johnfoaf:name&#34;John Smith&#34;&gt;&gt;dct:source&lt;http://example/directory&gt;.The part &lt;&lt; :john foaf:name &quot;John Smith&quot; &gt;&gt; is a quoted triple and refers to the triple with subject :john, property foaf:name and object &quot;John Smith&quot;.
Triple terms can be in the subject or object position.</description>
</item>
diff --git a/content/sitemap.xml b/content/sitemap.xml
index 818c00a..ab0528e 100644
--- a/content/sitemap.xml
+++ b/content/sitemap.xml
@@ -329,7 +329,7 @@
<url>
<loc>https://jena.apache.org/documentation.html</loc>
- <lastmod>2021-12-29T20:51:12+00:00</lastmod>
+ <lastmod>2022-01-12T11:39:44+00:00</lastmod>
</url>
<url>
@@ -904,7 +904,7 @@
<url>
<loc>https://jena.apache.org/documentation/rdf-star/</loc>
- <lastmod>2021-04-19T17:12:24+01:00</lastmod>
+ <lastmod>2022-01-12T11:39:44+00:00</lastmod>
</url>
<url>