Skip to content

Commit 952de66

Browse files
committed
Remove support for contextual and ordered property values (again) per issue #10.
1 parent c13e242 commit 952de66

File tree

1 file changed

+68
-58
lines changed

1 file changed

+68
-58
lines changed

index.html

Lines changed: 68 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -165,7 +165,7 @@
165165
<p>This Working Draft is an update of the <a href="/TR/2012/NOTE-microdata-rdf-20121009/">W3C
166166
Interest Group Notea>, published in October 2012.
167167
<span>
168-
This update adds ...
168+
XXX
169169
span>
170170
The intention is to publish
171171
this draft as a new version of the Interest Group Note after gathering and incorporating community input.
@@ -181,12 +181,12 @@

Introduction

181181
<p>There are a variety of ways in which a mapping from microdata to
182182
RDF might be configured to give a result that is closer to the required result for a particular vocabulary.
183183
This specification defines terms that can be used as hooks for
184-
optional vocabulary-specific behavior, which could be defined within a
185-
<a>registrya> or on an implementation-defined basis. However, the
184+
vocabulary-specific behavior, which could be defined within a
185+
<a>registrya> or on an implementation-defined basis. <span class="strike"> However, the
186186
HTML Data TF recommends the adoption of a single method of mapping in
187-
which every vocabulary is treated as if:
187+
which every vocabulary is treated as if:span>
188188
p>
189-
<ul>
189+
<ul class="strike">
190190
<li><a><code>propertyURIcode>a> is set to <code>vocabularycode>li>
191191
<li><a><code>multipleValuescode>a> is set to <code>unorderedcode>li>
192192
ul>
@@ -234,7 +234,7 @@

Background

234234
the microdata specification. This specification highlights where such
235235
violations occur and the reasons for them.p>
236236

237-
<p>This specification optionally allows for
237+
<p>This specification allows for
238238
<a>vocabularya>-specific rules that affect the generation of property URIs and value serializations.
239239
This is facilitated by a <a>registrya> that associates URIs with specific rules based on matching
240240
<a class="aref">itemtypea> values against registered URI prefixes do determine a vocabulary and potentially
@@ -322,11 +322,15 @@

Issues

322322
particular candidate.
323323
p>
324324
<p class="issue" data-number="10">
325-
Make use of the <a href="#vocab_expansion">Vocabulary Expansiona>, and
326-
<a href="#vocabulary-entailment">Vocabulary Entailmenta>
327-
conditional on a runtime option.
328-
<a><code>propertyURIcode>a> defaults to <a>vocabularya> if there is an <a class="aref">itemtypea> and
329-
<code>multipleValuescode> defaults to <strong>falsestrong>, where values are never placed in an <code>rdf:List.code>
325+
Remove support for <code>contextualcode>
326+
<a><code>propertyURIcode>a> and <code>mulitpleValuescode>. This issue proposes to
327+
remove support for independently setting
328+
<a><code>propertyURIcode>a> and <a><code>multipleValuescode>a>.
329+
The former <a><code>propertyURIcode>a>
330+
is treated like the former <a>vocabularya> scheme if
331+
there is an <a class="aref">itemtypea>, otherwise, like <code>contextualcode> creating a property
332+
as a fragment of the document base.
333+
The former <code>multipleValuescode> is treated like false, where values are never placed in an <code>rdf:List.code>
330334
p>
331335
<p class="issue" data-number="11">
332336
Use full RDFa Entailment if <code>vocab_expansioncode> option given.
@@ -461,7 +465,7 @@

Attributes and Syntax

461465

