glossary
authorLuc Moreau <l.moreau@ecs.soton.ac.uk>
Mon, 20 Feb 2012 12:20:46 +0000
changeset 1614 30b5f248a3c3
parent 1613 e4fd2ac1a464
child 1615 5549c0fb1393
glossary
model/working-copy/Makefile
model/working-copy/glossary.html
model/working-copy/glossary.js
model/working-copy/prov-glossary.html
--- a/model/working-copy/Makefile	Mon Feb 20 11:34:36 2012 +0000
+++ b/model/working-copy/Makefile	Mon Feb 20 12:20:46 2012 +0000
@@ -3,11 +3,11 @@
 HGID=`hg parents --template='{node|short}'`
 
 make.glossary.js: glossary.html Makefile
-	$(MAKE) hgid > glossary.js
-	echo "glossary_html='\\ " >> glossary.js
-	cat glossary.html | awk '{ print $$0 "  \\" }' >> glossary.js
-	echo "'" >> glossary.js
+	@$(MAKE) hgid
+	@echo "glossary_string= " >> glossary.js
+	cat glossary.html | awk '{ print "'\''"  $$0 " '\'' + " }' >> glossary.js
+	echo "' ' ;" >> glossary.js
 
 hgid:
-	echo "glossary_hg='http://dvcs.w3.org/hg/prov/file/$(HGID)/model/working-copy/glossary.html';"
+	@echo "glossary_hg='http://dvcs.w3.org/hg/prov/file/$(HGID)/model/working-copy/glossary.html';"  > glossary.js
 
--- a/model/working-copy/glossary.html	Mon Feb 20 11:34:36 2012 +0000
+++ b/model/working-copy/glossary.html	Mon Feb 20 12:20:46 2012 +0000
@@ -8,6 +8,47 @@
  otherwise; the world may be real or imaginary.  
 </div>  
 
+<span class="glossary" id="glossary-activty">  
+An <dfn id="concept-activity">Activity</dfn> is anything that can operate on entities. In particular, activities may produce, consume, or transform an entity. Activities that operate on digital entities may for example move, copy, or duplicate them.
+</span>
+
+<span class="glossary" id="glossary-agent">  
+An <dfn id="concept-agent">agent</dfn> is a type of entity that can be associated to an activity, to indicate that it bears some form of responsibility for the activity taking
+place.
+</span>
+
+<span class="glossary" id="glossary-generation">  
+<dfn id="concept-generation">Generation</dfn> is the completed production of a new entity by activity.
+ This entity become available for usage after this generation. This entity did not exist before generation.
+</span>
+
+<span class="glossary" id="glossary-usage">  
+<dfn id="concept-usage">Usage</dfn> is the beginning on  an entity being consumed by an activity.
+Before usage, the activity had not begun to consume or use to this entity (and could not have been affected by the entity).
+</span>
+
+<span class="glossary" id="glossary-derivation">  
+<dfn id="concept-derivation">Derivation</dfn> is the fact that some entity is transformed from, created from, or affected by another entity in the world.  
+</span>
+
+<span class="glossary" id="glossary-plan">  
+A <dfn id="concept-plan">plan</dfn> is an entity that represent a set of
+actions or steps intended by one or more agents to achieve some goals. 
+</span>
+
+<span class="glossary" id="glossary-collection">  
+A <dfn id="concept-collection">collection</dfn> is an entity that has internal structure. PROV-DM defines provenance constructs for a very general type of collection, namely a set of key-value pairs (referred to as a <em>map</em> or, in some programming languages, a <em>dictionary</em> or <em>associative array</em>). 
+</span>
+
+<span class="glossary" id="glossary-accountEntity">  
+A <dfn id="concept-accountEntity">accountentity</dfn> is an entity that is contains a bundle of provenance assertions. 
+</span>
+
+<span class="glossary" id="glossary-provenance">  
+<dfn>Provenance</dfn> is  a record that describes the people,
+institutions, entities, and activities, involved in producing,
+influencing, or delivering a piece of data or a thing in the world.
+</span>
 
 </html>
 
