diff --git a/shacl12-profiling/.prettierrc b/shacl12-profiling/.prettierrc new file mode 100644 index 00000000..07f3e78b --- /dev/null +++ b/shacl12-profiling/.prettierrc @@ -0,0 +1,14 @@ +{ + "useTabs": true, + "printWidth": 150, + "semi": true, + "singleQuote": false, + "quoteProps": "as-needed", + "jsxSingleQuote": false, + "trailingComma": "none", + "bracketSpacing": true, + "jsxBracketSameLine": false, + "htmlWhitespaceSensitivity": "ignore", + "arrowParens": "always", + "endOfLine": "lf" +} \ No newline at end of file diff --git a/shacl12-profiling/index.html b/shacl12-profiling/index.html new file mode 100644 index 00000000..6498ac12 --- /dev/null +++ b/shacl12-profiling/index.html @@ -0,0 +1,800 @@ + + + + + SHACL 1.2 Profiling + + + + + +
+

+ This document defines extensions of the SHACL Shapes Constraint Language created to allow for the profiling of specifications. +

+

+ SHACL is a language for validating RDF graphs against a set of conditions, so this document's scope is limited to the profiling of RDF graph models, including SHACL-defined models. +

+ +

+ The namespace for SHACL Profiling terms is http://www.w3.org/ns/shpr# +

+

+ The suggested prefix for the SHACL Profiling namespace is shpr +

+
+ +
+ +
+

Introduction

+

SHACL Profiling is the act of creating + a profile + of an RDF graph + using SHACL... + +

+

Terminology

+ +

+ Terminology used throughout this document is consistent with several sources: +

+
    +
  1. the main SHACL [[shacl]] specification +
      +
    • which references terms from RDF [[rdf11-concepts]]
      • +
    • technical terns for SHACL
      • +
    +
    2. +
  2. the Profiles Vocabulary [[dx-prof]], a W3C Dataset Exchange Working Group Note +
    • which defines general terms to do with profiling including the terms "profiling" / "profile"
    +
    3. +
+

+ The SHACL terms include + + binding + + , + + blank node + + , + + conformance + + , + + constraint + + , + + constraint component + + , + + data graph + + , + + datatype + + , + + failure + + , + + focus node + + , + + RDF graph + + , + ill-formed + , + IRI + , + + literal + + , + + local name + + , + + member + + , + + node + + , + + node shape + + , + + object + + , + + parameter + + , + + pre-binding + + , + + predicate + + , + + property path + + , + + property shape + + , + + RDF term + + , + + SHACL instance + + , + + SHACL list + + , + + SHACL subclass + + , + + shape + + , + + shapes graph + + , + + solution + + , + + subject + + , + + target + + , + + triple + + , + validation + , + + validation report + + , + + validation result + + , + + validator + + , + + value + + , + + value node + + . +

+

+ The general profiling terms include + + specification + + , + + [data] profile + + , + + metadata + + . +

+
+
+

Document Conventions

+

+ Within this document, the following namespace prefix definitions are used: +

+ + + + + + + + + + + + + + + + + + + + + + + + + +
PrefixNamespace
rdf:http://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfs:http://www.w3.org/2000/01/rdf-schema#
sh:http://www.w3.org/ns/shacl#
xsd:http://www.w3.org/2001/XMLSchema#
ex:http://example.com/ns#
+ +

+ Within this document, the following JSON-LD context is used: +

+ 
{
+  "@context": {
+    "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
+    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
+    "sh": "http://www.w3.org/ns/shacl#",
+    "xsd": "http://www.w3.org/2001/XMLSchema#",
+    "ex": "http://example.com/ns#"
+  }
+}
+

+ Note that the URI of the graph defining the SHACL vocabulary itself is equivalent to + the namespace above, i.e., it includes the #. + References to the SHACL vocabulary, e.g., via owl:imports should include the #. +

+

+ Throughout the document, color-coded boxes containing RDF graphs in Turtle and JSON-LD will appear. + These fragments of Turtle documents use the prefix bindings given above. + The JSON-LD document fragments use the context given above. + Only the Turtle documents may highlight certain parts. +

+ +
+
+# This box represents an input shapes graph + +# Triples that can be omitted are marked as grey, e.g. -- +<s> <p> <o> . +
+
+ 
// This box represents an input shapes graph
+ 
{
+  "@id": "ex:s",
+  "ex:p": {
+    "@id": "ex:o"
+  }
+}
+
+
+ +
+
+# This box represents an input data graph. +# When highlighting is used in the examples: + +# Elements highlighted in blue are focus nodes +ex:Bob a ex:Person . + +# Elements highlighted in red are focus nodes that fail validation +ex:Alice a ex:Person . +
+
+ 
// This box represents an input data graph
+ 
{
+	"@graph": [
+		{
+			"@id": "ex:Alice",
+			"@type": "ex:Person"
+		},
+		{
+			"@id": "ex:Bob",
+			"@type": "ex:Person"
+		}
+	]
+}
+
+
+ +
+
+# This box represents an output results graph +
+
+ 
// This box represents an output results graph
+
+
+ +

+ Grey boxes such as this include syntax rules that apply to the shapes graph. +

+ +

+ true denotes the RDF term "true"^^xsd:boolean. + false denotes the RDF term "false"^^xsd:boolean. +

+ +
+
+

TODO

+
+
+ +
+

Section

+

Content.

+
+ +
+

Summary of Syntax Rules from this Document

+
+ +
+

Security Considerations

+

TODO

+
+ +
+

Privacy Considerations

+

TODO

+
+ +
+

Acknowledgements

+

Many people contributed to this document, including members of the RDF Data Shapes Working Group.

+
+ +
+

Internationalization Considerations

+

TODO

+
+ +
+ +
+ +
+ +