Merge branch 'main' of https://github.com/kg-construct/rml-fnml

Author: anaigmo

CITATION.cff

@@ -0,0 +1,16 @@
+title: "RML-FNML: Ontology, specification, shapes and test cases"
+license: CC-BY-4.0
+authors:
+  - family-names: De Meester
+    given-names: Ben
+  - family-names: Jozashoori
+    given-names: Samaneh
+  - family-names: Iglesias-Molina
+    given-names: Ana
+  - family-names: Van Assche
+    given-names: Dylan
+cff-version: 1.0.0
+version: 0.1.0
+doi: 10.5281/zenodo.7919856
+date-released: 2023-05-10
+url: "https://w3id.org/rml/fnml"

README.md

@@ -7,6 +7,23 @@ The FNML specification, SHACL shapes, test-cases, and ontology.
 - SHACL shapes: http://w3id.org/rml/fnml/shapes
 - Test-cases: [test-cases](./test-cases)
 
+## Specification
+
+The specification webpage is generated from directory [/spec](spec).
+
+It is accessible using URL https://w3id.org/rml/fnml/spec.
+
+#### Edition quickstart
+
+- cd to [/spec](spec)
+- Edit sections/index.html
+- Make sure all your local assets are in the `resources` folder, and the links in your `index.html` file are relative (important because the publishing script creates multiple nested paths)
+- Run a HTTP server in this directory: `python3 -m http.server`
+- Open `index.html` with a browser as http://localhost:8000/index.html
+- Save as snapshot to `rendered.html` [using the respec functionality](https://respec.org/docs/#using-browser) (button ReSpec/Export/HTML) and copy it to this same folder
+
+URL https://w3id.org/rml/fnml/spec must redirect to the `/spec/docs`(docs) folder.
+
 ## License
 
 RML-FNML (c) by W3C Community Group on Knowledge Graph Construction

spec/docs/definitions.md

@@ -57,7 +57,7 @@ An [=Expression Map=] can have the following properties:
   The [=Function=] is specified using an [=Function Map=] and the [=Parameter=]s are specified using [=Input=]s.
   - As such, an Function Execution can be seen as a way to describe [=Execution=]s.
 - An <dfn>Function Map</dfn>: a [=Term Map=] that MUST generate a named node. That named node specifies the referenced [=Function=].
-  - This can also be specified using a [=constant shortcut property=].
+  - This can also be specified using a [=constant expression shortcut property=].
 - An <dfn>Input</dfn>: a construct to pairwise connect a value (via a [=Term Map=]) to a [=Parameter Map=].
   - This [=Term Map=] generates the input value that should be bound to the [=Parameter=] of the referenced [=Function=].
   - This [=Term Map=] refers to values from the [=Triples Map=]s iteration.

spec/docs/ontology.md

@@ -7,7 +7,7 @@ the preferred prefix is `rml:`.
 See below for how FNML introduced terms align with RML Core.
 
 <figure id="figure-diagram">
-  <img src="./diagrams/diagram.png" alt="FNML diagram" />
+  <img src="../diagrams/diagram.png" alt="FNML diagram" />
   <figcaption>Visual overview of how FNML introduced terms align with RML Core</figcaption>
 </figure>
 
@@ -88,7 +88,7 @@ Range: rml:ReturnMap
 
 #### rml:return
 
-[=constant shortcut property=] of rml:returnMap.
+[=constant expression shortcut property=] of rml:returnMap.
 
 ### rml:functionMap
 
@@ -100,7 +100,7 @@ Range: fno:Function
 
 #### rml:function
 
-[=constant shortcut property=] of rml:functionMap.
+[=constant expression shortcut property=] of rml:functionMap.
 
 ### rml:input
 
@@ -116,7 +116,7 @@ Range: rml:ParameterMap
 
 #### rml:parameter
 
-[=constant shortcut property=] of rml:parameterMap
+[=constant expression shortcut property=] of rml:parameterMap
 
 ### rml:inputValueMap
 
@@ -128,7 +128,7 @@ Range: rml:TermMap
 
 #### rml:inputValue
 
-[=constant shortcut property=] of rml:inputValueMap
+[=constant expression shortcut property=] of rml:inputValueMap
 
 <div class="practice">
 

test-cases/RMLFNOTC0000-CSV/mapping.ttl

@@ -2,7 +2,6 @@
 @prefix ex: <http://example.com/> .
 @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
 @prefix rml: <http://w3id.org/rml/> .
-@prefix rml: <http://w3id.org/rml/ .
 @prefix fno: <https://w3id.org/function/ontology#> .
 @prefix morph-kgc: <https://github.com/morph-kgc/morph-kgc/function/built-in.ttl#> .
 @prefix grel: <http://users.ugent.be/~bjdmeest/function/grel.ttl#> .

test-cases/RMLFNOTC0001-CSV/mapping.ttl

@@ -2,7 +2,6 @@
 @prefix ex: <http://example.com/> .
 @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
 @prefix rml: <http://w3id.org/rml/> .
-@prefix rml: <http://w3id.org/rml/ .
 @prefix fno: <https://w3id.org/function/ontology#> .
 @prefix morph-kgc: <https://github.com/morph-kgc/morph-kgc/function/built-in.ttl#> .
 @prefix grel: <http://users.ugent.be/~bjdmeest/function/grel.ttl#> .

test-cases/RMLFNOTC0002-CSV/mapping.ttl

@@ -2,7 +2,6 @@
 @prefix ex: <http://example.com/> .
 @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
 @prefix rml: <http://w3id.org/rml/> .
-@prefix rml: <http://w3id.org/rml/ .
 @prefix fno: <https://w3id.org/function/ontology#> .
 @prefix morph-kgc: <https://github.com/morph-kgc/morph-kgc/function/built-in.ttl#> .
 @prefix grel: <http://users.ugent.be/~bjdmeest/function/grel.ttl#> .

test-cases/RMLFNOTC0003-CSV/mapping.ttl

@@ -2,7 +2,6 @@
 @prefix ex: <http://example.com/> .
 @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
 @prefix rml: <http://w3id.org/rml/> .
-@prefix rml: <http://w3id.org/rml/ .
 @prefix fno: <https://w3id.org/function/ontology#> .
 @prefix morph-kgc: <https://github.com/morph-kgc/morph-kgc/function/built-in.ttl#> .
 @prefix grel: <http://users.ugent.be/~bjdmeest/function/grel.ttl#> .

test-cases/RMLFNOTC0004-CSV/mapping.ttl

@@ -2,7 +2,6 @@
 @prefix ex: <http://example.com/> .
 @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
 @prefix rml: <http://w3id.org/rml/> .
-@prefix rml: <http://w3id.org/rml/ .
 @prefix fno: <https://w3id.org/function/ontology#> .
 @prefix morph-kgc: <https://github.com/morph-kgc/morph-kgc/function/built-in.ttl#> .
 @prefix grel: <http://users.ugent.be/~bjdmeest/function/grel.ttl#> .

test-cases/RMLFNOTC0005-CSV/mapping.ttl

@@ -2,7 +2,6 @@
 @prefix ex: <http://example.com/> .
 @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
 @prefix rml: <http://w3id.org/rml/> .
-@prefix rml: <http://w3id.org/rml/ .
 @prefix fno: <https://w3id.org/function/ontology#> .
 @prefix morph-kgc: <https://github.com/morph-kgc/morph-kgc/function/built-in.ttl#> .
 @prefix grel: <http://users.ugent.be/~bjdmeest/function/grel.ttl#> .