microdata-rdf/index.html
author Gregg Kellogg <gregg@kellogg-assoc.com>
Wed, 19 Sep 2012 22:43:10 -0700
changeset 146 461b60f5934e
parent 143 477dbacdfed0
child 150 60f668575322
permissions -rw-r--r--
Create WD-NOTE version of ED for timestamp.
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
     1
<!DOCTYPE html>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
     2
<html>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
     3
<head>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
     4
<title>Microdata to RDF</title>
100
f885a8d5ff7c Cleanup doc well-formedness.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 99
diff changeset
     5
<meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
     6
<!--
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
     7
  === NOTA BENE ===
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
     8
  For the three scripts below, if your spec resides on dev.w3 you can check them
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
     9
  out in the same tree and use relative links so that they'll work offline,
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    10
  -->
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    11
<script type="text/javascript"
122
cf9789b86496 Tests described in microdata with turtle and json-ld variations
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 120
diff changeset
    12
  src="http://darobin.github.com/respec/builds/respec-w3c-common.js" class="remove">
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    13
 </script>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    14
<script type="text/javascript" class="remove">
100
f885a8d5ff7c Cleanup doc well-formedness.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 99
diff changeset
    15
// <!--
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    16
    var preProc = {
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
    17
        apply:  function(c) {
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
    18
            // extend the bibliography entries
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
    19
            berjon.biblio["MICRODATA"] = "<cite><a href=\"http://www.w3.org/TR/2012/WD-microdata-20120329/\">HTML Microdata</a></cite> Ian Hickson Editor. W3C Working Draft. (Work in progress). 29 March 2012. This edition of the HTML Microdata specification is http://www.w3.org/TR/2012/WD-microdata-20120329/. The <a href=\"http://www.w3.org/TR/microdata/\">latest edition of HTML Microdata</a> is available at http://www.w3.org/TR/microdata/";
141
8d1da7f9c601 use http instead of https scheme to avoid document load issues in Chrome.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 140
diff changeset
    20
            berjon.biblio["MICRODATA-RDF-SUPPLEMENT"] = "<cite><a href=\"http://dvcs.w3.org/hg/htmldata/raw-file/default/microdata-supplement/index.html\">Microdata to RDF Supplement</a></cite> Gregg Kellogg Editor. World Wide Web Consortium (work in progress). 22 January 2012.";
8d1da7f9c601 use http instead of https scheme to avoid document load issues in Chrome.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 140
diff changeset
    21
            berjon.biblio["MICRODATA-RDF-TESTS"] = "<cite><a href=\"http://dvcs.w3.org/hg/htmldata/raw-file/default/microdata-rdf/tests/index.html\">Microdata to RDF Tests</a></cite> Gregg Kellogg, Ivan Herman Editors. World Wide Web Consortium (work in progress). 22 March 2012.";
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
    22
        }
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
    23
    } ;
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    24
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    25
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    26
      var respecConfig = {
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    27
          // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
146
461b60f5934e Create WD-NOTE version of ED for timestamp.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 143
diff changeset
    28
          specStatus:           "WD-NOTE",
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
    29
          charterDisclosureURI: "http://www.w3.org/2006/07/swig-charter#Ipr",
146
461b60f5934e Create WD-NOTE version of ED for timestamp.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 143
diff changeset
    30
          publishDate:          "2012-09-19",
108
fc38c72c35fc Editorial chagnes for the headers.
Ivan Herman <ivan@w3.org>
parents: 105
diff changeset
    31
          copyrightStart:       "2011",
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    32
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    33
          // the specification's short name, as in http://www.w3.org/TR/short-name/
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    34
          shortName:            "microdata-rdf",
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    35
          subtitle:             "Transformation from HTML+Microdata to RDF",
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    36
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    37
          // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    38
          // and its maturity status
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
    39
          previousPublishDate:  "2012-03-08",
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
    40
          previousMaturity:     "IG-NOTE",
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
    41
          previousURI:          "http://www.w3.org/TR/2012/NOTE-microdata-rdf-20120308/",
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
    42
          diffTool:             "http://www.aptest.com/standards/htmldiff/htmldiff.pl",
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    43
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    44
          // if there a publicly available Editor's Draft, this is the link
141
8d1da7f9c601 use http instead of https scheme to avoid document load issues in Chrome.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 140
diff changeset
    45
          edDraftURI:           "http://dvcs.w3.org/hg/htmldata/raw-file/default/microdata-rdf/index.html",
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    46
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    47
          // if this is a LCWD, uncomment and set the end of its review period
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    48
          // lcEnd: "2009-08-05",
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    49
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    50
          // if you want to have extra CSS, append them to this list
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    51
          // it is recommended that the respec.css stylesheet be kept
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
    52
          //extraCSS:             [
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
    53
          //    "http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css"
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
    54
          //],
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
    55
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
    56
          issueBase: "http://www.w3.org/2011/htmldata/track/issues/",
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    57
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    58
          // editors, add as many as you like
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    59
          // only "name" is required
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    60
          editors:  [
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    61
              { name: "Gregg Kellogg", url: "http://greggkellogg.net/",
96
5b7fcd8c418f Update hcard example registry entry to be consistent with the definitions.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 91
diff changeset
    62
                company: "Kellogg Associates" }
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    63
          ],
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    64
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    65
          // authors, add as many as you like.
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    66
          // This is optional, uncomment if you have authors as well as editors.
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    67
          // only "name" is required. Same format as editors.
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    68
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    69
          authors:  [
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    70
              { name: "Ian Hickson", url: "mailto:ian@hixie.ch",
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    71
                company: "Google, Inc." },
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    72
              { name: "Gregg Kellogg", url: "http://greggkellogg.net/",
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    73
                company: "Kellogg Associates" },
27
593b491ce081 Add Jeni as author. Use languge for un-matched <time> and remove special treatment for <data>.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 26
diff changeset
    74
              { name: "Jeni Tennison", url: "http://www.jenitennison.com/",
103
070cc10dd35d Add Ivan as an author of microdata-rdf
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 102
diff changeset
    75
                company: "Independent"},
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
    76
              { name: "Ivan Herman", url: "http://www.w3.org/People/Ivan/",
103
070cc10dd35d Add Ivan as an author of microdata-rdf
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 102
diff changeset
    77
                company: "W3C", companyURL: "http://www.w3.org" }
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    78
          ],
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    79
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    80
          // name of the WG
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
    81
          wg:           "Semantic Web Interest Group",
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    82
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    83
          // URI of the public WG page
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
    84
          wgURI:        "http://www.w3.org/2001/sw/interest/",
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    85
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    86
          // name (with the @w3c.org) of the public mailing to which comments are due
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
    87
          wgPublicList: "semantic-web",
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    88
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    89
          // URI of the patent status for this WG, for Rec-track documents
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    90
          // !!!! IMPORTANT !!!!
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    91
          // This is important for Rec-track documents, do not copy a patent URI from a random
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    92
          // document unless you know what you're doing. If in doubt ask your friendly neighbourhood
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    93
          // Team Contact.
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    94
          wgPatentURI:  "",
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    95
          maxTocLevel: 4,
96
5b7fcd8c418f Update hcard example registry entry to be consistent with the definitions.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 91
diff changeset
    96
          preProcess: [ preProc ]
146
461b60f5934e Create WD-NOTE version of ED for timestamp.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 143
diff changeset
    97
          , alternateFormats: [ {uri: "diff-20120308.html", label: "diff to previous version"} ]
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    98
      };
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
    99
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   100
      function _esc(s) {
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   101
          s = s.replace(/&/g,'&amp;');
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   102
          s = s.replace(/>/g,'&gt;');
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   103
          s = s.replace(/"/g,'&quot;');
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   104
          s = s.replace(/</g,'&lt;');
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   105
          return s;
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   106
      }
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   107
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   108
      function updateExample(doc, content) {
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   109
        // perform transformations to make it render and prettier
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   110
        content = content.replace(/<!--/, '');
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   111
        content = content.replace(/-->/, '');
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   112
        content = _esc(content);
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   113
        content = content.replace(/\*\*\*\*([^*]*)\*\*\*\*/g, '<span class="diff">$1</span>') ;
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   114
        return content ;
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   115
      }
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   116
      // -->
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   117
  </script>
81
411a31f27644 Pubrules checker update
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 80
diff changeset
   118
<style type="text/css">
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   119
.diff { font-weight:bold; color:#0a3; }
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   120
dl.triple { padding: 0 0 0 1em; }
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   121
dl.triple dt, dl.triple dd { margin: 0; display: inline }
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   122
dl.triple dt:after { content: ':'; }
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   123
dl.triple dd:after { content: '\A'; white-space: pre; }
8
a11c18d7c5f0 Clean up attribute definitions and references. Removed @cite processing for block and q
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 6
diff changeset
   124
.adef { 
a11c18d7c5f0 Clean up attribute definitions and references. Removed @cite processing for block and q
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 6
diff changeset
   125
	font-family: monospace; 
a11c18d7c5f0 Clean up attribute definitions and references. Removed @cite processing for block and q
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 6
diff changeset
   126
	font-weight: bold; 
26
18305e6c52e5 Straighten out some terms so as not to conflate element syntax with the item data model.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 25
diff changeset
   127
    color: #ff4500 !important;
8
a11c18d7c5f0 Clean up attribute definitions and references. Removed @cite processing for block and q
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 6
diff changeset
   128
}
a11c18d7c5f0 Clean up attribute definitions and references. Removed @cite processing for block and q
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 6
diff changeset
   129
a11c18d7c5f0 Clean up attribute definitions and references. Removed @cite processing for block and q
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 6
diff changeset
   130
.aref { 
a11c18d7c5f0 Clean up attribute definitions and references. Removed @cite processing for block and q
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 6
diff changeset
   131
	font-family: monospace; 
a11c18d7c5f0 Clean up attribute definitions and references. Removed @cite processing for block and q
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 6
diff changeset
   132
	font-weight: bold; 
26
18305e6c52e5 Straighten out some terms so as not to conflate element syntax with the item data model.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 25
diff changeset
   133
    color: #ff4500 !important;
8
a11c18d7c5f0 Clean up attribute definitions and references. Removed @cite processing for block and q
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 6
diff changeset
   134
}
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   135
.aref:before {content: "@"; }
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   136
</style>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   137
</head>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   138
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   139
<body>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   140
<section id="abstract">
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   141
  <p>HTML microdata [[!MICRODATA]] is an extension to HTML used to embed machine-readable data into HTML documents.
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   142
    Whereas the microdata specification describes a means of markup, the output format is JSON. This specification
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   143
    describes processing rules that may be used to extract RDF [[!RDF-CONCEPTS]] from an HTML document containing
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   144
    microdata.</p>
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   145
</section>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   146
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   147
<section id='sotd'>
86
f8a4c9cafee4 Doh, the wording for the sotd was lousy, changed it again...
Ivan Herman <ivan@w3.org>
parents: 85
diff changeset
   148
<p>This document is an experimental work in progress. The concepts described herein are intended to 
f8a4c9cafee4 Doh, the wording for the sotd was lousy, changed it again...
Ivan Herman <ivan@w3.org>
parents: 85
diff changeset
   149
  provide guidance for a possible future Working Group chartered to provide a Recommendation
85
77832dd7e2cb Changed the SOTD section a bit.
Ivan Herman <ivan@w3.org>
parents: 83
diff changeset
   150
  for this transformation. As a consequence, implementers of this specification, either producers
77832dd7e2cb Changed the SOTD section a bit.
Ivan Herman <ivan@w3.org>
parents: 83
diff changeset
   151
  or consumers, should note that it may change prior to any possible publication as a Recommendation.</p>
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   152
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   153
<p>This Working Draft is an update of the <a href="/TR/2012/NOTE-microdata-rdf-20120308/">W3C
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   154
Interest Group Note</a>, published in March 2012. This update adds the 
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   155
<a href="#vocab_expansion">Vocabulary Expansion</a> feature to the conversion algorithm, in response to the 
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   156
evolution of vocabularies discussed on the <a href="/2001/sw/interest/webschema.html">Web Schemas Task Force</a> 
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   157
of the <a href="/2001/sw/interest/">Semantic Web Interest Group</a> at W3C. The intention is to publish 
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   158
this draft as a new version of the Interest Group Note after gathering and incorporating community input.
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   159
</p> 
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   160
</section>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   161
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   162
<section class="informative">
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   163
  <h1>Introduction</h1>
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   164
  <p>This document describes a means of transforming HTML containing microdata into RDF. HTML Microdata [[!MICRODATA]]
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   165
    is an extension to HTML used to embed machine-readable data to HTML documents. This specification describes
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   166
    transformation directly to RDF [[RDF-CONCEPTS]].</p>
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   167
  <div class="note">
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   168
    <p>There are a variety of ways in which a mapping from microdata to
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   169
      RDF might be configured to give a result that is closer to the required result for a particular vocabulary. This
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   170
      specification defines terms that can be used as hooks for vocabulary-specific behavior, which could be defined
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   171
      within a <a>registry</a> or on an implementation-defined basis. However, the HTML Data TF recommends the
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   172
      adoption of a single method of mapping in which every vocabulary is treated as if:</p>
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   173
    <ul>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   174
      <li><a><code>propertyURI</code></a> is set to <code>vocabulary</code> </li>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   175
      <li><a><code>multipleValues</code></a> is set to <code>unordered</code></li>
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   176
    </ul>
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   177
    <p>For background on the trade-offs between these options, see 
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   178
      <a
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   179
        href="http://www.w3.org/wiki/Mapping_Microdata_to_RDF"
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   180
      >http://www.w3.org/wiki/Mapping_Microdata_to_RDF</a>.</p>
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   181
  </div>
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   182
<section class="informative">
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   183
  <h2>Background</h2>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   184
  <p>Microdata [[!MICRODATA]] is a way of embedding data in HTML documents
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   185
    using attributes. The HTML DOM is extended to provide an API for
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   186
    accessing microdata information, and the microdata specification
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   187
    defines how to generate a JSON representation from microdata markup.</p>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   188
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   189
  <p>Mapping microdata to RDF enables consumers to merge data expressed
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   190
    in other RDF-based formats with microdata. It facilitates the use of
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   191
    RDF vocabularies within microdata, and enables microdata to be used
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   192
    with the full RDF toolchain. Some use cases for this mapping are
80
04004b4d7a03 Pubrules checker update
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 78
diff changeset
   193
    described in <a href="#use-cases">Section 1.2</a> below.</p>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   194
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   195
  <p>Microdata's data model does not align neatly with RDF.</p>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   196
  <ul>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   197
   <li>Non-URL microdata properties are disambiguated based on microdata
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   198
     <a>item type</a>; an <a>item</a> with the type <code>http://example.org/Cat</code> can have
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   199
     both the property <code>color</code> and the property <code>http://example.org/color</code>,
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   200
     and these properties are semantically distinct under microdata. In
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   201
     RDF, all properties have IRIs.</li>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   202
26
18305e6c52e5 Straighten out some terms so as not to conflate element syntax with the item data model.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 25
diff changeset
   203
   <li>When an item has multiple properties with the same name, the values are
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   204
     always ordered; in RDF, property values are unordered unless they
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   205
     are explicitly listed in an <a>RDF Collection</a>.</li>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   206
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   207
   <li>A value in microdata is always a simple string which is interpreted
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   208
     by the consuming application. In RDF, values can be tagged with a
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   209
     datatype or a language. According to the microdata specification, the
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   210
     HTML context of microdata markup should not change how microdata is
32
9eccf2ad2f54 More feedback from Jeni.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 31
diff changeset
   211
     interpreted, so although element names and HTML <code>@lang</code> attributes could
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   212
     be used to provide datatype and language information for RDF data, this
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   213
     would be contrary to the microdata specification.</li>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   214
  </ul>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   215
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   216
   <p>Thus, in some places the needs of RDF consumers violate requirements of
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   217
     the microdata specification. This specification highlights where such
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   218
     violations occur and the reasons for them.</p>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   219
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   220
   <p>This specification allows for 
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   221
     <a>vocabulary</a>-specific rules that affect the generation of property URIs and value serializations.
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   222
     This is facilitated by a <a>registry</a> that associates URIs with specific rules based on matching
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   223
     <a class="aref">itemtype</a> values against registered URI prefixes do determine a vocabulary and potentially
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   224
     vocabulary-specific processing rules.</p>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   225
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   226
   <p>This specification also assumes that consumers of RDF generated from
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   227
     microdata may have to process the results in order to, for example,
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   228
     assign appropriate datatypes to <a>property value</a>s.</p>
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   229
</section>
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   230
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   231
<section class="informative">
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   232
  <h2>Use Cases</h2>
14
2f11ba803758 Added base property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 13
diff changeset
   233
  <p>During the period of the task force, a number of use cases were put forth for the use of microdata
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   234
    in generating RDF:</p>
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   235
  <ul>
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   236
    <li>Semantic search engines such as <a href="http://sindice.com/">Sindice</a> use RDF as their backend data model.
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   237
      They want to gather information expressed using microdata alongside information expressed in RDF-based formats
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   238
      and make it available to others to use, as a service. In these cases, the ultimate consumer, who will need to
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   239
      understand the vocabularies used within the microdata, is the program or person who pulls out data from Sindice.
14
2f11ba803758 Added base property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 13
diff changeset
   240
      Sindice needs to retain the distinctions in the original microdata (e.g. ordering of items) and might not have
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   241
      built-in knowledge about the <a>vocabulary</a> of interest to the ultimate consumer. In this case, the ultimate consumer
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   242
      is likely to have to map/validate/handle errors in the data they get from Sindice.</li>
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   243
    <li>A consumer such as <a href="http://openelectiondata.org">openelectiondata.org</a> wants to support
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   244
      microdata-based markup of their <a>vocabulary</a> as well as RDFa-based markup, both going into an RDF-based data store.
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   245
      They want to use an off-the-shelf tool to extract the microdata. They want to configure the tool to give them the
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   246
      RDF that is appropriate for their known <a>vocabulary</a>.</li>
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   247
    <li>A browser plugin that captures data for the user uses an RDF model as its backend store.
14
2f11ba803758 Added base property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 13
diff changeset
   248
      Any time it encounters microdata on a page, it wants to pull that microdata into the store on the fly.</li>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   249
    <li><a href="http://purl.org/goodrelations/">GoodRelations</a> properties do not take
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   250
      <a title="rdf collection">rdf:List</a> values; when they take
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   251
      multiple values they are unordered. The <code>rdfs:range</code> of a GoodRelations
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   252
      property indicates the datatype of the expected value, and GoodRelations
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   253
      processors will expect values to be cast to that type. Language
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   254
      information from the HTML needs to be captured as it is common that
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   255
      multiple values will be used to specify the same information in different
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   256
      languages.</li>
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   257
    <li><a href="http://schema.org/">Schema.org</a> has an 
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   258
      <a href="http://schema.org/docs/extension.html">extension mechanism</a> to allow authors to express information
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   259
      that is more detail than the pre-defined types, properties and enumerations. Property URIs are all in the same
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   260
      flat-namespace as types, but authors can add more detail by using a '/' after the type or property to provide
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   261
      more detail. For example, schema.org defines a <em>musicGroupMember</em> property having a URI of
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   262
      <code>http://schema.org/musicGroupMember</code>, and an author might express more detail through an ad-hoc
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   263
      sub-property <em>musicGroupMember/leadVocalist</em>, having the URI
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   264
      <code>http://schema.org/musicGroupMember/leadVocalist</code>.</li>
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   265
  </ul>
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   266
</section>
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   267
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   268
<section class="informative">
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   269
  <h2>Issues</h2>
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   270
  <p>Decisions or open issues in the specification are tracked on the
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   271
    <a href="http://www.w3.org/2011/htmldata/track/issues">Task Force Issue Tracker</a>. These include the
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   272
    following:</p>
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   273
  <p class="issue" data-number="1">Vocabulary specific parsing for Microdata.
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   274
    This specification attempts to create generic
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   275
    rules for processing microdata with typical RDF vocabularies.
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   276
    A <a>registry</a> allows
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   277
    for exceptions to the default processing rules for certain well-known vocabularies.</p>
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   278
  <p class="issue" data-number="2">Should Microdata-RDF generate XMLLiteral values.
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   279
    This issue has been closed with no change
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   280
    as this would violate microdata's data model.</p>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   281
  <p class="issue" data-number="3">Should the <a>registry</a> allow property datatype specification.
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   282
    The consensus is that datatypes are only derived from HTML semantics, so that only &lt;time&gt; values have a datatype other than plain.</p>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   283
  <p class="issue" data-number="4">Should the <a>registry</a> allow a <a>name</a> or URL
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   284
    to be used as an alias for <a class="aref">itemid</a>.</p>
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   285
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   286
  <p>The purpose of this specification is to provide input to a future working group that can make decisions
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   287
    about the need for a <a>registry</a> and the details of processing. Among the options investigated by
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   288
    the Task Force are the following:</p>
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   289
  <ul>
35
89285fc6b235 Change 'local name' to 'last path segment'. Reference both 'fragment' and 'last path segment' in RFC3986.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 34
diff changeset
   290
    <li>Property URI generation using the original microdata specification with a base URI and
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   291
      <cite><a href="http://tools.ietf.org/html/rfc3986#section-3.5">fragment</a></cite> made up of the in-scope <a>item
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   292
      type</a> and <a>properties</a>.</li>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   293
    <li>Vocabulary-based URI generation, where the <a>vocabulary</a> is determined from the
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   294
      in-scope <a>item type</a>, either through an algorithmic modification of the type URL or by matching the
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   295
      URL against a <a>registry</a>. The vocabulary URI is then used to generate property URIs in a namespace
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   296
      parallel to the type URI.</li>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   297
    <li>When there are multiple <a>top-level item</a>s in a document, place items in an RDF Collection.
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   298
      Alternatively, simply list the items as multiple values, or do not generate an
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   299
      <code>http://www.w3.org/ns/md#item</code> mapping at all.</li>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   300
    <li>When an item has multiple values for a given <a>property</a>, place the values in an RDF Collection.
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   301
      Alternatively, do not use collections, use an alternative such as <code>rdf:Seq</code>, or place all values,
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   302
      whether or not multiple, into some form of collection.</li>
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   303
  </ul>
96
5b7fcd8c418f Update hcard example registry entry to be consistent with the definitions.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 91
diff changeset
   304
  <p>More examples and explanatory information are available in [[MICRODATA-RDF-SUPPLEMENT]], which may
5b7fcd8c418f Update hcard example registry entry to be consistent with the definitions.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 91
diff changeset
   305
    be updated from time to time.</p>
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   306
</section>
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   307
</section>
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   308
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   309
<section>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   310
  <h1>Attributes and Syntax</h1>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   311
  <p>
14
2f11ba803758 Added base property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 13
diff changeset
   312
    The microdata specification [[!MICRODATA]] defines a number of attributes and the way in which those
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   313
    attributes are to be interpreted. The
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   314
    <cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#microdata-dom-api">microdata DOM API</a></cite>
100
f885a8d5ff7c Cleanup doc well-formedness.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 99
diff changeset
   315
    provides methods and attributes for retrieving microdata from the HTML DOM.</p>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   316
  <p>For reference, attributes used for specifying and retrieving HTML microdata are referenced here:</p>
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   317
  <dl>
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   318
    <dt><dfn class="adef">itemid</dfn></dt><dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   319
      An attribute containing a URL used to identify the subject of triples associated with this <a>item</a>.
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   320
      (See <cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#attr-itemid">Items</a></cite>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   321
      in [[!MICRODATA]]).
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   322
    </dd>
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   323
    <dt><dfn class="adef">itemprop</dfn></dt><dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   324
      An attribute used to identify one or more <a>name</a>s of an <a>item</a>s. An <a class="aref">itemprop</a>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   325
      contains a space separated list of <dfn>name</dfn>s which may either by <a>absolute URL</a>s or terms
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   326
      associated with the type of the <a>item</a> as defined by the referencing <a>item</a>'s
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   327
      <a>item type</a>.
80
04004b4d7a03 Pubrules checker update
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 78
diff changeset
   328
      (See <cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#names:-the-itemprop-attribute">Items</a></cite>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   329
      in [[!MICRODATA]]).
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   330
    </dd>
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   331
    <dt><dfn class="adef">itemref</dfn></dt><dd>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   332
      An additional attribute on an element that references additional elements containing property
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   333
      definitions to be applied to the referencing <a>item</a>.
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   334
      (See <cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#attr-itemref">Items</a></cite>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   335
      in [[!MICRODATA]]).
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   336
    </dd>
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   337
    <dt><dfn class="adef">itemscope</dfn></dt><dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   338
      An boolean attribute identifying an element as an <a>item</a>.
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   339
      (See <cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#attr-itemscope">Items</a></cite>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   340
      in [[!MICRODATA]]).
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   341
    </dd>
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   342
    <dt><dfn class="adef">itemtype</dfn></dt><dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   343
      An additional attribute on an element used to specify one or more types of an <a>item</a>.
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   344
      The <dfn>item type</dfn> of an <a>item</a> is the first value returned from
24
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   345
      <code><cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#dom-itemtype">element.itemType</a></cite></code>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   346
      on the element.
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   347
      The <a>item type</a> is also used to resolve non-URL <a>name</a>s to <a>absolute URL</a>s.
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   348
      Available through the
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   349
      <cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#microdata-dom-api">Microdata DOM API</a></cite> as
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   350
      <code><cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#dom-itemtype">element.itemType</a></cite></code>.
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   351
      (See <cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#attr-itemtype">Items</a></cite>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   352
      in [[!MICRODATA]]).
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   353
    </dd>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   354
  </dl>
34
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   355
  <p>In RDF, it is common for people to shorten vocabulary terms via abbreviated URIs that use a 'prefix'
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   356
    and a 'reference'. throughout this document assume that the following vocabulary
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   357
    prefixes have been defined:</p>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   358
  <table><tbody>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   359
    <tr>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   360
      <td>dc:</td>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   361
      <td>http://purl.org/dc/terms/</td>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   362
    </tr>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   363
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   364
    <tr>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   365
      <td>md:</td>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   366
      <td>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   367
        http://www.w3.org/ns/md#</td>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   368
    </tr>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   369
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   370
    <tr>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   371
      <td>rdf:</td>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   372
      <td>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   373
        http://www.w3.org/1999/02/22-rdf-syntax-ns#</td>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   374
    </tr>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   375
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   376
    <tr>
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   377
      <td>rdf:</td>
34
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   378
      <td>
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   379
        http://www.w3.org/1999/02/22-rdf-syntax-ns#</td>
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   380
    </tr>
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   381
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   382
    <tr>
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   383
      <td>rdfa:</td>
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   384
      <td>
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   385
        http://www.w3.org/ns/rdfa#</td>
34
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   386
    </tr>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   387
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   388
    <tr>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   389
      <td>xsd:</td>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   390
      <td>http://www.w3.org/2001/XMLSchema#</td>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   391
    </tr>
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   392
  </tbody></table>
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   393
</section>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   394
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   395
<section class="informative">
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   396
  <h1>Vocabulary Registry</h1>
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   397
  <p>In a perfect world, all processors would be able to generate the same output for a given input
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   398
    without regards to the requirements of a particular <a>vocabulary</a>. However, microdata doesn't
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   399
    provide sufficient syntactic help in making these decisions. Different vocabularies have different
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   400
    needs.</p>
34
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   401
  <p>The registry is located at the namespace defined for microdata: <code>http://www.w3.org/ns/md</code> in
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   402
    a variety of formats.</p>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   403
  <p>The <dfn>registry</dfn> associates a <dfn>URI prefix</dfn> with one or more key-value pairs denoting
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   404
  processor behavior. A hypothetical JSON representation of such a registry might be the following:</p>
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   405
<pre class="example" data-transform="updateExample">
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   406
<!--
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   407
{
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   408
  "http://schema.org/": {
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   409
    "propertyURI":    "vocabulary",
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   410
    "multipleValues": "unordered",
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   411
    "properties": {
34
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   412
      "tracks": {"multipleValues": "list"}
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   413
    }
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   414
  },
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   415
  "http://microformats.org/profile/hcard": {
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   416
    "propertyURI":    "vocabulary",
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   417
    "multipleValues": "list",
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   418
    "properties" {
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   419
      "url": {"multipleValues": "unordered"}
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   420
    }
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   421
  }
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   422
}
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   423
-->
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   424
</pre>
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   425
  <p>This structure associates mappings for two URIs, <code>http://schema.org/</code> and
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   426
    <code>http://microformats.org/profile/hcard</code>. Items having an <a>item type</a> with a <a>URI
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   427
    prefix</a> from this <a>registry</a> use the the rules described for that prefix within the scope of that
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   428
    <a>item type</a>. This mapping currently defines two rules: <a><code>propertyURI</code></a> and
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   429
    <a><code>multipleValues</code></a> with values to indicate specific behavior. It also allows overrides
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   430
    on a per-property basis; the <a><code>properties</code></a> key associates an individual <a>name</a>
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   431
    with overrides for default behavior.
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   432
    The interpretation of these
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   433
    rules is defined in the following sections. If an item has no <a>current type</a> or the
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   434
    <a>registry</a> contains no <a>URI prefix</a> matching <a>current type</a>, a conforming
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   435
    processor MUST use the default values defined for these rules.</p>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   436
  <p class="note">The concept of a <a>registry</a>, including a hypothetical format, location and updating rules
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   437
    is presented as an abstract concept useful for describing the function of a microdata processor.
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   438
    There are issues surrounding update
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   439
    frequency, URL naming, and how updates are authorized. This spec
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   440
    just considers the semantic content of such a <a>registry</a> and how it can be used to affect processing without
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   441
    defining its representation or update policies.</p>
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   442
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   443
<section class="informative">
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   444
  <h2>Property URI Generation</h2>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   445
  <p>For <a>name</a>s which are not <a>absolute URL</a>s,
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   446
    the <dfn><code>propertyURI</code></dfn> rule defines the algorithm for generating an <a>absolute URL</a>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   447
    given an <a>evaluation context</a> including a <a>current type</a>, <a>current name</a> and
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   448
    <a>current vocabulary</a>.</p>
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   449
  <p>The procedure for generating property URIs is defined in
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   450
    <a href="#generate-predicate-uri">Generate Predicate URI</a>.</p>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   451
  <p>Possible values for <a><code>propertyURI</code></a> are the following:</p>
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   452
  <dl>
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   453
    <dt><code>contextual</code></dt><dd>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   454
      The <code>contextual</code> URI generation scheme guarantees that generated property URIs are
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   455
      unique based on the value of <a>current name</a>. This is
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   456
      required as the microdata data model requires that <a>name</a>s are associated with specific
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   457
      items and do not have a global scope. (See <a href="#scheme-context">Step 5</a> in
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   458
      <a href="#generate-predicate-uri">Generate Predicate URI</a>).
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   459
      <div>
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   460
        <p>URI creation uses a base URI with query parameters to indicate the in-scope
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   461
          type and <a>name</a> list. Consider the following example:</p>
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   462
        <pre class="example" data-transform="updateExample">
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   463
<!--
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   464
<span itemscope itemtype="http://microformats.org/profile/hcard">
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   465
  <span itemprop="n" itemscope>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   466
    <span itemprop="given-name">
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   467
      Princeton
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   468
    </span>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   469
  </span>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   470
</span>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   471
-->
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   472
        </pre>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   473
        <p>The first <a>name</a> <em>n</em> generates the URI
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   474
          <code>http://www.w3.org/ns/md?type=http://microformats.org/profile/hcard?prop=n</code>.
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   475
          However, the included <a>name</a> <em>given-name</em> is included in untyped item.
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   476
          The inherited property URI is used to create a new property URI:
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   477
          <code>http://www.w3.org/ns/md?type=http://microformats.org/profile/hcard?prop=n.given-name</code>.</p>
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   478
        <p>This scheme is compatible with the needs of other RDF serialization formats such as
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   479
          RDF/XML [[RDF-SYNTAX-GRAMMAR]],
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   480
          which rely on <em>QNames</em> for expressing properties. For example, the generated property URIs
100
f885a8d5ff7c Cleanup doc well-formedness.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 99
diff changeset
   481
          can be split as follows:</p>
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   482
        <pre class="example" data-transform="updateExample">
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   483
<!--
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   484
<rdf:Description xmlns:hcard="http://www.w3.org/ns/md?type=http://microformats.org/profile/hcard?prop="
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   485
                 rdf:type="http://microformats.org/profile/hcard">
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   486
  <hcard:n>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   487
    <rdf:Description>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   488
      <hcard:n.given-name>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   489
        Princeton
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   490
      </hcard:n.given-name>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   491
    </rdf:Description>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   492
  </hcard:n>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   493
</rdf:Description>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   494
-->
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   495
        </pre>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   496
        <p>Looking at another example:</p>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   497
        <pre class="example" data-transform="updateExample">
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   498
<!--
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   499
<div itemscope itemtype="http://schema.org/Person">
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   500
  <h2 itemprop="name">Jeni</h2>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   501
</div>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   502
-->
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   503
        </pre>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   504
        <p>This would generate <code>http://www.w3.org/ns/md?type=http://schema.org/Person&amp;prop=name</code>.</p>
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   505
      </div>
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   506
    </dd>
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   507
    <dt><code>vocabulary</code></dt><dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   508
      The <code>vocabulary</code> URI generation scheme appends <a>name</a>s that are not
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   509
      <a>absolute URL</a>s to the <a>URI prefix</a>. When generating property URIs, if the <a>URI prefix</a>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   510
      does not end with a '/' or '#', a '#' is appended to the <a>URI prefix</a>. (See <a href="#scheme-vocab">Step 4</a>
26
18305e6c52e5 Straighten out some terms so as not to conflate element syntax with the item data model.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 25
diff changeset
   511
      in
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   512
      <a href="#generate-predicate-uri">Generate Predicate URI</a>.)
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   513
      <div>
24
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   514
        <p>URI creation uses a base URL with query parameters to indicate the in-scope
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   515
          type and <a>name</a> list. Consider the following example:</p>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   516
        <pre class="example" data-transform="updateExample">
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   517
<!--
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   518
<span itemscope itemtype="http://microformats.org/profile/hcard">
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   519
  <span itemprop="n" itemscope>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   520
    <span itemprop="given-name">
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   521
      Princeton
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   522
    </span>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   523
  </span>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   524
</span>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   525
-->
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   526
        </pre>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   527
        <p>Given the <a>URI prefix</a> <code>http://microformats.org/profile/hcard</code>, this
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   528
          would generate <code>http://microformats.org/profile/hcard#n</code> and
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   529
          <code>http://microformats.org/profile/hcard#given-name</code>. Note that the '#' is automatically
100
f885a8d5ff7c Cleanup doc well-formedness.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 99
diff changeset
   530
          added as a separator.</p>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   531
        <p>Looking at another example:</p>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   532
        <pre class="example" data-transform="updateExample">
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   533
<!--
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   534
<div itemscope itemtype="http://schema.org/Person">
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   535
  <h2 itemprop="name">Jeni</h2>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   536
</div>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   537
-->
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   538
        </pre>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   539
        <p>Given the <a>URI prefix</a> <code>http://schema.org/</code>,
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   540
          this would generate <code>http://schema.org/name</code>. Note that if the <a class="aref">itemtype</a>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   541
          were <code>http://schema.org/Person/Teacher</code>, this would generate the same property URI.</p>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   542
      </div>
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   543
    </dd>
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   544
  </dl>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   545
  <p>If the <a>registry</a> contains no match for <a>current type</a> implementations act as if
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   546
    there is a <a>URI prefix</a> made from the first <a class="aref">itemtype</a> value by stripping either the <cite><a
35
89285fc6b235 Change 'local name' to 'last path segment'. Reference both 'fragment' and 'last path segment' in RFC3986.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 34
diff changeset
   547
    href="http://tools.ietf.org/html/rfc3986#section-3.5">fragment</a></cite> content or <cite><a
89285fc6b235 Change 'local name' to 'last path segment'. Reference both 'fragment' and 'last path segment' in RFC3986.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 34
diff changeset
   548
    href="http://tools.ietf.org/html/rfc3986#section-3.3">last path segment</a></cite>, if the value has no fragment (See
89285fc6b235 Change 'local name' to 'last path segment'. Reference both 'fragment' and 'last path segment' in RFC3986.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 34
diff changeset
   549
    [[!RFC3986]]).</p>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   550
  <p class="note">Deconstructing the <a class="aref">itemtype</a> URL to create or identify a vocabulary URI
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   551
    is a violation of the microdata specification which is necessary to
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   552
    support the use of existing vocabularies designed for use with RDF, and
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   553
    shared or inherited properties within all vocabularies.</p>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   554
  <p>The default value of <a><code>propertyURI</code></a> is <code>vocabulary</code>.</p>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   555
  <pre class="example" data-transform="updateExample">
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   556
<!--
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   557
<div itemscope itemtype="http://schema.org/Book">
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   558
  <h2 itemprop="title">Just a Geek</h2>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   559
</div>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   560
-->
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   561
  </pre>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   562
  <p>In this example, assuming no matching entry in the <a>registry</a>,
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   563
    the <a>URI prefix</a> is constructed by removing the
35
89285fc6b235 Change 'local name' to 'last path segment'. Reference both 'fragment' and 'last path segment' in RFC3986.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 34
diff changeset
   564
    <cite><a href="http://tools.ietf.org/html/rfc3986#section-3.3">last path segment</a></cite>, leaving the URI
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   565
    <code>http://schema.org/</code>. As there is no explicit <a><code>propertyURI</code></a>,
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   566
    the default <code>vocabulary</code> is used, and the resulting property URI would be
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   567
    <code>http://schema.org/title</code>.</p>
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   568
</section>
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   569
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   570
<section class="informative">
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   571
  <h2>Value Ordering</h2>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   572
  <p>For items having multiple values for a given <a>property</a>,
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   573
    the <dfn><code>multipleValues</code></dfn> rule defines the algorithm for serializing these values.
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   574
    Microdata uses document order when generating <a>property value</a>s, as defined in
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   575
    <cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#microdata-dom-api">Microdata DOM API</a></cite>
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   576
    as <code>element.itemValue</code>. However, many RDF vocabularies expect multiple values to be generated
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   577
    as triples sharing a common subject and predicate. In some cases, it may be useful to retain value ordering.</p>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   578
  <p>The procedure for generating <a>property value</a>s is defined in
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   579
    <a href="#generate-property-values">Generate Property Values</a>.</p>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   580
  <p>Possible values for <a><code>multipleValues</code></a> are the following:</p>
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   581
  <dl>
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   582
    <dt><code>unordered</code></dt><dd>
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   583
      Values are serialized without ordering using a common subject and predicate.
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   584
      (See <a href="#values-unordered">Step 7</a> in
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   585
      <a href="#generate-property-values">Generate Property Values</a>).
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   586
    </dd>
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   587
    <dt><code>list</code></dt><dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   588
      Multi-valued <a class="aref">itemprop</a>s are serialized using an <a>RDF Collection</a>.
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   589
      (See <a href="#values-list">Step 8</a> in
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   590
      <a href="#generate-property-values">Generate Property Values</a>).
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   591
    </dd>
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   592
  </dl>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   593
  <p>An example of how this might be specified in a <a>registry</a> is the following:</p>
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   594
  <pre class="example" data-transform="updateExample">
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   595
<!--
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   596
{
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   597
  "http://schema.org/": {
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   598
    "propertyURI":    "vocabulary",
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   599
    ****"multipleValues": "unordered"****
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   600
  },
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   601
  "http://microformats.org/profile/hcard": {
96
5b7fcd8c418f Update hcard example registry entry to be consistent with the definitions.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 91
diff changeset
   602
    "propertyURI":    "vocabulary",
34
b5e9b5f8d805 Define used namespaces. Make registry definitions more consistent.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 32
diff changeset
   603
    ****"multipleValues": {"multipleValues": "list"}****
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   604
  }
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   605
}
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   606
-->
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   607
  </pre>
26
18305e6c52e5 Straighten out some terms so as not to conflate element syntax with the item data model.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 25
diff changeset
   608
  <p>Additionally, some vocabularies may wish to specify this on a per-property basis. For example,
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   609
    within <code>http://schema.org/MusicPlaylist</code> the <code>tracks</code> property might depend on the order
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   610
    of values to to reproduce associated <code>MusicRecording</code> values.</p>
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   611
  <pre class="example" data-transform="updateExample">
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   612
<!--
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   613
{
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   614
 "http://schema.org/": {
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   615
   "propertyURI": "vocabulary",
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   616
   "multipleValues": "unordered"****,
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   617
   "properties": {
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   618
     "tracks": {"multipleValues": "list"}
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   619
   }****
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   620
 }
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   621
}
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   622
-->
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   623
  </pre>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   624
  <p>The <dfn><code>properties</code></dfn> key takes a JSON Object as a value, which in turn has keys for each
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   625
    property that is to be given alternate semantics. Each <a>name</a> is implicitly expanded to it's URI
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   626
    representation as defined in <a href="#generate-predicate-uri">Generate Predicate URI</a>, so that
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   627
    the behavior is the same whether or not the <a>name</a> is listed as an <a>absolute URL</a>.</p>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   628
  <p>The default value of <a><code>multipleValues</code></a> is <code>unordered</code>.</p>
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   629
  <div class="note">
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   630
    <p>An alternative mechanism would output <em>both</em> unordered and ordered values, to allow an application
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   631
    to choose the most useful representation. For example, consider the following:</p>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   632
<pre class="example" data-transform="updateExample">
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   633
<!--
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   634
<div itemscope itemtype="http://schema.org/MusicPlaylist">
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   635
  <span itemprop="name">Classic Rock Playlist</span>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   636
  <meta itemprop="numTracks" content="2"/>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   637
  <p>Including works by
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   638
    <span itemprop="byArtist">Lynard Skynard</span> and
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   639
    <span itemprop="byArtist">AC/DC</span></p>.
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   640
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   641
  <div itemprop="tracks" itemscope itemtype="http://schema.org/MusicRecording">
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   642
    1.<span itemprop="name">Sweet Home Alabama</span> -
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   643
    <span itemprop="byArtist">Lynard Skynard</span>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   644
    <link href="sweet-home-alabama" itemprop="url" />
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   645
   </div>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   646
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   647
  <div itemprop="tracks" itemscope itemtype="http://schema.org/MusicRecording">
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   648
    2.<span itemprop="name">Shook you all Night Long</span> -
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   649
    <span itemprop="byArtist">AC/DC</span>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   650
    <link href="shook-you-all-night-long" itemprop="url" />
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   651
  </div>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   652
</div>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   653
-->
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   654
</pre>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   655
    <p>This might generate the following Turtle:</p>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   656
<pre class="example" data-transform="updateExample">
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   657
<!--
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   658
@prefix md: <http://www.w3.org/ns/md#> .
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   659
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   660
@prefix rdfa: <http://www.w3.org/ns/rdfa#> .
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   661
@prefix schema: <http://schema.org/> .
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   662
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   663
<> md:item [
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   664
  a schema:MusicPlaylist;
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   665
    schema:name "Classic Rock Playlist";
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   666
    schema:byArtist ("Lynard Skynard" "AC/DC");
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   667
    schema:numTracks "2";
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   668
    schema:tracks _:track1, _:track2, (_:track1 _:track2)
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   669
  ];
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   670
  rdfa:usesVocabulary schema:
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   671
 .
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   672
_:track1 a schema:MusicRecording;
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   673
  schema:byArtist ("Lynard Skynard");
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   674
  schema:name "Sweet Home Alabama";
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   675
  schema:url <sweet-home-alabama> .
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   676
_:track2 a schema:MusicRecording;
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   677
  schema:byArtist ("AC/DC");
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   678
  schema:name "Shook you all Night Long";
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   679
  schema:url <shook-you-all-night-long> .
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   680
-->
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   681
</pre>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   682
    <p>By providing both <code>_:track1</code> and <code>_:track2</code> as object values of the playlist
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   683
      along with an RDF Collection containing the ordered values, the data may be queried via a simple
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   684
      query using the playlist subject, or as an ordered collection.</p>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   685
  </div>
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   686
</section>
14
2f11ba803758 Added base property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 13
diff changeset
   687
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   688
<section class="informative">
14
2f11ba803758 Added base property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 13
diff changeset
   689
  <h2>Value Typing</h2>
21
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   690
  <p>In microdata, all values are strings. In RDF, values may be resources
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   691
   or may be typed with an appropriate datatype.</p>
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   692
  <p> In some cases, the type of a microdata value can be determined from the
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   693
   element on which it is specified. In particular:</p>
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   694
  <ul>
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   695
    <li>URL property elements provide URLs</li>
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   696
    <li><code>time</code> element provides dates and times</li>
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   697
  </ul>
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   698
  <p class="issue">Using information about the content of the document where the microdata
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   699
   is marked up <em>might</em> be a violation of the spirit of the microdata specification, though it does not explicitly say in
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   700
   normative text that consumers cannot use other information from the HTML DOM to interpret microdata.</p>
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   701
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   702
  <p>Additionally, one possible use of a <a>registry</a> would allow vocabularies to be marked with datatype information,
14
2f11ba803758 Added base property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 13
diff changeset
   703
    so that a <code>dc:time</code> value, for example, would be understood to represent a literal with datatype
2f11ba803758 Added base property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 13
diff changeset
   704
    <code>xsd:date</code>. This could be done by adding information for each property in the vocabulary requiring
2f11ba803758 Added base property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 13
diff changeset
   705
    special treatment.</p>
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   706
  <p>This might be represented using a syntax such as the following:</p>
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   707
  <pre class="example" data-transform="updateExample">
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   708
<!--
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   709
{
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   710
 "http://schema.org/": {
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   711
   "propertyURI": "vocabulary",
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   712
   "multipleValues": "unordered"****,
20
8eb4093ca497 Update multiple values and allow for per-property overrides.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 19
diff changeset
   713
   "properties": {
21
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   714
     "dateCreated": {"datatype": "http://www.w3.org/2001/XMLSchema#date"}
15
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   715
   }****
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   716
 }
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   717
}
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   718
-->
29b7fa945ee8 Update notes and change default property URI generation to _base_.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 14
diff changeset
   719
  </pre>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   720
  <p>The <code>datatype</code> identifies a URI to be used in constructing a <a>typed literal</a>.</p>
21
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   721
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   722
  <p>In most cases, the relevant datatype for a value can be derived from
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   723
    knowledge of what property the value is for and the syntax of the value
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   724
    itself. Thus, values can be given datatypes in a post-processing step
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   725
    after the mapping of microdata to RDF described by this specification.
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   726
    However, where there is information in the HTML markup, such as knowledge
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   727
    of what element was used to mark up the value, which can help with
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   728
    determining its datatype, that information is used by this specification.</p>
fdee8a158176 Update value typing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 20
diff changeset
   729
  <p>This concept is not explored further at this time, but could be developed further in
14
2f11ba803758 Added base property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 13
diff changeset
   730
    a future revision of this document.</p>
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   731
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   732
  <p class="note">If property URI generation was fixed to <code>vocabulary</code>, multiple values always
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   733
    generated both <code>unordered</code> and <code>ordered</code> representations, and there were <code>datatype</code>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   734
    support, the <a>registry</a> could be reduced to a simple list of URLs without any further structure necessary.</p>
14
2f11ba803758 Added base property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 13
diff changeset
   735
</section>
129
a4e46999a5c5 Update vocabulary expansion to make it mandatory, but limit scope to properties only.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 127
diff changeset
   736
</section>
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   737
129
a4e46999a5c5 Update vocabulary expansion to make it mandatory, but limit scope to properties only.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 127
diff changeset
   738
<section>
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   739
  <h2 id="vocab_expansion">Vocabulary Expansion</h2>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   740
  <p>Microdata requires that all values of <a class="aref">itemtype</a> come from the same vocabulary. This
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   741
    is required as <a class="aref">itemprop</a> values are resolved relative to that vocabulary. However,
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   742
    it is often useful to define an <a>item</a> to have types from multiple different vocabularies.</p>
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   743
  <p>Vocabulary expansion uses simple rules to generate additional triples based on 
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   744
    rules and property relationships described in the <a>registry</a>.
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   745
    Within the <a>registry</a>, a property definition may have either <code>equivalentProperty</code>
129
a4e46999a5c5 Update vocabulary expansion to make it mandatory, but limit scope to properties only.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 127
diff changeset
   746
    or <code>subPropertyOf</code> keys having a IRI value (or array of IRI values)
a4e46999a5c5 Update vocabulary expansion to make it mandatory, but limit scope to properties only.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 127
diff changeset
   747
    of the associated property. Such an
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   748
    entry causes the processor to generate triples associating the source
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   749
    property IRI with the target property IRI using either
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   750
    <code>http://www.w3.org/2000/01/rdf-schema#subPropertyOf</code> or
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   751
    <code>http://www.w3.org/2002/07/owl#equivalentProperty</code> predicates.</p>
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   752
   <p>For example, the <a>registry</a> definition for the <em>additionalType</em> property
129
a4e46999a5c5 Update vocabulary expansion to make it mandatory, but limit scope to properties only.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 127
diff changeset
   753
    within schema.org, defines <em>additionalType</em> to have an <a>rdfs:subPropertyOf</a>
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   754
    relationship with <code>http://www.w3.org/1999/02/22-rdf-syntax-ns#type</code>.</p>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   755
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   756
<pre class="example" data-transform="updateExample">
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   757
<!--
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   758
{
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   759
  "http://schema.org/": {
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   760
    "properties": {
119
9696af1850be additionalType now uses rdfs:subPropertyof instead of owl:equivalentProperty
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 118
diff changeset
   761
      ****"additionalType": {"subPropertyOf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#type"}****
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   762
    }
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   763
}
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   764
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   765
<div itemscope itemtype="http://schema.org/Product">
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   766
  <link itemprop="additionalType" href="http://www.productontology.org/id/Laser_printer" />
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   767
  <p itemprop="name">Laser Printer</a>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   768
</div>	
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   769
-->
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   770
</pre>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   771
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   772
  <p>The previous example, indicates a <a>registry</a> rule, which causes the processor to emit
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   773
    an extra triple when first seeing the <code>additionalProperty</code> <a class="aref">itemprop</a>:</p>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   774
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   775
<pre class="example" data-transform="updateExample">
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   776
<!--
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   777
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   778
@prefix rdfa: <http://www.w3.org/ns/rdfa#> .
125
9a4af2b90c87 Fix problem in examples where owl:subPropertOf was used instead of rdfs:subPropertyOf
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 122
diff changeset
   779
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   780
@prefix schema: <http://schema.org/> .
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   781
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   782
<> md:item (
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   783
  [ a schema:Product;
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   784
    schema:additionalType <http://www.productontology.org/id/Laser_printer> ;
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   785
    schema:name "Laser Printer"]
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   786
  );
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   787
  rdfa:usesVocabulary schema: .
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   788
125
9a4af2b90c87 Fix problem in examples where owl:subPropertOf was used instead of rdfs:subPropertyOf
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 122
diff changeset
   789
schema:additionalProperty rdfs:subPropertyOf rdf:type .
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   790
-->
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   791
</pre>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   792
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   793
  <p>After performing vocabulary expansion, an additional <code>rdf:type</code> triple is generated:</p>
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   794
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   795
<pre class="example" data-transform="updateExample">
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   796
<!--
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   797
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
125
9a4af2b90c87 Fix problem in examples where owl:subPropertOf was used instead of rdfs:subPropertyOf
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 122
diff changeset
   798
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   799
@prefix schema: <http://schema.org/> .
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   800
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   801
<> md:item (
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   802
  [ a schema:Product, <http://www.productontology.org/id/Laser_printer>;
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   803
    schema:additionalType <http://www.productontology.org/id/Laser_printer> ;
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   804
    schema:name "Laser Printer"]
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   805
  )
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   806
  rdfa:usesVocabulary schema: .
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   807
125
9a4af2b90c87 Fix problem in examples where owl:subPropertOf was used instead of rdfs:subPropertyOf
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 122
diff changeset
   808
schema:additionalProperty rdfs:subPropertyOf rdf:type .
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   809
-->
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   810
</pre>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   811
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   812
<section>
120
87cbd14d7d22 Added normative reference to RDFa Vocabulary Entailment, and generate rdfa:usesVocabulary
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 119
diff changeset
   813
  <h2>Vocabulary Entailment</h2>
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   814
  <p>Formally, and for the purpose of vocabulary processing, microdata uses a very
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   815
    restricted subset of the OWL2 vocabulary and is based on the RDF-Based Semantics of OWL2 [[!OWL2-RDF-BASED-SEMANTICS]].
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   816
    Vocabulary Entailment uses the following terms: </p>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   817
  <ul>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   818
    <li><code>rdfs:subPropertyOf</code></li>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   819
    <li><code>owl:equivalentProperty</code>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   820
    </li>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   821
  </ul>
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   822
  <p>Vocabulary Entailment considers only the entailment on individuals
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   823
    (i.e., not on the relationships that can be deduced on the
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   824
    properties or the classes themselves.)
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   825
  </p>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   826
  <p class="note">While the formal definition of the Entailment
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   827
    refers to the general OWL 2 Semantics, practical implementations may
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   828
    rely on a subset of the OWL 2 RL Profile’s entailment expressed in
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   829
    rules
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   830
    (<cite><a href="http://www.w3.org/TR/2009/REC-owl2-profiles-20091027/#Reasoning_in_OWL_2_RL_and_RDF_Graphs_using_Rules">
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   831
      section 4.3</a></cite>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   832
    of [[!OWL2-PROFILES]]). The
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   833
    relevant rules are, using the rule identifications in
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   834
    <cite><a href="http://www.w3.org/TR/2009/REC-owl2-profiles-20091027/#Reasoning_in_OWL_2_RL_and_RDF_Graphs_using_Rules">
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   835
      section 4.3</a></cite>
129
a4e46999a5c5 Update vocabulary expansion to make it mandatory, but limit scope to properties only.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 127
diff changeset
   836
    of [[!OWL2-PROFILES]]): <code>prp-spo1</code>, <code>prp-eqp1</code>, and
a4e46999a5c5 Update vocabulary expansion to make it mandatory, but limit scope to properties only.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 127
diff changeset
   837
    <code>prp-eqp2</code>.</p>
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   838
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   839
  <p>[[RDFA-CORE]] implements a more complete form of vocabulary entailement, 
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   840
    including retrieving the vocabulary URI to find additional class and property expansion definitions, as
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   841
    described in <cite><a href="http://www.w3.org/TR/rdfa-syntax/#s_vocab_entailment">RDFa Vocabulary Entailment</a></cite>.
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   842
    Microdata implementations MAY use RDFa Vocabulary Entailment as an alternative to implementing
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   843
    a separate entailment algorithm. To allow [[RDFA-CORE]] processors to be used for microdata vocabulary expansion, microdata acts as if there is an implicit <code>@vocab</code> RDFa attribute set to a detected vocabulary by emitting
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   844
    a triple using the <code>rdfa:usesVocabulary</code> predicate.</p>
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   845
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   846
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   847
  <p class="note">The entailment described in this section is the <em>minimum</em>
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   848
    useful level for microdata. Processors may, of course, choose to follow
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   849
    more powerful entailment regimes, e.g., include full RDFS [[!RDF-MT]]
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   850
    or OWL2 [[!OWL2-OVERVIEW]] entailments. Using those entailments
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   851
    applications may perform datatype validation by checking <code>rdfs:range</code>
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   852
    of a property, or use the advanced facilities offered by, e.g., OWL2’s
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   853
    property chains to interlink vocabularies further.</p>
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   854
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   855
</section>
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   856
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   857
<section>
120
87cbd14d7d22 Added normative reference to RDFa Vocabulary Entailment, and generate rdfa:usesVocabulary
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 119
diff changeset
   858
  <h2>Vocabulary Expansion Control of Microdata Processors</h2>
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   859
  <p>Conforming processors MUST perform the basic vocabulary expansion.</p>
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   860
  <p>If vocabulary expansion is performed by the microdata processor using [[RDFA-CORE]] vocabulary expansion, and the
130
6bc9cda42cf5 More edits to simplify vocabulary expansion and improve examples.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 129
diff changeset
   861
    <code>vocab_expansion</code> option is passed to the microdata processor,
139
bad9c8c009ee Editorial updates on the index.html file
Ivan Herman <ivan@ivan-herman.net>
parents: 130
diff changeset
   862
    the full [[RDFA-CORE]] expansion MUST also be performed.</p>
118
0530f462c8d8 Added Vocabulary Expansion, and updated the schema.org definition to use owl:equivalentProperty semantics for additionalType.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 117
diff changeset
   863
</section>
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
   864
</section>
9
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   865
b296d3ba308a Adding more rational and description of use-cases and alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 8
diff changeset
   866
<section>
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   867
  <h1>Algorithm</h1>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   868
  <p>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   869
    Transformation of Microdata to RDF makes use of general processing rules described in [[!MICRODATA]]
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   870
    for the treatment of <a>item</a>s.
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   871
  </p>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   872
  <section>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   873
    <h2>Algorithm Terms</h2>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   874
    <dl>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   875
      <dt><dfn>absolute URL</dfn></dt><dd>
90
e3c7dee132f7 Update most references from editor's drafts to latest timestamped working draft. There are no timestamped references for http://dev.w3.org/html5/spec/Overview.html#valid-duration-string and http://dev.w3.org/html5/spec/Overview.html#valid-yearless-date-string
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 88
diff changeset
   876
        The term <cite><a href="http://www.w3.org/TR/2011/WD-html5-20110525/urls.html#absolute-url">absolute URL</a></cite>
22
1e11ddb0f4a8 absolute URI => absolute URL.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 21
diff changeset
   877
        is defined in [[!HTML5]].
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   878
      </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   879
      <dt><dfn>blank node</dfn></dt><dd>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   880
        A blank node is a node in a graph that is neither a <a>URI reference</a> nor a <a>literal</a>.
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   881
        <a>Item</a>s without a <a>global identifier</a> have a blank node allocated to them.
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   882
        (See [[RDF-CONCEPTS]]).
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   883
      </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   884
      <dt><dfn>document base</dfn></dt><dd>
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   885
        The base address of the document being processed, as defined in <cite><a
90
e3c7dee132f7 Update most references from editor's drafts to latest timestamped working draft. There are no timestamped references for http://dev.w3.org/html5/spec/Overview.html#valid-duration-string and http://dev.w3.org/html5/spec/Overview.html#valid-yearless-date-string
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 88
diff changeset
   886
        href="http://www.w3.org/TR/2011/WD-html5-20110525/urls.html#resolving-urls">Resolving URLs</a></cite> in
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   887
        [[!HTML5]].
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   888
      </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   889
      <dt><dfn>evaluation context</dfn></dt><dd>
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   890
        A data structure including the following elements:
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   891
        <dl>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   892
          <dt><dfn>memory</dfn></dt><dd>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   893
            a mapping of items to subjects, initially empty;
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   894
          </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   895
          <dt><dfn>current name</dfn></dt><dd>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   896
            an <a>absolute URL</a> for the in-scope <a>name</a>, used for generating URIs
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   897
            for properties of items without an <a>item type</a>;
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   898
            <div class="note">
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   899
              <a>current name</a> is required for the <code>contextual</code> property URI generation
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   900
              scheme. Without this scheme, this evaluation context component would not be required.
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   901
            </div>
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   902
          </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   903
          <dt><dfn>current type</dfn></dt><dd>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   904
            an <a>absolute URL</a> for the <em>current type</em>, used when an <a>item</a> does not
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   905
            contain an <a>item type</a>;
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   906
          </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   907
          <dt><dfn>current vocabulary</dfn></dt><dd>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   908
            an <a>absolute URL</a> for the <em>current vocabulary</em>, from the <a>registry</a>.
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   909
          </dd>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   910
        </dl>
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   911
      </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   912
      <dt><dfn>item</dfn></dt><dd>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   913
         An <a>item</a> is described by an element containing an <a class="aref">itemscope</a> attribute. The list
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   914
         of top-level microdata items may be retrieved using the
100
f885a8d5ff7c Cleanup doc well-formedness.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 99
diff changeset
   915
         <cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#microdata-dom-api">Microdata DOM API</a></cite>
80
04004b4d7a03 Pubrules checker update
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 78
diff changeset
   916
         <code><cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#dom-document-getitems">document.getItems</a></cite></code>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   917
         method.
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   918
      </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   919
      <dt><dfn>item properties</dfn></dt><dd>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   920
        The mechanism for finding the <a title="item properties">properties of an item</a> The list
24
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   921
         of item properties items may be retrieved using the
100
f885a8d5ff7c Cleanup doc well-formedness.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 99
diff changeset
   922
         <cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#microdata-dom-api">Microdata DOM API</a></cite>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   923
         <code><cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#dom-properties">element.properties</a></cite></code>
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   924
         attribute.
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   925
      </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   926
      <dt><dfn>fragment-escape</dfn></dt><dd>
90
e3c7dee132f7 Update most references from editor's drafts to latest timestamped working draft. There are no timestamped references for http://dev.w3.org/html5/spec/Overview.html#valid-duration-string and http://dev.w3.org/html5/spec/Overview.html#valid-yearless-date-string
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 88
diff changeset
   927
        The term <cite><a href="http://www.w3.org/TR/2011/WD-html5-20110525/urls.html#fragment-escaped">fragment-escape</a></cite>
24
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   928
        is defined in [[!HTML5]]. This involves transforming elements added to URLs to ensure that the result
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   929
        remains a valid URL. The following characters are subject to percent escaping:
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   930
        <ul>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   931
          <li>U+0022 QUOTATION MARK character (")</li>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   932
          <li>U+0023 NUMBER SIGN character (#)</li>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   933
          <li>U+0025 PERCENT SIGN character (%)</li>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   934
          <li>U+003C LESS-THAN SIGN character (&lt;)</li>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   935
          <li>U+003E GREATER-THAN SIGN character (&gt;)</li>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   936
          <li>U+005B LEFT SQUARE BRACKET character ([)</li>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   937
          <li>U+005C REVERSE SOLIDUS character (\)</li>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   938
          <li>U+005D RIGHT SQUARE BRACKET character (])</li>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   939
          <li>U+005E CIRCUMFLEX ACCENT character (^)</li>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   940
          <li>U+007B LEFT CURLY BRACKET character ({)</li>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   941
          <li>U+007C VERTICAL LINE character (|)</li>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   942
          <li>U+007D RIGHT CURLY BRACKET character (})</li>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   943
        </ul>
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   944
      </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   945
      <dt><dfn>global identifier</dfn></dt><dd>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   946
        The value of an <a>item</a>'s <a>itemid</a> attribute, if it has one. (See <cite><a
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   947
        href="http://www.w3.org/TR/2011/WD-microdata-20110525/#attr-itemscope">Items</a></cite> in
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   948
        [[!MICRODATA]]).
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   949
      </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   950
      <dt><dfn>literal</dfn></dt><dd>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   951
        Literals are values such as strings and dates, including <dfn>typed literal</dfn>s and
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   952
        <dfn>plain literal</dfn>s.
10
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   953
        (See [[RDF-CONCEPTS]]).
74bd1c88b77d updated definitions and algorithms for vocabulary-specific processing.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 9
diff changeset
   954
      </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   955
      <dt><dfn>property</dfn></dt><dd>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   956
        Each <a>name</a> identifies a <a>property</a> of an <a>item</a>.
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   957
        An <a>item</a> may have multiple elements sharing the same <a>name</a>, creating
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   958
        a multi-valued <a>property</a>.
26
18305e6c52e5 Straighten out some terms so as not to conflate element syntax with the item data model.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 25
diff changeset
   959
       </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   960
     <dt><dfn>property names</dfn></dt><dd>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   961
        The tokens of an element's <a class="aref">itemprop</a> attribute. Each token is a <a>name</a>.
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   962
        (See <cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#property-names">Names: the
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   963
        itemprop attribute</a></cite> in [[!MICRODATA]]).
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   964
      </dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   965
      <dt><dfn>property value</dfn></dt><dd>
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   966
        The <a>property value</a> of a name-value pair added by an element with an <a class="aref">itemprop</a>
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   967
        attribute depends on the element.
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   968
        <dl>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   969
          <dt>If the element has no <a class="aref">itemprop</a> attribute</dt>
19
dcefcd38c07b Update from Jeni's feedback through property URI generation.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 18
diff changeset
   970
          <dd>The value is null and no triple should be generated.</dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   971
          <dt>If the element creates an <a>item</a> (by having an <a class="aref">itemscope</a> attribute)</dt>
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   972
          <dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   973
            The value is the <a>URI reference</a> or <a>blank node</a> returned from
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   974
            <a href="#generate-the-triples">generate the triples</a> for that <a>item</a>.
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   975
          </dd>
24
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   976
          <dt>If the element is a URL property element (<code>a</code>, <code>area</code>, <code>audio</code>,
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   977
            <code>embed</code>, <code>iframe</code>, <code>img</code>, <code>link</code>, <code>object</code>,
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   978
            <code>source</code>, <code>track</code> or <code>video</code>)</dt>
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   979
          <dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   980
            The value is a <a>URI reference</a> created from <code><cite>
24
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   981
              <a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#dom-itemvalue">element.itemValue</a></cite></code>.
30
0d6b89f5befb Added registry example.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 29
diff changeset
   982
              (See relevant attribute descriptions in [[!HTML5]]).
0
4347f7d575a1 Added Microdata to RDF mapping document.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents:
diff changeset
   983
          </dd>
27
593b491ce081 Add Jeni as author. Use languge for un-matched <time> and remove special treatment for <data>.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 26
diff changeset
   984
          <dt>If the element is a <code>time</code> element.</dt>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   985
          <dd>The value is a <a>literal</a> made from <code><cite>
24
77ea431ec4ab Changes to normative procedures.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 23
diff changeset
   986
            <a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#dom-itemvalue">element.itemValue</a></cite></code>.
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   987
            <dl>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   988
              <dt>
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   989
                If the value is a
90
e3c7dee132f7 Update most references from editor's drafts to latest timestamped working draft. There are no timestamped references for http://dev.w3.org/html5/spec/Overview.html#valid-duration-string and http://dev.w3.org/html5/spec/Overview.html#valid-yearless-date-string
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 88
diff changeset
   990
                <cite><a href="http://www.w3.org/TR/2011/WD-html5-20110525/common-microsyntaxes.html#valid-date-string">
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   991
                  valid date string
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   992
                </a></cite>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   993
                having the lexical form of
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
   994
                <cite><a
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   995
                href="http://www.w3.org/TR/xmlschema-2/#date">xsd:date</a></cite> [[!RDF-SCHEMA]].
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   996
              </dt>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   997
              <dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
   998
                The value is a <a>typed literal</a> composed of the value and
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
   999
                <code>http://www.w3.org/2001/XMLSchema#date</code>.
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
  1000
              </dd>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
  1001
              <dt>
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1002
                If the value is a
90
e3c7dee132f7 Update most references from editor's drafts to latest timestamped working draft. There are no timestamped references for http://dev.w3.org/html5/spec/Overview.html#valid-duration-string and http://dev.w3.org/html5/spec/Overview.html#valid-yearless-date-string
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 88
diff changeset
  1003
                <cite><a href="http://www.w3.org/TR/2011/WD-html5-20110525/common-microsyntaxes.html#valid-time-string">
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1004
                  valid time string
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1005
                </a></cite>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1006
                having the lexical form of
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1007
                <cite><a href="http://www.w3.org/TR/xmlschema-2/#time">xsd:time</a></cite> [[!RDF-SCHEMA]].
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
  1008
              </dt>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
  1009
              <dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
  1010
                The value is a <a>typed literal</a> composed of the value and
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
  1011
                <code>http://www.w3.org/2001/XMLSchema#time</code>.
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
  1012
              </dd>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
  1013
              <dt>
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1014
                If the value is a
90
e3c7dee132f7 Update most references from editor's drafts to latest timestamped working draft. There are no timestamped references for http://dev.w3.org/html5/spec/Overview.html#valid-duration-string and http://dev.w3.org/html5/spec/Overview.html#valid-yearless-date-string
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 88
diff changeset
  1015
                <cite><a href="http://www.w3.org/TR/2011/WD-html5-20110525/common-microsyntaxes.html#valid-local-date-and-time-string">
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1016
                  valid local date and time string
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1017
                </a></cite>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1018
                or
90
e3c7dee132f7 Update most references from editor's drafts to latest timestamped working draft. There are no timestamped references for http://dev.w3.org/html5/spec/Overview.html#valid-duration-string and http://dev.w3.org/html5/spec/Overview.html#valid-yearless-date-string
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 88
diff changeset
  1019
                <cite><a href="http://www.w3.org/TR/2011/WD-html5-20110525/common-microsyntaxes.html#valid-global-date-and-time-string">
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1020
                  valid global date and time string
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1021
                </a></cite>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1022
                having the lexical form of
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1023
                <cite><a href="http://www.w3.org/TR/xmlschema-2/#dateTime">xsd:dateTime</a></cite> [[!RDF-SCHEMA]].
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
  1024
              </dt>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
  1025
              <dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
  1026
                The value is a <a>typed literal</a> composed of the value and
13
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
  1027
               <code>http://www.w3.org/2001/XMLSchema#dateTime</code>.
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
  1028
              </dd>
6156a9cbd997 Update contextual property URI generation scheme.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 12
diff changeset
  1029
              <dt>
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1030
                If the value is a
90
e3c7dee132f7 Update most references from editor's drafts to latest timestamped working draft. There are no timestamped references for http://dev.w3.org/html5/spec/Overview.html#valid-duration-string and http://dev.w3.org/html5/spec/Overview.html#valid-yearless-date-string
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 88
diff changeset
  1031
                <cite><a href="http://www.w3.org/TR/2011/WD-html5-20110525/common-microsyntaxes.html#valid-month-string">
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1032
                  valid month string
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1033
                </a></cite>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1034
                having the lexical form of
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1035
                <cite><a href="http://www.w3.org/TR/xmlschema-2/#gYearMonth">xsd:gYearMonth</a></cite> [[!RDF-SCHEMA]].
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1036
              </dt>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1037
              <dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
  1038
                The value is a <a>typed literal</a> composed of the value and
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1039
               <code>http://www.w3.org/2001/XMLSchema#gYearMonth</code>.
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1040
              </dd>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1041
              <dt>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1042
                If the value is a
90
e3c7dee132f7 Update most references from editor's drafts to latest timestamped working draft. There are no timestamped references for http://dev.w3.org/html5/spec/Overview.html#valid-duration-string and http://dev.w3.org/html5/spec/Overview.html#valid-yearless-date-string
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 88
diff changeset
  1043
                <cite><a href="http://www.w3.org/TR/2011/WD-html5-20110525/common-microsyntaxes.html#valid-non-negative-integer">
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1044
                  valid non-negative integer
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1045
                </a></cite>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1046
                having the lexical form of
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
  1047
                <cite><a href="http://www.w3.org/TR/xmlschema-2/#gYear">xsd:gYear</a></cite> [[!RDF-SCHEMA]].
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1048
              </dt>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1049
              <dd>
117
8055fc70e571 Remove tref/tdef and aref/adef and change to using dfn an a.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 116
diff changeset
  1050
                The value is a <a>typed literal</a> composed of the value and
116
27799872a9be Update to latest ReSpec. Uses new issue-numbering, and will link to issues.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 114
diff changeset
  1051
               <code>http://www.w3.org/2001/XMLSchema#gYear</code>.
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1052
              </dd>
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1053
              <dt>
91
d6f03b8d46e4 Remove remaining dev.w3.org citations.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 90
diff changeset
  1054
                If the value has the lexical form of
d6f03b8d46e4 Remove remaining dev.w3.org citations.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 90
diff changeset
  1055
                <cite><a href="http://www.w3.org/TR/xmlschema-2/#duration">xsd:duration</a></cite>
d6f03b8d46e4 Remove remaining dev.w3.org citations.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 90
diff changeset
  1056
                [[!RDF-SCHEMA]].
d6f03b8d46e4 Remove remaining dev.w3.org citations.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 90
diff changeset
  1057
                <!--
78
c81961df1e15 Updates for FPWD. Includes adding an abstract, addional <time> values and adding some notes about alternatives.
Gregg Kellogg <gregg@kellogg-assoc.com>
parents: 44
diff changeset
  1058
                If the value is a