Skip to content

Commit dea41dd

Browse files
frmichelfrmichel
committed
Add variable language tag in documentation
1 parent f9d144f commit dea41dd

File tree

1 file changed

+77
-14
lines changed

1 file changed

+77
-14
lines changed

‎doc/xr2rml_specification_v5.html renamed to ‎doc/xr2rml_specification_v5.1.html

Lines changed: 77 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -63,11 +63,14 @@ <h1>xR2RML: Relational and Non-Relational Databases to RDF Mapping Language</h1>
6363

6464
<dl>
6565
<dt>This version:</dt>
66-
<dd><a href="http://i3s.unice.fr/~fmichel/xr2rml_specification_v5.html">http://i3s.unice.fr/~fmichel/xr2rml_specification_v5.html</a></dd>
66+
<dd><a href="http://i3s.unice.fr/~fmichel/xr2rml_specification_v5.1.html">http://i3s.unice.fr/~fmichel/xr2rml_specification_v5.1.html</a></dd>
6767
<dt>Latest version:</dt>
6868
<dd><a href="http://i3s.unice.fr/~fmichel/xr2rml_specification.html">http://i3s.unice.fr/~fmichel/xr2rml_specification.html</a></dd>
69+
<dt>Previous version:</dt>
70+
<dd><a href="http://i3s.unice.fr/~fmichel/xr2rml_specification_v5.html">http://i3s.unice.fr/~fmichel/xr2rml_specification_v5.html</a></dd>
6971
</dl>
70-
72+
73+
7174
<p class="copyright"><a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/4.0/80x15.png" /></a><br />This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.</p>
7275
</div>
7376
<hr/>
@@ -111,6 +114,11 @@ <h2>Document history</h2>
111114
<td>2017-10-25</td>
112115
<td>Add property xrr:pushDown in logical source and nested term map</td>
113116
</tr>
117+
<tr>
118+
<td>5.1</td>
119+
<td>2019-06-19</td>
120+
<td>Add property xrr:languageReference to handle varialbe language tag</td>
121+
</tr>
114122
</tbody>
115123
</table>
116124

@@ -145,6 +153,7 @@ <h2>Table of Contents</h2>
145153
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;3.2.1 <a href="#_Toc466307463">xR2RML Term Maps</a><br/>
146154
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;3.2.1.1 <a href="#_Toc466307464">Constant-, Column-, Reference- and Template-valued Term Maps</a><br/>
147155
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;3.2.1.2 <a href="#_Toc466307465">Term Types of Term Maps</a><br/>
156+
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;3.2.1.3 <a href="#_TocLanguageTags">Language Tags</a><br/>
148157
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;3.2.1.3 <a href="#_Toc466307466">Nested Term Maps</a><br/>
149158

