Spec editorial: use RDFa 1.1 markup

When we published RDFa Core 1.1 and related specs as CRs, Shane and I worked on improving the RDFa output from ReSpec documents. Add the following to the respecConfig:

          doRDFa: "1.1",

This generates some pretty reasonable automatic RDFa when the document is saved, for example, when running on http://www.w3.org/2010/02/rdfa/sources/rdfa-core/Overview.html:

@base <http://www.w3.org/2010/02/rdfa/sources/rdfa-core/Overview.html> .
@prefix bibo: <http://purl.org/ontology/bibo/> .
@prefix dc: <http://purl.org/dc/terms/> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix xhv: <http://www.w3.org/1999/xhtml/vocab#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

<> a bibo:Document;
   dc:title "RDFa Core 1.1";
   dc:abstract """Abstract
      The current Web is primarily made up of an enormous number of documents ...
    """;
   dc:issued "2012-06-07T05:00:00+0000"^^xsd:dateTime;
   dc:language "en";
   dc:publisher [ a foaf:Organization;
     foaf:homepage <http://www.w3.org/>;
     foaf:name "World Wide Web Consortium"];
   dc:references <http://www.w3.org/TR/1999/REC-html401-19991224>,
     <http://microformats.org>,
     <http://www.w3.org/2001/tag/doc/qnameids-2004-03-17>,
     <http://www.w3.org/TR/2004/REC-rdf-concepts-20040210>,
     <http://www.w3.org/TR/2004/REC-rdf-primer-20040210/>,
     <http://www.w3.org/TR/1999/REC-rdf-syntax-19990222>,
     <http://www.w3.org/TR/2004/REC-rdf-testcases-20040210>,
     <http://www.w3.org/TR/2012/NOTE-rdfa-primer-20120607>,
     <http://www.w3.org/TR/2008/REC-rdfa-syntax-20081014>,
     <http://standards.iso.org/ittf/PubliclyAvailableStandards/c052348_ISO_IEC_19757-2_2008(E).zip>,
     <http://www.megginson.com/downloads/SAX/>,
     <http://www.w3.org/TeamSubmission/turtle/>,
     <http://www.w3.org/TR/2011/WD-widgets-uri-20110927>,
     <http://www.w3.org/TR/2001/REC-xhtml11-20010531>,
     <http://www.w3.org/TR/2002/REC-xml-exc-c14n-20020718/>,
     <http://www.w3.org/TR/2008/REC-xml-20081126/>,
     <http://www.w3.org/TR/2012/REC-xmlschema11-1-20120405/>;
   dc:replaces <http://www.w3.org/TR/2012/PR-rdfa-core-20120508/>;
   dc:requires <http://www.w3.org/TR/2009/REC-owl2-overview-20091027/>,
     <http://www.w3.org/TR/2009/REC-owl2-profiles-20091027/>,
     <http://www.w3.org/TR/2009/REC-owl2-rdf-based-semantics-20091027/>,
     <http://www.w3.org/TR/2004/REC-rdf-mt-20040210>,
     <http://www.w3.org/TR/2004/REC-rdf-syntax-grammar-20040210>,
     <http://www.ietf.org/rfc/rfc2119.txt>,
     <http://www.ietf.org/rfc/rfc3987.txt>,
     <http://www.w3.org/TR/2012/REC-xhtml-rdfa-20120607/>,
     <http://www.w3.org/TR/2009/REC-xml-names-20091208/>,
     <http://www.w3.org/TR/2006/REC-xml-20060816/>,
     <http://www.w3.org/TR/2012/REC-xmlschema11-2-20120405/>;
   bibo:chapter <#abstract>,
     <#sotd>,
     <#toc>,
     <#s_motivation>,
     <#s_Syntax_overview>,
     <#s_rdfterminology>,
     <#conformance>,
     <#s_syntax>,
     <#s_curies>,
     <#s_model>,
     <#s_rdfaindetail>,
     <#s_initialcontexts>,
     <#s_vocab_expansion>,
     <#s_datatypes>,
     <#vocabulary>,
     <#a_history>,
     <#a_acks>,
     <#references>;
   bibo:editor ([ a foaf:Person;
       foaf:mbox <mailto:ben@adida.net>;
       foaf:name "Ben Adida"] [ a foaf:Person;
       foaf:mbox <mailto:mark.birbeck@webBackplane.com>;
       foaf:name "Mark Birbeck"] [ a foaf:Person;
       foaf:homepage <http://blog.halindrome.com>;
       foaf:mbox <mailto:shane@aptest.com>;
       foaf:name "Shane McCarron"] [ a foaf:Person;
       foaf:homepage <http://www.w3.org/People/Ivan/>;
       foaf:mbox <mailto:ivan@w3.org>;
       foaf:name "Ivan Herman"]);
   bibo:subtitle "Syntax and processing rules for embedding RDF through attributes";
   xhv:license <http://www.w3.org/Consortium/Legal/ipr-notice#Copyright>;
   xhv:stylesheet <http://www.w3.org/StyleSheets/TR/W3C-REC> .

...

I suggest that all RDF WG documents using ReSpec add doRDFa: "1.1" to their respec config so that our specs are also marked up with RDFa. I've done this for the JSON-LD Syntax and API docs.

Gregg

Received on Thursday, 31 May 2012 18:08:53 UTC