Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
anaigmo committed May 9, 2023
2 parents 4a6504b + bfe8d84 commit aac326f
Show file tree
Hide file tree
Showing 24 changed files with 4,885 additions and 865 deletions.
397 changes: 397 additions & 0 deletions LICENSE

Large diffs are not rendered by default.

21 changes: 18 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,12 @@
# Source & Target
# RML-IO

Repository for RML Source & Target specification.
Deployed to https://kg-construct.github.io/rml-io/spec/docs
Repository for RML-IO specification, ontology, SHACL shapes and test cases.

- Specification: http://w3id.org/rml/io/spec/
- Ontology: http://w3id.org/rml/io
- Shapes: http://w3id.org/rml/io/shapes
- Backwards compatibility with R2RML: http://w3id.org/rml/io/bc
- Test cases: [test-cases](./test-cases)

## Quickstart

Expand All @@ -13,3 +18,13 @@ Deployed to https://kg-construct.github.io/rml-io/spec/docs
- run `node publish.js` to get the index.html + archived version in the `dist` folder

The `dist` folder contents should mimic the contents on `https://w3id.org/kg-construct/rml-target-source`

## License

RML-IO (c) by W3C Community Group on Knowledge Graph Construction

RML-IO is licensed under a
Creative Commons Attribution-ShareAlike 4.0 International License.

You should have received a copy of the license along with this
work. If not, see <http://creativecommons.org/licenses/by-sa/4.0/>.
28 changes: 14 additions & 14 deletions shapes/io.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -29,16 +29,16 @@
@prefix xml: <http://www.w3.org/XML/1998/namespace> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

