Re: Spec editorial: use RDFa 1.1 markup

(Adding Shane)

On May 31, 2012, at 3:13 PM, Richard Cyganiak wrote:

> Hi Gregg,
> 
> We use our own slightly patched copy of ReSpec. It's in hg under /rdf/ReSpec.js. I've merged the changes from ReSpec CVS, and changed the ED of RDF Concepts to use RDFa 1.1, and everything seems to work.

Great!

> One question though, shouldn't the doctype be HTML 4.01 + RDFa 1.1 so that it validates? I've always changed that manually before publishing a WD, is that a bad idea?

We've published RDFa using XHTML+RDFa, which uses the following DOCTYPE:

<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML+RDFa 1.1//EN' 'http://www.w3.org/MarkUp/DTD/xhtml-rdfa-2.dtd'>

This should validate. I suspect that Shane didn't add anything to support HTML4, but it should be possible. I'm not sure what DTD it should use, though.

> By the way, here's what we've patched in ReSpec:
> http://dvcs.w3.org/hg/rdf/raw-file/default/ReSpec.js/js/respec.js.diff
> 
> We also have a couple of references there that haven't been merged into the main ReSpec CVS:
> http://dvcs.w3.org/hg/rdf/raw-file/default/ReSpec.js/bibref/biblio.js

We just put our references inline in the doc, as follows:

          apply:  function(c) {
                    // extend the bibliography entries
                    berjon.biblio["MICRODATA"] = "<cite><a href=\"http://www.w3.org/TR/2012/WD-microdata-20120329/\">HTML Microdata</a></cite> Ian Hickson Editor. World Wide Web Consortium (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/";

There's quite a bit more that goes in there too, you can check out http://json-ld.org/spec/latest/json-ld/syntax/index.html for an example.

> Do you know a good process for getting that stuff folded back into the ReSpec.js CVS? I've sent a mail to the spec-prod list about this many months ago but it was ignored and I don't feel much like chasing after whoever is in charge of maintaining ReSpec.

Shane does this more, but I've never had much success with W3C CVS, however many people do just update the biblio references there.

Gregg

> Best,
> Richard
> 
> 
> On 31 May 2012, at 19:07, Gregg Kellogg wrote:
> 
>> 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 23:39:51 UTC