Re: Spec editorial: use RDFa 1.1 markup

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.

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?

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

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.

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 22:14:14 UTC