<http://schema.org/RMLIOLogicalSourceShape> a sh:NodeShape ;
<http://w3id.org/rml/shapes/RMLLogicalSourceShape> a sh:NodeShape ;
sh:description """
A logical source is any source that is mapped to RDF triples.
""" ;
sh:message """
RMLIO Logical Source requires one rml:source and depending on the source
RML Logical Source requires one rml:source and depending on the source
type: one rml:query, one rml:referenceFormulation and/or
one rml:iterator.
""" ;
sh:name "RMLIO Logical Source" ;
sh:name "RML Logical Source" ;
sh:property [ sh:description """
The source (rml:source) locates the input data source. It is a URI
that represents the data source where the data source is.
Expand All @@ -50,7 +50,7 @@
""" ;
sh:minCount 1 ;
sh:name "rml:source" ;
sh:node <http://schema.org/RMLIOSourceShape> ;
sh:node <http://w3id.org/rml/shapes/RMLSourceShape> ;
sh:nodeKind sh:BlankNodeOrIRI ;
sh:path rml:source ],
[ sh:datatype xsd:string ;
Expand Down Expand Up @@ -84,15 +84,15 @@
sh:targetClass rml:LogicalSource ;
sh:targetObjectsOf rml:logicalSource .

<http://schema.org/RMLIOLogicalTargetShape> a sh:NodeShape ;
<http://w3id.org/rml/shapes/RMLLogicalTargetShape> a sh:NodeShape ;
sh:description """
A logical target is any target to where generated RDF triples are exported
to.
""" ;
sh:message """
RMLIO Logical Target requires one rml:target.
RML Logical Target requires one rml:target.
""" ;
sh:name "RMLIO Logical Target" ;
sh:name "RML Logical Target" ;
sh:property [ sh:description """
The target (rml:target) locates the output target. It is a URI
that represents the target where it must export generated RDF triples
Expand All @@ -105,23 +105,23 @@
""" ;
sh:minCount 1 ;
sh:name "rml:target" ;
sh:node <http://schema.org/RMLIOTargetShape> ;
sh:node <http://w3id.org/rml/shapes/RMLTargetShape> ;
sh:nodeKind sh:BlankNodeOrIRI ;
sh:path rml:target ] ;
sh:targetClass rml:LogicalTarget ;
sh:targetObjectsOf rml:logicalTarget .

<http://schema.org/RMLIOSourceShape> a sh:NodeShape ;
<http://w3id.org/rml/shapes/RMLSourceShape> a sh:NodeShape ;
sh:description """
A source describes access to a data source. Any data access description
is allowed, but rml:Source provides additional properties to complete
such descriptions.
""" ;
sh:message """
RMLIO Source accepts one or multiple rml:null, one rml:query,
RML Source accepts one or multiple rml:null, one rml:query,
one rml:compression, and one rml:encoding. All of them are optional.
""" ;
sh:name "RMLIO Source" ;
sh:name "RML Source" ;
sh:property [ sh:datatype xsd:string ;
sh:description """
rml:null specifies how NULL or empty values are exposed by the data
Expand Down Expand Up @@ -186,17 +186,17 @@
sh:targetClass rml:Source ;
sh:targetObjectsOf rml:source .

<http://schema.org/RMLIOTargetShape> a sh:NodeShape ;
<http://w3id.org/rml/shapes/RMLTargetShape> a sh:NodeShape ;
sh:description """
A target describes access to a data target. Any data access description
is allowed, but rml:Target provides additional properties to complete
such descriptions.
""" ;
sh:message """
RMLIO Target accepts one rml:compression, and one rml:encoding.
RML Target accepts one rml:compression, and one rml:encoding.
All of them are optional.
""" ;
sh:name "RMLIO Target" ;
sh:name "RML Target" ;
sh:property [ sh:description """
rml:compression specifies the compression algorithm to use when
accessing the data target. By default, no compression is applied.
Expand Down
10 changes: 5 additions & 5 deletions shapes/logical_source.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -3,22 +3,22 @@
# Copyright Dylan Van Assche, IDLab - UGent - imec (2020 - 2023) #
###############################################################################
@prefix sh: <http://www.w3.org/ns/shacl#> .
@prefix schema: <http://schema.org/> .
@prefix : <http://w3id.org/rml/shapes/> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rml: <http://w3id.org/rml/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

schema:RMLIOLogicalSourceShape
:RMLLogicalSourceShape
a sh:NodeShape ;
sh:targetObjectsOf rml:logicalSource ; # Object of rml:TriplesMap
sh:targetClass rml:LogicalSource ; # Used as a class
# Already targets 'rml:logicalSource'
sh:name "RMLIO Logical Source" ;
sh:name "RML Logical Source" ;
sh:description """
A logical source is any source that is mapped to RDF triples.
""" ;
sh:message """
RMLIO Logical Source requires one rml:source and depending on the source
RML Logical Source requires one rml:source and depending on the source
type: one rml:query, one rml:referenceFormulation and/or
one rml:iterator.
""" ;
Expand All @@ -38,7 +38,7 @@ schema:RMLIOLogicalSourceShape
sh:minCount 1 ;
sh:maxCount 1 ;
sh:nodeKind sh:BlankNodeOrIRI;
sh:node schema:RMLIOSourceShape;
sh:node :RMLSourceShape;
] ;

# rml:iterator
Expand Down
10 changes: 5 additions & 5 deletions shapes/logical_target.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -3,23 +3,23 @@
# Copyright Dylan Van Assche, IDLab - UGent - imec (2023) #
###############################################################################
@prefix sh: <http://www.w3.org/ns/shacl#> .
@prefix schema: <http://schema.org/> .
@prefix : <http://w3id.org/rml/shapes/> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rml: <http://w3id.org/rml/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

schema:RMLIOLogicalTargetShape
:RMLLogicalTargetShape
a sh:NodeShape ;
sh:targetObjectsOf rml:logicalTarget ; # Object of rml:TriplesMap
sh:targetClass rml:LogicalTarget ; # Used as a class
# Already targets 'rml:logicalTarget'
sh:name "RMLIO Logical Target" ;
sh:name "RML Logical Target" ;
sh:description """
A logical target is any target to where generated RDF triples are exported
to.
""" ;
sh:message """
RMLIO Logical Target requires one rml:target.
RML Logical Target requires one rml:target.
""" ;

# rml:target
Expand All @@ -38,6 +38,6 @@ schema:RMLIOLogicalTargetShape
sh:minCount 1 ;
sh:maxCount 1 ;
sh:nodeKind sh:BlankNodeOrIRI;
sh:node schema:RMLIOTargetShape;
sh:node :RMLTargetShape;
] ;
.
8 changes: 4 additions & 4 deletions shapes/source.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -3,24 +3,24 @@
# Copyright Dylan Van Assche, IDLab - UGent - imec (2023) #
###############################################################################
@prefix sh: <http://www.w3.org/ns/shacl#> .
@prefix schema: <http://schema.org/> .
@prefix : <http://w3id.org/rml/shapes/> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rml: <http://w3id.org/rml/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