150159
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;3.2.2 <a href="#_Toc466307467">Referencing data elements</a><br/>
@@ -521,12 +530,6 @@ <h2 id="_Toc466307455">2.5 Generating an RDF collection from a list of values</h
521530
<tr>
522531
<td>RDF triples produced</td>
523532
<td><pre>
524-
&lt;http://example.org/director/Woody%20Allen&gt; ex:directed [
525-
a rdf:List;
526-
rdf:_1 "Manhattan"@en;
527-
rdf:_2 "Annie Hall"@en;
528-
].
529-
530533
&lt;http://example.org/director/&lt;Wong%20Kar-wai&gt; ex:directed
531534
( "2046"@en "In the Mood for Love"@en ).</pre></td>
532535
</tr>
@@ -925,7 +928,7 @@ <h3 id="_Toc466307461">3.1.3 xR2RML Triples Map Iteration Model</h3>
925928
xrr:logicalSource [
926929
xrr:query "db.movies.find( { directors: { $exists: true} } )";
927930
<span class="red">rml:iterator "$.directors.*";
928-
xrr:pushdown [ xrr:reference "$.type" xrr:as "newType" ];</span>
931+
xrr:pushDown [ xrr:reference "$.type"; xrr:as "newType" ];</span>
929932
];
930933
rr:subjectMap [
931934
rr:template "http://example.org/director/<span class="red">{$.newType}</span>-{$.name}";
@@ -1018,8 +1021,67 @@ <h4 id="_Toc466307465">3.2.1.2 Term Types of Term Maps</h4>
10181021
</div>
10191022

10201023

1024+
1025+
<h4 id="_TocLanguageTags">3.2.1.3 Language Tags</h4>
1026+
1027+
<p>Like in R2RML, xR2RML allows assigning language tags to literals. Language tags can be defined statically, but unlike R2RML they can also be defined dynamically using a path expression.</p>
1028+
1029+
<div class="definition">
1030+
<p>A term map or nested term map with an rr:Literal term type may have a specified language tag.
1031+
It is represented statically by the <b>rr:language</b> property, or dynamically be the <b>xrr:languageReference</b> property.
1032+
Both properties cause generated literals to be language-tagged plain literals.</p>
1033+
1034+
<p>rr:language and xrr:languageReference are not mutually exclusive.
1035+
If only rr:language is present, the language tag is that given by the property.
1036+
If xrr:languageReference is present, the language tag is the result of evaluating the path expression against the document of the current iteration. If the evaluation fails (no language tag is produced), then the language tag is that given by rr:language, if present.</p>
1037+
1038+
<p>If the evaluation of the path expression provided by xrr:languageReference fails, and there is no rr:language property, then the RDF term produced is a literal without language tag.</p>
1039+
</div>
1040+
1041+
<p>Example:</p>
1042+
1043+
<table>
1044+
<tbody>
1045+
<tr>
1046+
<td>Input data</td>
1047+
<td><pre>
1048+
{ "item": [
1049+
{ "name":"football", "lang":"fr" },
1050+
{ "name":"calcio", "lang":"it" },
1051+
{ "name":"soccer" }
1052+
]}
1053+
</pre></td>
1054+
</tr>
1055+
<tr>
1056+
<td>Term map</td>
1057+
<td>The first xrr:reference selects all elements of the "item" array. Then, the nested term map selects each "name" field and assigns it the language tag provided in the "lang" field.
1058+
<pre>
1059+
[] rr:objectMap [
1060+
xrr:reference "$.item.*";
1061+
xrr:nestedTermMap [
1062+
xrr:reference "$.name";
1063+
rr:language "en";
1064+
xrr:languageReference "$.lang"
1065+
]
1066+
];</pre></td>
1067+
</tr>
1068+
<tr>
1069+
<td>Generated RDF terms</td>
1070+
<td>
1071+
<pre>
1072+
"football"@en
1073+
"calcio"@it
1074+
"soccer"@en
1075+
</pre>
1076+
</td>
1077+
</tr>
1078+
1079+
</tbody>
1080+
</table>
1081+
1082+
10211083

1022-
<h4 id="_Toc466307466">3.2.1.3 Nested Term Maps</h4>
1084+
<h4 id="_Toc466307466">3.2.1.4 Nested Term Maps</h4>
10231085

10241086
<p>Hierarchical data such as JSON or XML documents commonly have more than one level of nesting, resulting in tree-like values that may need to be parsed in depth, e.g. to nest RDF collections and containers (build an RDF collection of RDF collections).</p>
10251087

@@ -1044,6 +1106,7 @@ <h4 id="_Toc466307466">3.2.1.3 Nested Term Maps</h4>
10441106
<li><b>xrr:pushDown</b> properties if and only if there exists an xrr:nestedTermMap property (see section <a href="#_Toc496719460">3.2.2.4</a>).</li>
10451107
<li><b>rr:termType</b> bears the same semantics as in the context of a term map;</li>
10461108
<li><b>rr:language</b> bears the same semantics as defined in R2RML;</li>
1109+
<li><b>xrr:languageReference</b> bears the semantics as defined in <a href="#_TocLanguageTags">§3.2.1.3</a>;</li>
10471110
<li><b>rr:datatype</b> bears the same semantics as defined in R2RML.</li>
10481111
</ul>
10491112
<p>A <b>simple nested term map</b> is a nested term map that has no xrr:reference nor rr:template property. A simple nested term map is used to qualify terms of an RDF collection or container generated by its parent term map or nested term map, i.e. assign them an optional term type, data type or language tag.</p>
@@ -1083,10 +1146,10 @@ <h4 id="_Toc466307466">3.2.1.3 Nested Term Maps</h4>
10831146
</ul>
10841147
</div>
10851148

1086-
<p>Finally, as defined in R2RML, properties rr:language and rr:datatype apply when generating literals only:</p>
1149+
<p>Finally, properties rr:language, xrr:languageReference and rr:datatype apply when generating literals only:</p>
10871150

10881151
<div class="definition">
1089-
<p>A term map or nested term map may have an rr:language or rr:datatype property only if its term type is rr:Literal (either stated by property rr:termType or inferred as a default value).</p>
1152+
<p>A term map or nested term map may have an rr:language, xrr:languageReference or rr:datatype property only if its term type is rr:Literal (either stated by property rr:termType or inferred as a default value).</p>
10901153
</div>
10911154

10921155

@@ -1849,9 +1912,9 @@ <h3 id="_Toc466307474">3.2.5 Default Term Types</h3>
18491912
<li>rr:Literal, if it is an object map and at least one of the following conditions is true:
18501913
<ul>
18511914
<li>It is a column-based term map.</li>
1852-
<li>It has an rr:language property (and thus a specified language tag).</li>
1915+
<li>It has an rr:language <span class="highlight">or xrr:languageReference</span> property (and thus a specified language tag).</li>
18531916
<li>It has an rr:datatype property (and thus a specified datatype).</li>
1854-
<li><span class="highlight">It does not have an rr:language property and it has a nested term map that has an rr:language property.</span></li>
1917+
<li><span class="highlight">It does not have an rr:language nor xrr:languageReference property and it has a nested term map that has an rr:language property.</span></li>
18551918
<li><span class="highlight">It does not have an rr:datatype property and it has a nested term map that has an rr:datatype property.</span></li>
18561919
</ul>
18571920
</li>

0 commit comments

Comments
 (0)