added a bibliography reference page that shows ReSpec+GLD references; more work on Data Cube references
authorRichard Cyganiak <richard@cyganiak.de>
Fri, 10 Feb 2012 20:10:04 +0000
changeset 86 18f4fd7d778a
parent 85 53f3d3236d70
child 87 26012778fea6
added a bibliography reference page that shows ReSpec+GLD references; more work on Data Cube references
data-cube/index.html
respec/biblio.html
respec/gld-bib.js
--- a/data-cube/index.html	Fri Feb 10 19:40:03 2012 +0000
+++ b/data-cube/index.html	Fri Feb 10 20:10:04 2012 +0000
@@ -9,6 +9,8 @@
 	<script src="../respec/gld-bib.js" class="remove"></script>
 	<script src="respec-config.js" class="remove"></script>
   <style type="text/css">
+.todo { background-color: #fdd; border: 1px solid #800; margin: 1em 0em; padding: 1em; page-break-inside: avoid ; font-style: italic; }
+.todo:before { content: 'TODO: '; }
 .spare-table { border-collapse: collapse; margin-left: 5ex; }
 .spare-table thead { border-bottom: black 1px solid; }
 .spare-table td { padding-left: 1em; padding-right: 1em; }
@@ -61,7 +63,7 @@
 The vocabulary is based upon the approach used by the SDMX ISO standard
 for statistical data exchange. This <em>cube</em> model is very
 general and so the Data Cube vocabulary can be used for other data sets
-such as survey data, spreadsheets and OLAP data cubes <a href="#ref-OLAP">[OLAP]</a>.
+such as survey data, spreadsheets and OLAP data cubes [[OLAP]].
 </p>
 
 <p>
@@ -95,7 +97,7 @@
 
 <p><em>Linked data</em> is an approach to publishing data on the web, enabling
 datasets to be linked together through references to common concepts.
-  The approach <a href="#ref-linked-data">[LOD]</a>
+  The approach [[LOD]]
 recommends use of HTTP URIs to name the entities and concepts so that consumers of
 the data can look-up those URIs to get more information, including links
 to other related URIs.
@@ -172,7 +174,7 @@
 <section id="intro-scovo">
 <h3>Relationship to SCOVO</h3>
 
-<p>The Statistical Core Vocabulary (SCOVO) <a href="#ref-scovo">[SCOVO]</a> is a lightweight
+<p>The Statistical Core Vocabulary (SCOVO) [[SCOVO]] is a lightweight
 RDF vocabulary for expressing statistical data. Its relative
 simplicity allows easy adoption by data producers and consumers, and
 it can be combined with other RDF vocabularies for greater effect. The
@@ -548,7 +550,7 @@
 
 <p>To support this reuse of general statistical concepts the data cube vocabulary provides the <code>qb:concept</code> property which
   links a <code>qb:ComponentProperty</code> to the concept it represents. We use the SKOS
-  vocabulary <a href="#ref-skos">[SKOS]</a> to represent such concepts. This is very natural for those cases where the  
+  vocabulary [[SKOS-PRIMER]] to represent such concepts. This is very natural for those cases where the  
   concepts are already maintained as a controlled term list or thesaurus.
    When developing a data structure definition for an informal data set there may not be an appropriate 
    concept already. In those cases, if the concept is likely to be reused in other guises it is recommended to
@@ -589,7 +591,7 @@
 <section id="dsd-cog">
 <h3>Content oriented guidelines</h3>
 
-<p>The SDMX standard includes a set of <em>content oriented guidelines</em> (COG) <a href="#ref-cog">[COG]</a>
+<p>The SDMX standard includes a set of <em>content oriented guidelines</em> (COG) [[COG]]
  which define a
    set of common statistical concepts and associated code lists that are intended to be 
    reusable across data sets. As part of the data cube work we have created RDF analogues
@@ -631,7 +633,7 @@
 
 <p><b>Region.</b> Again there is a suitable COG concept and associated component that
 we can use for this, and again we can customize the range of the component. In this case
-  we can use the Ordanance Survey administrative geography ontology <a href="#ref-admingeo">[OS-GEO]</a>.</p>
+  we can use the Ordanance Survey administrative geography ontology [[OS-GEO]].</p>
 
 <pre>
   eg:refArea  a rdf:Property, qb:DimensionProperty;
@@ -1285,7 +1287,7 @@
 <p>The organization that publishes a dataset should be recorded as part of the dataset metadata.
 Again we recommend use of the Dublin Core term <code>dcterms:publisher</code> for this.
 The organization should be represented as an instance of <code>foaf:Agent</code>, or
-some more specific subclass such as <code>org:Organization</code> <a href="#ref-org">[ORG]</a>.</p>
+some more specific subclass such as <code>org:Organization</code> [[ORG]].</p>
 
 <pre>
 eg:dataset1 a qb:DataSet;
@@ -1733,33 +1735,8 @@
 
 
 <section id="references">
-<dl>
-  <dt id="ref-OLAP">[OLAP]</dt>
-  <dd>Online Analytical Processing Data Cubes, <a href="http://en.wikipedia.org/wiki/OLAP_cube">http://en.wikipedia.org/wiki/OLAP_cube</a></dd>
-
-  <dt id="ref-linked-data">[LOD]</dt>
-  <dd>Linked Data, <a href="http://linkeddata.org/">http://linkeddata.org/</a></dd>
-
-  <dt id="ref-scovo">[SCOVO]</dt>
-  <dd>The Statistical Core Vocabulary, <a href="http://sw.joanneum.at/scovo/schema.html">http://sw.joanneum.at/scovo/schema.html</a> <br />
-       SCOVO: Using Statistics on the Web of data, <a href="http://sw-app.org/pub/eswc09-inuse-scovo.pdf">http://sw-app.org/pub/eswc09-inuse-scovo.pdf</a>
-</dd>
-
-  <dt id="ref-skos">[SKOS]</dt>
-  <dd>Simple Knowledge Organization System, <a href="http://www.w3.org/2004/02/skos/">http://www.w3.org/2004/02/skos/</a></dd>
-
-  <dt id="ref-cog">[COG]</dt>
-  <dd>SDMX Contnent Oriented Guidelines, <a href="http://sdmx.org/?page_id=11">http://sdmx.org/?page_id=11</a></dd>
-
-  <dt id="ref-admingeo">[OS-GEO]</dt>
-  <dd>Ordnance Survey Administrative Geography Ontology v1, <a href="http://www.ordnancesurvey.co.uk/ontology/v1/AdministrativeGeography.rdf">http://www.ordnancesurvey.co.uk/ontology/v1/AdministrativeGeography.rdf</a></dd>
-
-  <dt id="ref-org">[ORG]</dt>
-  <dd>An Organization Ontology, <a href="http://www.epimorphics.com/public/vocabulary/org.html">http://www.epimorphics.com/public/vocabulary/org.html</a></dd>
-
-</dl>
+<p class="todo">Bring all references into W3C style</p>
 </section>
 
-
 </body>
 </html>
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/respec/biblio.html	Fri Feb 10 20:10:04 2012 +0000
@@ -0,0 +1,94 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>ReSpec.js — The Biblio DB</title>
+    <meta http-equiv='Content-Type' content='text/html;charset=utf-8'/>
+    <script src='ReSpec.js/js/respec.js' class='remove'></script>
+    <script src='gld-bib.js' class='remove'></script>
+    <script class='remove'>
+      // var bibdump;
+      var respecConfig = {
+          // document info
+          specStatus:           "ED",
+          shortName:            "respec-js-bib",
+          // publishDate:   "2009-08-06",
+          // previousPublishDate:  "2009-03-15",
+          edDraftURI:           "http://dev.w3.org/2009/dap/ReSpec.js/biblio.html",
+          // lcEnd:  "2010-08-06",
+          // extraCSS:             ["http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css"],
+          extraCSS:             [],
+
+          // editors
+          editors:  [
+              { name: "Robin Berjon", url: "http://berjon.com/",
+                company: "Robineko", companyURL: "http://robineko.com/" },
+          ],
+          
+          // WG
+          wg:           "People Who Like To Write Specs Help Group",
+          wgURI:        "http://berjon.com/",
+          wgPublicList: "spec-writers-anonymous",
+          wgPatentURI:  "",
+
+          // XXX
+          // This is the "correct" way of doing it, but it's dead slow
+          // preProcess:  [function () {
+          //     var sec = document.getElementById("biblio");
+          //     var tc = "";
+          //     for (var bib in berjon.biblio) tc += "[[!" + bib + "]]\n";
+          //     document.getElementById("biblio").textContent = tc;
+          //     var sn = new berjon.simpleNode();
+          //     bibdump = sn.element("section", {}, document.body, [sn.element("h2", {}, null, "Biblio")]);
+          // }],
+          // 
+          // postProcess:  [function () {
+          //     var sec = document.getElementById("biblio");
+          //     sec.parentNode.removeChild(sec);
+          //     var sn = new berjon.simpleNode();
+          //     var nr = document.getElementById("normative-references");
+          //     nr.removeChild(nr.firstElementChild);
+          //     sn.copyChildren(nr, bibdump);
+          //     document.body.removeChild(document.getElementById("references"));
+          //     document.body.removeChild(document.getElementById("toc"));
+          // }],
+          // Follows a cheaper approach, that may require updating if we change the ReSpec code
+          preProcess:  [function () {
+              var sn = new berjon.simpleNode({
+                  "":     "http://www.w3.org/1999/xhtml",
+                  "x":    "http://www.w3.org/1999/xhtml"
+              }, document);
+              var tmp = berjon.biblio;
+              berjon.biblio = {};
+              addGLDBiblio();
+              var bibdump = sn.element("div", { "class": "section" }, document.body, [sn.element("h2", {}, null, "GLD Bibliography")]);
+              var dl = sn.element("dl", {}, bibdump);
+              for (var bib in berjon.biblio) {
+                  sn.element("dt", {}, dl, "[" + bib + "]");
+                  var dd = sn.element("dd", {}, dl);
+                  dd.innerHTML = berjon.biblio[bib];
+              }
+              berjon.biblio = tmp;
+              var bibdump = sn.element("div", { "class": "section" }, document.body, [sn.element("h2", {}, null, "ReSpec.js Bibliography")]);
+              var dl = sn.element("dl", {}, bibdump);
+              for (var bib in berjon.biblio) {
+                  sn.element("dt", {}, dl, "[" + bib + "]");
+                  var dd = sn.element("dd", {}, dl);
+                  dd.innerHTML = berjon.biblio[bib];
+              }
+          }],
+          
+          postProcess:  [function () {
+              document.body.removeChild(document.getElementById("references"));
+              document.body.removeChild(document.getElementById("toc"));
+              document.body.removeChild(document.getElementById("sotd"));
+          }],
+      };
+    </script>
+  </head>
+  <body>
+    <section id='abstract'>
+      This is a dump of the biblio database for ReSpec.js, including additions made for the Government Linked Data (GLD) WG.
+    </section>
+    
+  </body>
+</html>
--- a/respec/gld-bib.js	Fri Feb 10 19:40:03 2012 +0000
+++ b/respec/gld-bib.js	Fri Feb 10 20:10:04 2012 +0000
@@ -1,3 +1,11 @@
-addGLDBiblio = {apply: function() {
-    berjon.biblio['TURTLE-TR'] = "Eric Prud'hommeaux, Gavin Carothers. <a href=\"http://www.w3.org/TR/2011/WD-turtle-20110809/\"><cite>Turtle: Terse RDF Triple Language.</cite></a> 09 August 2011. W3C Working Draft. URL: <a href=\"http://www.w3.org/TR/2011/WD-turtle-20110809/\">http://www.w3.org/TR/2011/WD-turtle-20110809/</a>";
-}};
+var GLD_bib = {
+    "TURTLE-TR": "Eric Prud'hommeaux, Gavin Carothers. <a href=\"http://www.w3.org/TR/2011/WD-turtle-20110809/\"><cite>Turtle: Terse RDF Triple Language.</cite></a> 09 August 2011. W3C Working Draft. URL: <a href=\"http://www.w3.org/TR/2011/WD-turtle-20110809/\">http://www.w3.org/TR/2011/WD-turtle-20110809/</a>",
+    "OLAP": "Online Analytical Processing Data Cubes, <a href=\"http://en.wikipedia.org/wiki/OLAP_cube\">http://en.wikipedia.org/wiki/OLAP_cube</a>",
+    "LOD": "Linked Data, <a href=\"http://linkeddata.org/\">http://linkeddata.org/</a>",
+    "SCOVO": "The Statistical Core Vocabulary, <a href=\"http://sw.joanneum.at/scovo/schema.html\">http://sw.joanneum.at/scovo/schema.html</a><br />SCOVO: Using Statistics on the Web of data, <a href=\"http://sw-app.org/pub/eswc09-inuse-scovo.pdf\">http://sw-app.org/pub/eswc09-inuse-scovo.pdf</a>",
+    "COG": "SDMX Contnent Oriented Guidelines, <a href=\"http://sdmx.org/?page_id=11\">http://sdmx.org/?page_id=11</a>",
+    "OS-GEO": "Ordnance Survey Administrative Geography Ontology v1, <a href=\"http://www.ordnancesurvey.co.uk/ontology/v1/AdministrativeGeography.rdf\">http://www.ordnancesurvey.co.uk/ontology/v1/AdministrativeGeography.rdf</a>",
+    "ORG": "An Organization Ontology, <a href=\"http://www.epimorphics.com/public/vocabulary/org.html\">http://www.epimorphics.com/public/vocabulary/org.html</a>",
+}
+
+addGLDBiblio = function() { for (var i in GLD_bib) berjon.biblio[i] = GLD_bib[i]; };