schema:RMLIOSourceShape
:RMLSourceShape
a sh:NodeShape ;
sh:targetObjectsOf rml:source ; # Object of rml:LogicalSource
sh:targetClass rml:Source ; # Used as a class
# Already targets 'rml:source'
sh:name "RMLIO Source" ;
sh:name "RML Source" ;
sh:description """
A source describes access to a data source. Any data access description
is allowed, but rml:Source provides additional properties to complete
such descriptions.
""" ;
sh:message """
RMLIO Source accepts one or multiple rml:null, one rml:query,
RML Source accepts one or multiple rml:null, one rml:query,
one rml:compression, and one rml:encoding. All of them are optional.
""" ;

Expand Down
8 changes: 4 additions & 4 deletions shapes/target.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -3,24 +3,24 @@
# Copyright Dylan Van Assche, IDLab - UGent - imec (2023) #
###############################################################################
@prefix sh: <http://www.w3.org/ns/shacl#> .
@prefix schema: <http://schema.org/> .
@prefix : <http://w3id.org/rml/shapes/> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rml: <http://w3id.org/rml/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

schema:RMLIOTargetShape
:RMLTargetShape
a sh:NodeShape ;
sh:targetObjectsOf rml:target ; # Object of rml:LogicalTarget
sh:targetClass rml:Target ; # Used as a class
# Already targets 'rml:target'
sh:name "RMLIO Target" ;
sh:name "RML Target" ;
sh:description """
A target describes access to a data target. Any data access description
is allowed, but rml:Target provides additional properties to complete
such descriptions.
""" ;
sh:message """
RMLIO Target accepts one rml:compression, and one rml:encoding.
RML Target accepts one rml:compression, and one rml:encoding.
All of them are optional.
""" ;

Expand Down
14 changes: 2 additions & 12 deletions spec/dev.html
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<!DOCTYPE html>
<html>
<head>
<title>Source &amp; Target</title>
<title>RML-IO</title>
<meta charset='utf-8'>
<link rel="stylesheet" type="text/css" href="./resources/css/extras.css"/>
<script src="https://www.w3.org/Tools/respec/respec-w3c" class="remove" defer></script>
Expand Down Expand Up @@ -299,21 +299,11 @@
// !!!! IMPORTANT !!!! MAKE THE ABOVE BLINK IN YOUR HEAD
};
</script>
<script data-goatcounter="https://dataio.goatcounter.com/count"
async src="//gc.zgo.at/count.js"></script>
<noscript>
<img src="https://dataio.goatcounter.com/count?p=/test-noscript">
</noscript>
</head>
<body>
<section id='abstract' data-include="section/abstract.md" data-include-format="markdown"></section>

<section id='sotd'>
<p data-format="markdown">
This is an early draft,
yet efforts are made to keep things stable.
</p>
</section>
<section id='sotd'></section>

<section id="conformance"></section>

Expand Down
Loading

0 comments on commit aac326f

Please sign in to comment.