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 2020/08/12 20:27:16 UTC
[jena-site] branch asf-site updated: Updated site from master
(9f9cf55dbcbc08e92041147a1aea21c326add3c5)
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 ac26643 Updated site from master (9f9cf55dbcbc08e92041147a1aea21c326add3c5)
ac26643 is described below
commit ac26643e2b02a85ec3f3b12d12ed199de2a7622b
Author: jenkins <us...@infra.apache.org>
AuthorDate: Wed Aug 12 20:27:10 2020 +0000
Updated site from master (9f9cf55dbcbc08e92041147a1aea21c326add3c5)
---
content/documentation/index.xml | 6 +++---
content/documentation/shacl/index.html | 32 +++++++++++++++++++++++---------
content/index.xml | 6 +++---
content/sitemap.xml | 4 ++--
4 files changed, 31 insertions(+), 17 deletions(-)
diff --git a/content/documentation/index.xml b/content/documentation/index.xml
index 0eaabfd..446b2c5 100644
--- a/content/documentation/index.xml
+++ b/content/documentation/index.xml
@@ -124,15 +124,15 @@ The sequence from core to TDB should be executed before application components.
</item>
<item>
- <title>Apache Jena Shacl</title>
+ <title>Apache Jena SHACL</title>
<link>https://jena.apache.org/documentation/shacl/</link>
<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
<guid>https://jena.apache.org/documentation/shacl/</guid>
- <description>jena-shacl is an implementation of the W3C Shapes Constraint Language (SHACL). It implements SHACL Core and SHACL SPARQL Constraints.
+ <description>jena-shacl is an implementation of the W3C Shapes Constraint Language (SHACL). It implements SHACL Core and SHACL SPARQL Constraints. It also provides a reader and writer for SHACL Compact Syntax.
Command line The command shacl introduces shacl operations; it takes a sub-command argument.
To validate:
-shacl validate --shapes SHAPES.ttl --data DATA.ttl shacl v -s SHAPES.ttl -d DATA.ttl The shapes and data files can be the same; the --shapes is optional and default to the same as --data. This includes running individual W3C Working Group tests.</description>
+shacl validate --shapes SHAPES.ttl --data DATA.ttl shacl v -s SHAPES.ttl -d DATA.ttl The shapes and data files can be the same; the --shapes is optional and defaults to the same as --data.</description>
</item>
<item>
diff --git a/content/documentation/shacl/index.html b/content/documentation/shacl/index.html
index 47741e1..37b1e72 100644
--- a/content/documentation/shacl/index.html
+++ b/content/documentation/shacl/index.html
@@ -3,7 +3,7 @@
<head>
- <title>Apache Jena - Apache Jena Shacl</title>
+ <title>Apache Jena - Apache Jena SHACL</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
@@ -168,11 +168,13 @@
</div>
- <h1 class="title">Apache Jena Shacl</h1>
+ <h1 class="title">Apache Jena SHACL</h1>
- <p>jena-shacl is an implementation of the
+ <p><code>jena-shacl</code> is an implementation of the
W3C <a href="https://www.w3.org/TR/shacl/">Shapes Constraint Language (SHACL)</a>.
-It implements SHACL Core and SHACL SPARQL Constraints.</p>
+It implements SHACL Core and SHACL SPARQL Constraints.
+It also provides a reader and writer for
+<a href="https://w3c.github.io/shacl/shacl-compact-syntax/">SHACL Compact Syntax</a>.</p>
<h2 id="command-line">Command line</h2>
<p>The command <code>shacl</code> introduces shacl operations; it takes a sub-command
argument.</p>
@@ -180,12 +182,15 @@ argument.</p>
<pre>shacl validate --shapes <i>SHAPES.ttl</i> --data <i>DATA.ttl</i></pre>
<pre>shacl v -s <i>SHAPES.ttl</i> -d <i>DATA.ttl</i></pre>
<p>The shapes and data files can be the same; the <code>--shapes</code> is optional and
-default to the same as <code>--data</code>. This includes running individual W3C Working
+defaults to the same as <code>--data</code>. This includes running individual W3C Working
Group tests.</p>
-<p>To parse a file</p>
+<p>To parse a file:</p>
<pre>shacl parse <i>FILE</i></pre>
<pre>shacl p <i>FILE</i></pre>
<p>which writes out a text format.</p>
+<pre>shacl p <i>--out=FMT</i> <i>FILE</i></pre>
+<p>writes out in <code>text</code>(<code>t</code>), <code>compact</code>(<code>c</code>), <code>rdf</code>(<code>r</code>) formats. Multiple formats can be given,
+separated by “,” and format <code>all</code> outputs all 3 formats.</p>
<h2 id="integration-with-apache-jena-fuseki">Integration with Apache Jena Fuseki</h2>
<p>Fuseki has a new service operation <code>fuseki:shacl</code>:</p>
<pre>
@@ -209,6 +214,7 @@ content negotiation.</p>
is the URI of a named graph, <code>default</code> for the unnamed, default graph (and
this is the assumed value of <code>?graph</code> if not present), or <code>union</code> for union of
all named graphs in the dataset.</p>
+<p>Further, an argument <tt>target=<i>uri</i></tt> validates a specific node in the data.</p>
<p>Upload data in file <code>fu-data.ttl</code>:</p>
<pre><code>curl -XPOST --data-binary @fu-data.ttl \
--header 'Content-type: text/turtle' \
@@ -250,14 +256,22 @@ shows validation and printing of the validation report in a text form and in RDF
shows how to update a graph only if, after the changes, the graph is validated
according to the shapes provided.</p>
<h2 id="shacl-compact-syntax">SHACL Compact Syntax</h2>
-<p>Jena can read
-<a href="https://w3c.github.io/shacl/shacl-compact-syntax/">SHACL Compact Syntax</a>.
-The file extensions are <code>.shc</code> and <code>.shaclc</code> and there is a registered language
+<p>Apache Jena supports
+<a href="https://w3c.github.io/shacl/shacl-compact-syntax/">SHACL Compact Syntax (SHACL-C)</a>
+for both reading and writing.</p>
+<p>The file extensions for SHACL-C are <code>.shc</code> and <code>.shaclc</code> and there is a registered language
constant <code>Lang.SHACLC</code>.</p>
<pre><code>RDFDataMgr.load("shapes.shc");
RDFDataMgr.read("file:compactShapes", Lang.SHACLC);
+
+RDFDataMgr.write(System.out, shapesGraph, Lang.SHACLC);
</code></pre>
+<p>SHACL-C is managed by the SHACL Community Group. It does not cover all possible shapes.
+When outputting SHACL-C, SHACL shapes not expressible in SHACL-C will cause an
+exception and data in the RDF graph that is not relevant will not be output. In
+other words, SHACL-C is a lossy format for RDF.</p>
+<p>The Jena SHACL-C writer will output any valid SHACL-C document.</p>
</div>
diff --git a/content/index.xml b/content/index.xml
index fa77942..d172637 100644
--- a/content/index.xml
+++ b/content/index.xml
@@ -175,15 +175,15 @@ Download Mirrors [if-any logo] [end] The currently selected mirror is [preferred
</item>
<item>
- <title>Apache Jena Shacl</title>
+ <title>Apache Jena SHACL</title>
<link>https://jena.apache.org/documentation/shacl/</link>
<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
<guid>https://jena.apache.org/documentation/shacl/</guid>
- <description>jena-shacl is an implementation of the W3C Shapes Constraint Language (SHACL). It implements SHACL Core and SHACL SPARQL Constraints.
+ <description>jena-shacl is an implementation of the W3C Shapes Constraint Language (SHACL). It implements SHACL Core and SHACL SPARQL Constraints. It also provides a reader and writer for SHACL Compact Syntax.
Command line The command shacl introduces shacl operations; it takes a sub-command argument.
To validate:
-shacl validate --shapes SHAPES.ttl --data DATA.ttl shacl v -s SHAPES.ttl -d DATA.ttl The shapes and data files can be the same; the --shapes is optional and default to the same as --data. This includes running individual W3C Working Group tests.</description>
+shacl validate --shapes SHAPES.ttl --data DATA.ttl shacl v -s SHAPES.ttl -d DATA.ttl The shapes and data files can be the same; the --shapes is optional and defaults to the same as --data.</description>
</item>
<item>
diff --git a/content/sitemap.xml b/content/sitemap.xml
index a4dafb7..ec303ef 100644
--- a/content/sitemap.xml
+++ b/content/sitemap.xml
@@ -89,7 +89,7 @@
<url>
<loc>https://jena.apache.org/documentation/shacl/</loc>
- <lastmod>2020-07-17T11:34:38+01:00</lastmod>
+ <lastmod>2020-08-11T21:55:25+01:00</lastmod>
</url>
<url>
@@ -299,7 +299,7 @@
<url>
<loc>https://jena.apache.org/documentation.html</loc>
- <lastmod>2020-08-10T23:07:00+12:00</lastmod>
+ <lastmod>2020-08-11T21:55:25+01:00</lastmod>
</url>
<url>