--- a/model/working-copy/glossary.js	Mon Feb 20 11:34:36 2012 +0000
+++ b/model/working-copy/glossary.js	Mon Feb 20 12:20:46 2012 +0000
@@ -1,19 +1,60 @@
-glossary_hg='http://dvcs.w3.org/hg/prov/file/eb9d5a320b5c/model/working-copy/glossary.html';
-glossary_string='\ 
-  \
-<html>  \
-  \
-<div class="glossary" id="glossary-entity">    \
-<dfn title="concept-entity">Entities</dfn> are things in the world one    \
- wants to provide provenance for.  For the purpose of this    \
- specification, things can be physical, digital, conceptual, or    \
- otherwise; the world may be real or imaginary.    \
-</div>    \
-  \
-  \
-</html>  \
-  \
-  \
-  \
-  \
-';
+glossary_hg='http://dvcs.w3.org/hg/prov/file/e4fd2ac1a464/model/working-copy/glossary.html';
+glossary_string= 
+' ' + 
+'<html> ' + 
+' ' + 
+'<div class="glossary" id="glossary-entity">   ' + 
+'<dfn title="concept-entity">Entities</dfn> are things in the world one   ' + 
+' wants to provide provenance for.  For the purpose of this   ' + 
+' specification, things can be physical, digital, conceptual, or   ' + 
+' otherwise; the world may be real or imaginary.   ' + 
+'</div>   ' + 
+' ' + 
+'<span class="glossary" id="glossary-activty">   ' + 
+'An <dfn id="concept-activity">Activity</dfn> is anything that can operate on entities. In particular, activities may produce, consume, or transform an entity. Activities that operate on digital entities may for example move, copy, or duplicate them. ' + 
+'</span> ' + 
+' ' + 
+'<span class="glossary" id="glossary-agent">   ' + 
+'An <dfn id="concept-agent">agent</dfn> is a type of entity that can be associated to an activity, to indicate that it bears some form of responsibility for the activity taking ' + 
+'place. ' + 
+'</span> ' + 
+' ' + 
+'<span class="glossary" id="glossary-generation">   ' + 
+'<dfn id="concept-generation">Generation</dfn> is the completed production of a new entity by activity. ' + 
+' This entity become available for usage after this generation. This entity did not exist before generation. ' + 
+'</span> ' + 
+' ' + 
+'<span class="glossary" id="glossary-usage">   ' + 
+'<dfn id="concept-usage">Usage</dfn> is the beginning on  an entity being consumed by an activity. ' + 
+'Before usage, the activity had not begun to consume or use to this entity (and could not have been affected by the entity). ' + 
+'</span> ' + 
+' ' + 
+'<span class="glossary" id="glossary-derivation">   ' + 
+'<dfn id="concept-derivation">Derivation</dfn> is the fact that some entity is transformed from, created from, or affected by another entity in the world.   ' + 
+'</span> ' + 
+' ' + 
+'<span class="glossary" id="glossary-plan">   ' + 
+'A <dfn id="concept-plan">Plan</dfn> is an entity that represent a set of ' + 
+'actions or steps intended by one or more agents to achieve some goals.  ' + 
+'</span> ' + 
+' ' + 
+'<span class="glossary" id="glossary-collection">   ' + 
+'A <dfn id="concept-collection">Collection</dfn> is an entity that has internal structure. PROV-DM defines provenance constructs for a very general type of collection, namely a set of key-value pairs (referred to as a <em>map</em> or, in some programming languages, a <em>dictionary</em> or <em>associative array</em>).  ' + 
+'</span> ' + 
+' ' + 
+'<span class="glossary" id="glossary-accountEntity">   ' + 
+'A <dfn id="concept-accountEntity">AccountEntity</dfn> is an entity that is contains a bundle of provenance assertions.  ' + 
+'</span> ' + 
+' ' + 
+'<span class="glossary" id="glossary-provenance">   ' + 
+'<dfn>Provenance</dfn> is  a record that describes the people, ' + 
+'institutions, entities, and activities, involved in producing, ' + 
+'influencing, or delivering a piece of data or a thing in the world. ' + 
+'</span> ' + 
+' ' + 
+'</html> ' + 
+' ' + 
+' ' + 
+' ' + 
+' ' + 
+' ' ;
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/model/working-copy/prov-glossary.html	Mon Feb 20 12:20:46 2012 +0000
@@ -0,0 +1,223 @@
+<!DOCTYPE html>
+
+<html><head> 
+    <title>The Provenance Glossary</title> 
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 
+    <!-- 
+      === NOTA BENE ===
+      For the three scripts below, if your spec resides on dev.w3 you can check them
+      out in the same tree and use relative links so that they'll work offline,
+     -->
+<!-- PM -->
+    <style type="text/css">
+      .note { font-size:small; margin-left:50px }
+     </style>
+
+    <script src="http://dev.w3.org/2009/dap/ReSpec.js/js/respec.js" class="remove"></script> 
+    <script src="http://www.w3.org/2007/OWL/toggles.js" class="remove"></script> 
+    <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js" class="remove"></script>
+    <script src="glossary.js" class="remove"></script>
+    <script class="remove">
+      function updateGlossaryRefs() {
+        $('.glossary-ref').each(function(index) {
+          var ref=$(this).attr('ref');
+          // look up directly in the_glossary
+          //$(this).html(the_glossary[ref]);
+          // if glossary is in a string:
+          $('#'+ref+'.glossary').contents().clone().appendTo($(this));
+          $(this).attr('prov:hadOriginalSource',glossary_hg);
+          $(this).children('dfn').replaceWith(function(){return $('<span>').addClass('dfn').append($(this).contents())});
+        });
+     }
+      $(document).ready(function(){
+        // if glossary is in a string:
+        $('#glossary_div').html(glossary_string)
+        updateGlossaryRefs();
+      });
+
+    </script> 
+    <script class="remove"> 
+      var addExtraReferences = function() {
+          for (var k in extraReferences)
+              berjon.biblio[k] = extraReferences[k];
+      };
+      var extraReferences = {
+        "CLOCK":
+         "Lamport, L. "+
+         "<a href=\"http://research.microsoft.com/users/lamport/pubs/time-clocks.pdf\"><cite>Time, clocks, and the ordering of events in a distributed system</cite></a>."+
+         "Communications of the ACM 21 (7): 558–565. 1978. "+
+         "URL: <a href=\"http://research.microsoft.com/users/lamport/pubs/time-clocks.pdf\">http://research.microsoft.com/users/lamport/pubs/time-clocks.pdf</a> " +
+         "DOI: doi:10.1145/359545.359563.",
+        "CSP":
+         "Hoare, C. A. R. "+
+         "<a href=\"http://www.usingcsp.com/cspbook.pdf\"><cite>Communicating Sequential Processes</cite></a>."+
+         "Prentice-Hall. 1985"+
+         "URL: <a href=\"http://www.usingcsp.com/cspbook.pdf\">http://www.usingcsp.com/cspbook.pdf</a>",
+        "Logic":
+          "W. E. Johnson"+
+          "<a href=\"http://www.ditext.com/johnson/intro-3.html\"><cite>Logic: Part III</cite></a>."+
+          "1924. "+
+          "URL: <a href=\"http://www.ditext.com/johnson/intro-3.html\">http://www.ditext.com/johnson/intro-3.html</a>",
+        "PROV-SEM":
+          "James Cheney "+
+          "<a href=\"http://www.w3.org/2011/prov/wiki/FormalSemanticsStrawman\"><cite>Formal Semantics Strawman</cite></a>. "+
+          "2011, Work in progress. "+
+          "URL: <a href=\"http://www.w3.org/2011/prov/wiki/FormalSemanticsStrawman\">http://www.w3.org/2011/prov/wiki/FormalSemanticsStrawman</a>",
+
+        "PROV-PRIMER":
+          "Yolanda Gil and Simon Miles (eds.) Khalid Belhajjame, Helena Deus, Daniel Garijo, Graham Klyne, Paolo Missier, Stian Soiland-Reyes, and Stephan Zednik "+
+          "<a href=\"http://www.w3.org/TR/prov-primer/\"><cite>Prov Model Primer</cite></a>. "+
+          "2011, Working Draft. "+
+          "URL: <a href=\"http://www.w3.org/TR/prov-primer/\">http://www.w3.org/TR/prov-primer/</a>",
+
+        "PROV-O":
+          "Satya Sahoo and Deborah McGuinness (eds.) Khalid Belhajjame, James Cheney, Daniel Garijo, Timothy Lebo, Stian Soiland-Reyes, and Stephan Zednik "+
+          "<a href=\"http://www.w3.org/TR/prov-o/\"><cite>Provenance Formal Model</cite></a>. "+
+          "2011, Working Draft. "+
+          "URL: <a href=\"http://www.w3.org/TR/prov-o/\">http://www.w3.org/TR/prov-o/</a>",
+
+
+        "PROV-DM":
+          "Luc Moreau and Paolo Missier (eds.) ... "+
+          "<a href=\"http://www.w3.org/TR/prov-dm/\"><cite>PART 1: PROV-DM ...</cite></a>. "+
+          "2011, Working Draft. "+
+          "URL: <a href=\"http://www.w3.org/TR/prov-dm/\">http://www.w3.org/TR/prov-dm/</a>",
+
+
+        "PROV-DM-CONSTRAINTS":
+          "Luc Moreau and Paolo Missier (eds.) ... "+
+          "<a href=\"http://www.w3.org/TR/prov-dm-constraints/\"><cite>PROV-DM Constraints</cite></a>. "+
+          "2011, Working Draft. "+
+          "URL: <a href=\"http://www.w3.org/TR/prov-dm-constraints/\">http://www.w3.org/TR/prov-dm-constraints/</a>",
+
+        "PROV-ASN":
+          "Luc Moreau and Paolo Missier (eds.) ... "+
+          "<a href=\"http://www.w3.org/TR/prov-asn/\"><cite>PROV-ASN ....</cite></a>. "+
+          "2011, Working Draft. "+
+          "URL: <a href=\"http://www.w3.org/TR/prov-asn/\">http://www.w3.org/TR/prov-asn/</a>",
+
+        "PROV-AQ":
+          "Graham Klyne and Paul Groth (eds.) Luc Moreau, Olaf Hartig, Yogesh Simmhan, James Meyers, Timothy Lebo, Khalid Belhajjame, and Simon Miles "+
+          "<a href=\"http://www.w3.org/TR/prov-aq/\"><cite>Provenance Access and Query</cite></a>. "+
+          "2011, Working Draft. "+
+          "URL: <a href=\"http://www.w3.org/TR/prov-aq/\">http://www.w3.org/TR/prov-aq/</a>",
+      };
+      var respecConfig = {
+          // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
+          specStatus:           "ED",
+          
+          // the specification's short name, as in http://www.w3.org/TR/short-name/
+          shortName:            "prov-glossary",
+ 
+          // if your specification has a subtitle that goes below the main
+          // formal title, define it here
+          //subtitle   :  "Some speculative write-ups, for discussion before integration in the data model",
+ 
+          // if you wish the publication date to be other than today, set this
+          // publishDate:  "2011-10-18",
+ 
+          // if the specification's copyright date is a range of years, specify
+          // the start date here:
+          // copyrightStart: "2005"
+ 
+          // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
+          // and its maturity status
+          //previousPublishDate:  "2011-12-15",
+          //previousMaturity:  "WD",
+ 
+          // if there a publicly available Editor's Draft, this is the link
+          edDraftURI:           "http://dvcs.w3.org/hg/prov/raw-file/default/model/working-copy/prov-glossary.html",
+ 
+          // if this is a LCWD, uncomment and set the end of its review period
+          // lcEnd: "2009-08-05",
+ 
+          // if you want to have extra CSS, append them to this list
+          // it is recommended that the respec.css stylesheet be kept
+          extraCSS:             ["http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css", "./extra.css"],
+ 
+          // editors, add as many as you like
+          // only "name" is required
+          editors:  [
+              { name: "Luc Moreau", url: "http://www.ecs.soton.ac.uk/~lavm/",
+                company: "University of Southampton" },
+              { name: "Paolo Missier", url: "http://www.cs.ncl.ac.uk/people/Paolo.Missier",
+                company: "Newcastle University" },
+          ],
+ 
+          // authors, add as many as you like. 
+          // This is optional, uncomment if you have authors as well as editors.
+          // only "name" is required. Same format as editors.
+ 
+          
+          // name of the WG
+          wg:           "Provenance Working Group",
+          
+          // URI of the public WG page
+          wgURI:        "http://www.w3.org/2011/prov/",
+          
+          // name (with the @w3c.org) of the public mailing to which comments are due
+          wgPublicList: "public-prov-wg",
+          
+          // URI of the patent status for this WG, for Rec-track documents
+          // !!!! IMPORTANT !!!!
+          // This is important for Rec-track documents, do not copy a patent URI from a random
+          // document unless you know what you're doing. If in doubt ask your friendly neighbourhood
+          // Team Contact.
+          wgPatentURI:  "http://www.w3.org/2004/01/pp-impl/46974/status",
+
+          // Add extraReferences to bibliography database
+          preProcess: [addExtraReferences],
+      };
+    </script> 
+  </head> 
+  <body xmlns:prov="http://www.w3.org/ns/prov-o/"> 
+
+    <section id="abstract">
+<p>
+<b>Editors' working copy can change at any time. </b>
+</p>
+    </section> 
+
+<section id="sotd">
+<b>Editors' working copy can change at any time. </b>
+</section>
+
+
+
+<section id="glossary" > 
+<h2>Glossary</h2>
+
+<div class="glossary-ref" ref="glossary-accountEntity"></div><p></p>
+
+<div class="glossary-ref" ref="glossary-activity"></div><p></p>
+
+<div class="glossary-ref" ref="glossary-agent"></div><p></p>
+
+<div class="glossary-ref" ref="glossary-collection"></div><p></p>
+
+<div class="glossary-ref" ref="glossary-derivation"></div><p></p>
+
+<div class="glossary-ref" ref="glossary-entity"></div><p></p>
+
+<div class="glossary-ref" ref="glossary-generation"></div><p></p>
+
+<div class="glossary-ref" ref="glossary-plan"></div><p></p>
+
+<div class="glossary-ref" ref="glossary-provenance"></div><p></p>
+
+<div class="glossary-ref" ref="glossary-usage"></div><p></p>
+
+</section>
+
+
+
+
+
+
+<div id="glossary_div" class="remove">
+<!-- glossary loaded from gloassary.js will be hooked up here,
+     class remove, will remove this element from the final output.
+-->
+</div>
+
+</body></html>