462466
<section class="informative">
463467
<h1>Vocabulary Registryh1>
464-
<p class="note">The registry is controlled by a processor option (see <a href="#issues">issue 10a>).p>
468+
<p class="note">(The registry is being considered for revision (see <a href="#issues">issue 10a>).p>
465469
<p>In a perfect world, all processors would be able to generate the same output for a given input
466470
without regards to the requirements of a particular <a>vocabularya>. However, microdata doesn't
467471
provide sufficient syntactic help in making these decisions. Different vocabularies have different
@@ -475,8 +479,6 @@

Vocabulary Registry

475479
623626
pre>
624627
<p>In this example, assuming no matching entry in the <a>registrya>,
625628
the <a>URI prefixa> is constructed by removing the
626629
<cite><a href="http://tools.ietf.org/html/rfc3986#section-3.3">last path segmenta>cite>, leaving the URI
627-
<code>http://schema.org/code>. As there is no explicit <a><code>propertyURIcode>a>,
628-
the default <code>vocabularycode> is used, and the resulting property URI would be
629-
<code>http://schema.org/titlecode>.p>
630+
<code>http://example.org/code>. <span class="strike">As there is no explicit <a><code>propertyURIcode>a>,
631+
the default <code>vocabularycode> is used, andspan> The resulting property URI would be
632+
<code>http://example.org/titlecode>.p>
630633

631634
<div>
632635
<p>If there is no in-scope <a class="aref">itemtypea>, property URIs are generated
@@ -667,8 +670,9 @@

Just a Geek

667670

668671
section>
669672

670-
<section class="informative">
673+
<section class="informative strike">
671674
<h2>Value Orderingh2>
675+
<p class="note">(Value Ordering is being considered for removal (see <a href="#issues">issue 10a>).
672676
<p>For items having multiple values for a given <a>propertya>,
673677
the <dfn><code>multipleValuescode>dfn> rule defines the algorithm for serializing these values.
674678
Microdata uses document order when generating <a title="property value">property valuesa>, as defined in
@@ -744,6 +748,9 @@

Value Typing

744748

745749
<section>
746750
<h2 id="vocab_expansion">Vocabulary Expansionh2>
751+
<p class="note">Support for the registry is
752+
being amended
753+
(see <a href="#issues">issue 10a>).p>
747754
<p>Microdata requires that all values of <a class="aref">itemtypea> come from the same vocabulary. This
748755
is required as <a class="aref">itempropa> values are resolved relative to that vocabulary. However,
749756
it is often useful to define an <a>itema> to have types from multiple different vocabularies.p>
@@ -782,15 +789,11 @@

Vocabulary Expansion

782789
@prefix rdfs: .
783790
@prefix schema: .
784791
785-
<> rdfa:usesVocabulary schema: .
786-
787792
[ a schema:Person;
788793
schema:additionalType foaf:Person;
789794
schema:email ;
790795
foaf:mbox
791796
] .
792-
793-
schema:additionalType rdfs:subPropertyOf rdf:type .
794797
-->
795798
pre>
796799

@@ -810,8 +813,6 @@

Vocabulary Expansion

810813
schema:email ;
811814
foaf:mbox
812815
] .
813-
814-
schema:additionalType rdfs:subPropertyOf rdf:type .
815816
-->
816817
pre>
817818
section>
@@ -949,7 +950,7 @@

Algorithm Terms

949950
<dt><dfn>memorydfn>dt><dd>
950951
a mapping of items to subjects, initially empty;
951952
dd>
952-
<dt><dfn>current namedfn>dt><dd>
953+
<dt class="strike"><dfn>current namedfn>dt><dd class="strike">
953954
an <a>absolute URLa> for the in-scope <a>namea>, used for generating URIs
954955
for properties of items without an <a>item typea>;
955956
<div class="note">
@@ -1247,7 +1248,7 @@

RDF Conversion Algorithm

12471248
algorithm generates:p>
12481249

12491250
<ol class="algorithm">
1250-
<li>For each element that is also a <a>top-level itema> run the following algorithm:
1251+
<li>For each element that is also a <a>top-level itema> <span class="strike">run the following algorithmspan>:
12511252
<ol class="algorithm">
12521253
<li>
12531254
<a href="#generate-the-triples">Generate the triplesa> for an item <em>itemem>, using the
@@ -1317,7 +1318,7 @@

Generate the triples

13171318
<code><cite><a href="http://www.w3.org/TR/2013/NOTE-microdata-20131029/#dom-itemtype">element.itemTypea>cite>code>
13181319
of the element defining the <a>itema>.
13191320
li>
1320-
<li>If <em>typeem> is an <a>absolute URLa>, set <a>current namea> in
1321+
<li class="strike">If <em>typeem> is an <a>absolute URLa>, set <a>current namea> in
13211322
<a>evaluation contexta> to null.li>
13221323
<li>
13231324
Otherwise, set <em>typeem> to <a>current typea> from
@@ -1341,14 +1342,14 @@

Generate the triples

13411342
<li>Otherwise, if type is not empty, construct <em>vocabem> by removing everything following the last
13421343
SOLIDUS U+002F ("/") or NUMBER SIGN U+0023 ("#") from the <em>pathem> component of <em>typeem>.li>
13431344
<li>Update <a>evaluation contexta> setting <a>current vocabularya> to <em>vocabem>.li>
1344-
<li>
1345+
<li class="strike">
13451346
Set <em>property listem> to an empty array mapping properties to one or more
13461347
<em>valuesem> as established below.
13471348
li>
13481349
<li>
13491350
For each element <em>elementem> that has one or more <a>property namesa> and is one of the
1350-
<a title="item properties">properties of the itema> <em>itemem>, in the order those elements
1351-
are given by the algorithm that returns the <a title="item properties">properties of the itema>,
1351+
<a title="item properties">properties of the itema> <em>itemem><span class="strike">, in the order those elements
1352+
are given by the algorithm that returns the <a title="item properties">properties of the itema>,span>
13521353
run the following substep:
13531354
<ol class="algorithm">
13541355
<li>
@@ -1361,7 +1362,7 @@

Generate the triples

13611362
<li>
13621363
Let <em>predicateem> be the result of <a href="#generate-predicate-uri">generate predicate URIa>
13631364
using <em>contextem> and <em>nameem>.
1364-
Update <em>contextem> by setting <a>current namea> to <em>predicateem>.
1365+
<span class="strike">Update <em>contextem> by setting <a>current namea> to <em>predicateem>span>.
13651366
li>
13661367
<li>
13671368
Let <em>valueem> be the <a>property valuea> of <em>elementem>.
@@ -1371,8 +1372,15 @@

Generate the triples

13711372
triplesa> for <em>valueem> using <em>contextem>. Replace <em>valueem> by the subject returned
13721373
from those steps.
13731374
li>
1374-
<li>
1375-
Add <em>valueem> to <em>property listem> for <em>predicateem>.
1375+
<li>Generate the following triple:
1376+
<dl class="triple">
1377+
<dt>subjectdt>
1378+
<dd><em>subjectem>dd>
1379+
<dt>predicatedt>
1380+
<dd><em>predicateem>dd>
1381+
<dt>objectdt>
1382+
<dd><em>valueem>dd>
1383+
dl>
13761384
li>
13771385
ol>
13781386
li>
@@ -1421,7 +1429,7 @@

Generate the triples

14211429
li>
14221430
ol>
14231431
li>
1424-
<li>
1432+
<li class="strike">
14251433
For each <em>predicateem> in <em>property listem>:
14261434
<ol class="algorithm">
14271435
<li><a href="#generate-property-values">Generate property valuesa> <em>subjectem>, <em>predicateem> and
@@ -1436,8 +1444,11 @@

Generate the triples

14361444
<section>
14371445
<h3>Generate Predicate URIh3>
14381446
<p>Predicate URI generation makes use of <a>current typea>,
1439-
<a>current namea>, and <a>current vocabularya> from an <a>evaluation
1447+
<a class="strike">current namea>, and <a>current vocabularya> from an <a>evaluation
14401448
contexta> <em>contextem> along with <em>nameem>.p>
1449+
<p class="note">Support for the <code>contextualcode> <em>schemaem> is
1450+
being considered for removal
1451+
(see <a href="#issues">issue 10a>).p>
14411452

14421453
<ol class="algorithm">
14431454
<li>If <em>nameem> is an <a>absolute URLa>, return <em>nameem>
@@ -1456,18 +1467,18 @@

Generate Predicate URI

14561467
<code>http://example.org/doc#titlecode>.
14571468
div>
14581469
li>
1459-
<li>Otherwise, if <a>current vocabularya> from <em>contextem>
1470+
<li class="strike">Otherwise, if <a>current vocabularya> from <em>contextem>
14601471
is not null and <a>registrya> has an entry for <a>current vocabularya>
14611472
having a <a>propertyURIa> entry that is not null, set that as
14621473
<em>schemeem>. Otherwise, set <em>schemeem> to
14631474
<code>vocabularycode>.li>
1464-
<li id="scheme-vocab">If <em>schemeem> is <code>vocabularycode>
1475+
<li id="scheme-vocab"><span class="strike">If <em>schemeem> is <code>vocabularycode>span>
14651476
set <em>expandedURIem> to the <a>URI referencea> constructed by
14661477
appending the <a>fragment-escapea>d value of <em>nameem> to <a>current
14671478
vocabularya>, separated by a U+0023 NUMBER SIGN character (#) unless the
14681479
<a>current vocabularya> ends with either a U+0023 NUMBER SIGN character
14691480
(#) or SOLIDUS U+002F (/).li>
1470-
<li id="scheme-context">Otherwise, if <em>schemeem> is
1481+
<li class="strike" id="scheme-context">Otherwise, if <em>schemeem> is
14711482
<code>contextualcode>, set <em>expandedURIem> to the <a>URI
14721483
referencea> constructed as follows:
14731484
<ol class="algorithm">
@@ -1483,7 +1494,7 @@

Generate Predicate URI

14831494
<em>nameem>. li>
14841495
ol>
14851496
li>
1486-
<li>If the <a>registrya> entry for <a>propertyURIa>
1497+
<li class="strike">If the <a>registrya> entry for <a>propertyURIa>
14871498
has an <code>equivalentPropertycode> key,
14881499
generate the following triple using the
14891500
<em>valueem> of that key:
@@ -1497,7 +1508,7 @@

Generate Predicate URI

14971508
dl>
14981509
<p>If the value is an array, generate a triple for each value of that array.p>
14991510
li>
1500-
<li>If the <a>registrya> entry for <a>propertyURIa>
1511+
<li class="strike">If the <a>registrya> entry for <a>propertyURIa>
15011512
has an <code>subPropertyOfcode> key, generate the following triple using the
15021513
<em>valueem> of that key:
15031514
<dl class="triple">
@@ -1514,9 +1525,11 @@

Generate Predicate URI

15141525
ol>
15151526
section>
15161527

1517-
<section>
1528+
<section class="strike">
15181529
<h2>Generate Property Valuesh2>
15191530
<p>Property value serialization makes use of <em>subjectem>, <em>predicateem> and <em>valuesem>.p>
1531+
<p class="note">Support for the per-vocabulary processing rules is being considered for removal
1532+
(see <a href="#issues">issue 10a>).p>
15201533

15211534
<ol class="algorithm">
15221535
<li>If the <a>registrya> contains a URI prefix that is a character for character match of
@@ -1569,16 +1582,19 @@

Generate Property Values

15691582
ol>
15701583
section>
15711584

1572-
<section id="generate-collection">
1585+
<section class="strike" id="generate-collection">
15731586
<h2>Generate RDF Collectionh2>
1587+
<p class="note">Support for the registry, and therefore the generation of RDF Collections
1588+
is being considered for removal
1589+
(see <a href="#issues">issue 10a>).p>
15741590
<p>
15751591
An <dfn>RDF Collectiondfn> is a mechanism for defining ordered sequences of objects in RDF (See <cite><a
15761592
href="http://www.w3.org/TR/rdf-syntax/#collections">RDF Collectionsa>cite> in
15771593
[[!RDF-SCHEMA]]). As the RDF data-model is that of an unordered graph, a linking method using properties
15781594
<code>rdf:firstcode> and <code>rdf:next code>is required to be able to specify a particular order.
15791595
p>
15801596
<p>
1581-
In the microdata to RDF mapping, <a>RDF Collectiona>s are used when an item has more than one value
1597+
In the microdata to RDF mapping, <a title="RDF Collection">RDF Collectionsa> are used when an item has more than one value
15821598
associated with a given property to ensure that the original document order is maintained. The following
15831599
procedure should be used to generate triples when an <a>itema> property has more than one value
15841600
(contained in <em>listem>):
@@ -1661,7 +1677,7 @@

Markup Examples

16611677
pre>
16621678

16631679
<p>Assuming that <a>registrya> contains a an entry for <code>http://purl.org/vocab/frbr/core#code>
1664-
with <a><code>propertyURIcode>a> set to <code>vocabularycode>,
1680+
<span class="strike">with <a><code>propertyURIcode>a> set to <code>vocabularycode>,span>
16651681
this is equivalent to the following Turtle:p>
16661682
<pre class="example" data-transform="updateExample">
16671683
18051815
pre>
18061816

0 commit comments

Comments
 (0)