Update the web site.

Author: knz

feeds/all.atom.xml

@@ -1,2 +1,2 @@
 <?xml version="1.0" encoding="utf-8"?>
-<feed xmlns="http://www.w3.org/2005/Atom"><title>Structured Commons</title><link href="http://www.structured-commons.org/" rel="alternate"></link><link href="http://www.structured-commons.org/feeds/all.atom.xml" rel="self"></link><id>http://www.structured-commons.org/</id><updated>2014-06-16T09:23:33Z</updated></feed>
+<feed xmlns="http://www.w3.org/2005/Atom"><title>Structured Commons</title><link href="http://www.structured-commons.org/" rel="alternate"></link><link href="http://www.structured-commons.org/feeds/all.atom.xml" rel="self"></link><id>http://www.structured-commons.org/</id><updated>2014-06-16T10:18:43Z</updated></feed>

scep0000.html

@@ -62,7 +62,7 @@ <h1><a href="http://www.structured-commons.org">Structured Commons <strong></str
     <tr class="field"><th class="docinfo-name">Status:</th><td class="field-body">Active</td></tr>
     <tr class="field"><th class="docinfo-name">Type:</th><td class="field-body">Informational</td></tr>
     <tr class="field"><th class="docinfo-name">Created:</th><td class="field-body">2014-06-15</td></tr>
-    <tr class="field"><th class="docinfo-name">Source:</th><td class="field-body"><a href="scep0000.rst">scep0000.rst</a> (<tt>fp:jXjB85Usj_icyGx6KgZ0OiMhmxr9-zOu1KnmqmdOMeroIw</tt>)</td></tr>
+    <tr class="field"><th class="docinfo-name">Source:</th><td class="field-body"><a href="scep0000.rst">scep0000.rst</a> (<tt>fp:Kdy5o5H2PEycEWfClUaykSIb9Z9GjdP0P6BwTPsKWy4I7A</tt>)</td></tr>
     </tbody></table>
 
     <div class="section" id="introduction">
@@ -124,6 +124,9 @@ <h3>Draft&nbsp;SCEPs</h3>
 <tr><td><span class="raw-html"><a href="scep0102.html">102</a></span></td>
 <td>Certificates of existence</td>
 </tr>
+<tr><td><span class="raw-html"><a href="scep0103.html">103</a></span></td>
+<td>Standard filesystem representation method</td>
+</tr>
 </tbody>
 </table>
 </div>

scep0000.rst

@@ -45,6 +45,7 @@ Num        Title
 |100|      Structured Commons Model Overview
 |101|      Structured Commons Object Model and Fingerprints
 |102|      Certificates of existence
+|103|      Standard filesystem representation method
 ======     ===================
 
 
@@ -62,3 +63,4 @@ References
 .. |100| replace:: :raw-html:`<a href="scep0100.html">100</a>`
 .. |101| replace:: :raw-html:`<a href="scep0101.html">101</a>`
 .. |102| replace:: :raw-html:`<a href="scep0102.html">102</a>`
+.. |103| replace:: :raw-html:`<a href="scep0103.html">103</a>`

scep0101.html

@@ -62,15 +62,15 @@ <h1><a href="http://www.structured-commons.org">Structured Commons <strong></str
     <tr class="field"><th class="docinfo-name">Status:</th><td class="field-body">Draft</td></tr>
     <tr class="field"><th class="docinfo-name">Type:</th><td class="field-body">Standards Track</td></tr>
     <tr class="field"><th class="docinfo-name">Created:</th><td class="field-body">2014-06-16</td></tr>
-    <tr class="field"><th class="docinfo-name">Source:</th><td class="field-body"><a href="scep0101.rst">scep0101.rst</a> (<tt>fp:EtKaGwLxVg2TNzQh94ckuUAqRZlQPI5LHRxsIknWW1y-VA</tt>)</td></tr>
+    <tr class="field"><th class="docinfo-name">Source:</th><td class="field-body"><a href="scep0101.rst">scep0101.rst</a> (<tt>fp:Py491rKIVazfq54w5IEAYe1I6uNamwgTKn95SEp0oZRXTg</tt>)</td></tr>
     </tbody></table>
 
     <p>This <span class="caps">SCEP</span> describes the lowest level of the Structured
 Commons model and infrastructure: how document
 and digital objects are structured and&nbsp;fingerprinted.</p>
 <div class="section" id="object-model">
 <h2>Object&nbsp;model</h2>
-<p>An Aca2 <em>object</em> is&nbsp;either:</p>
+<p>A Structured Commons <em>object</em> is&nbsp;either:</p>
 <ul class="simple">
 <li>a <em>file</em>, ie. an array of bytes (which may be empty and/or contain <span class="caps">NUL</span> bytes);&nbsp;or</li>
 <li>a <em>dictionary</em> that maps <em>names</em> to either objects (inclusion) or

scep0101.rst

@@ -12,7 +12,7 @@ and digital objects are structured and fingerprinted.
 Object model
 ============
 
-An Aca2 *object* is either:
+A Structured Commons *object* is either:
 
 - a *file*, ie. an array of bytes (which may be empty and/or contain NUL bytes); or
 - a *dictionary* that maps *names* to either objects (inclusion) or

scep0103.html

@@ -0,0 +1,217 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+
+        <title>Structured Commons :: SCEP0103 - Standard filesystem representation&nbsp;method </title>
+        <meta charset="utf-8" />
+        <link href="http://www.structured-commons.org/feeds/all.atom.xml" type="application/atom+xml" rel="alternate" title="Structured Commons Full Atom Feed" />
+
+
+        <!-- Mobile viewport optimized: j.mp/bplateviewport -->
+        <meta name="viewport" content="width=device-width,initial-scale=1, maximum-scale=1">
+
+        <link rel="stylesheet" type="text/css" href="http://www.structured-commons.org/theme/gumby.css" />
+        <link rel="stylesheet" type="text/css" href="http://www.structured-commons.org/theme/style.css" />
+        <link rel="stylesheet" type="text/css" href="http://www.structured-commons.org/theme/pygment.css" />
+
+        <script src="http://www.structured-commons.org/theme/js/libs/modernizr-2.6.2.min.js"></script>
+
+
+
+
+
+
+</head>
+
+<body id="index" class="home">
+
+
+    <div class="container">
+
+        <div class="row">
+
+          <header id="banner" class="body">
+                  <h1><a href="http://www.structured-commons.org">Structured Commons <strong></strong></a></h1>
+          </header><!-- /#banner -->
+
+            <div id="navigation" class="navbar row">
+              <a href="#" gumby-trigger="#navigation &gt; ul" class="toggle"><i class="icon-menu"></i></a>
+
+              <ul class="columns">
+
+                <li><a href="http://www.structured-commons.org/index.html">About</a></li>
+                <li><a href="http://www.structured-commons.org/mission.html">Mission&nbsp;statement</a></li>
+                <li><a href="http://www.structured-commons.org/online-forum.html">Forum</a></li>
+                <li><a href="http://www.structured-commons.org/org.html">Organization</a></li>
+                <li><a href="http://www.structured-commons.org/participating.html">Participating</a></li>
+                <li><a href="http://www.structured-commons.org/scep0000.html">SCEPs</a></li>
+
+              </ul>
+            </div>
+
+
+    <!--<h1>SCEP0103 – SCEP0103 - Standard filesystem representation&nbsp;method</h1>-->
+
+    <table class="docinfo"><col class="docinfo-name" /><col class="docinfo-content" />
+    <tbody valign="top">
+    <tr class="field"><th class="docinfo-name">SCEP:</th><td class="field-body">103</td></tr>
+    <tr class="field"><th class="docinfo-name">Title:</th><td class="field-body">Standard filesystem representation&nbsp;method</td></tr>
+    <tr class="field"><th class="docinfo-name">Version:</th><td class="field-body">e239cae08c2d6f32e7b8628474dc9e113317cdc4</td></tr>
+    <tr class="field"><th class="docinfo-name">Last modified:</th><td class="field-body">2014-06-16 11:18:38  (Mon, 16 June 2014)</td></tr>
+    <tr class="field"><th class="docinfo-name">Author:</th><td class="field-body">Raphael ‘kena’ Poss</td></tr>
+    <tr class="field"><th class="docinfo-name">Status:</th><td class="field-body">Draft</td></tr>
+    <tr class="field"><th class="docinfo-name">Type:</th><td class="field-body">Standards Track</td></tr>
+    <tr class="field"><th class="docinfo-name">Created:</th><td class="field-body">2014-06-16</td></tr>
+    <tr class="field"><th class="docinfo-name">Source:</th><td class="field-body"><a href="scep0103.rst">scep0103.rst</a> (<tt>fp:WF94wYqmlRVeaYl8Q7MtBg7Fduo0AzHiw64yjpE1H8AgQQ</tt>)</td></tr>
+    </tbody></table>
+
+    <p>The Structured Commons object model is defined semantically in <span class="caps">SCEP</span>
+101 [#<span class="caps">SCEP</span>-101], independently from its particular representation in a
+computer system. Conversely, there may exist multiple valid
+representations for an&nbsp;object.</p>
+<p>This <span class="caps">SCEP</span> defines the canonical representation of Structured
+Commons objects in a filesystem, with method name &#8220;<strong>fs</strong>&#8220;.</p>
+<div class="section" id="overview">
+<h2>Overview</h2>
+<p>The <tt class="docutils literal">fs</tt> representation maps objects to a filesystem (eg. on&nbsp;disk).</p>
+<p>Object files are represented by filesystem&nbsp;files.</p>
+<p>Object dictionaries are represented by filesystem&nbsp;directories.</p>
+<p>Names in dictionaries are translated using <span class="caps">UTF</span>-8 <a class="footnote-reference" href="#utf" id="id1">[1]</a> to file/directory
+names, with an optional percent-encoding <a class="footnote-reference" href="#urlq" id="id2">[2]</a>  to support characters
+that are not acceptable in file names on a particular&nbsp;platform.</p>
+<p>For example, the name &#8220;helló / world?&#8221; can be translated
+&#8220;<tt class="docutils literal">hell%C3%B3 %2F world?</tt>&#8221; on a Unix filesystem or
+to &#8220;<tt class="docutils literal">hell%C3%B3%20%2F%20world%3F</tt>&#8221; for a directory served
+over&nbsp;<span class="caps">HTTP</span>.</p>
+<p>Dictionary names that map to objects are represented by directory
+entries that point to either files or&nbsp;directories.</p>
+<p>Dictionary names that map to fingerprints are represented by a regular
+file containing the binary representation of the fingerprint, with a
+filesystem name that prepends &#8220;%00&#8221; to the dictionary name&nbsp;representation.</p>
+<div class="caution">
+<p class="first admonition-title">Caution!</p>
+<p class="last">The names &#8220;.&#8221; and &#8220;..&#8221; are valid dictionary names
+in Structured Commons dictionaries, however they are (usually)
+not valid filesystem entry names. In general,
+names starting with a &#8220;.&#8221; should always be encoded to a
+filesystem name starting with&nbsp;&#8221;%2E&#8221;.</p>
+</div>
+</div>
+<div class="section" id="encoding-algorithm">
+<h2>Encoding&nbsp;algorithm</h2>
+<pre class="literal-block">
+PROCEDURE encode(path, object) BEGIN
+   IF object IS-A FILE-OBJECT THEN
+      SAVE BYTE-DATA(object) TO path
+   ELSE
+      MAKE-DIRECTORY name
+      FOR name IN DICTIONARY-LABELS(object) DO
+         item := DICTIONARY-VALUE(object, name)
+         npath = URL-QUOTE(UTF-8-ENCODE(name))
+         IF item IS-A FINGERPRINT THEN
+            fpath := path + '/%00' + npath
+            SAVE BYTE-DATA(item) TO fpath;
+         ELSE
+            fpath := path + '/' + npath
+            CALL encode(fpath, item)
+         END IF
+      END FOR
+   END IF
+END PROCEDURE
+</pre>
+</div>
+<div class="section" id="decoding-algorithm">
+<h2>Decoding&nbsp;algorithm</h2>
+<pre class="literal-block">
+FUNCTION decode(path) BEGIN
+   IF IS-REGULAR-FILE(path) THEN
+      data := LOAD-BYTES-FROM(path)
+   ELSE
+      data := MAKE-EMPTY-DICTIONARY()
+      FOR fname IN DIRECTORY-LISTING(path) DO
+         IF fname STARTS-WITH &quot;%00&quot; THEN
+            label := UTF-8-DECODE(DROP-FIRST-CHAR(URL-UNQUOTE(fname)))
+            fpdata := FINGERPRINT-VALUE(LOAD-BYTES-FROM(fname))
+            SET data KEY label VALUE fpdata
+         ELSE
+            label := UTF-8-DECODE(URL-UNQUOTE(fname))
+            data := CALL decode(path + '/' + fname)
+            SET data KEY label VALUE data
+         END IF
+      END FOR
+   END IF
+   RETURN data
+END FUNCTION
+</pre>
+</div>
+<div class="section" id="example-reference-implementation">
+<h2>Example/reference&nbsp;implementation</h2>
+<p>Example code in Python is provided&nbsp;separately:</p>
+<p><a class="reference external" href="https://github.com/structured-commons/tools">https://github.com/structured-commons/tools</a></p>
+</div>
+<div class="section" id="references">
+<h2>References</h2>
+<table class="docutils footnote" frame="void" id="utf" rules="none">
+<colgroup><col class="label" /><col /></colgroup>
+<tbody valign="top">
+<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td><span class="caps">RFC</span> 3629. &#8220;<span class="caps">UTF</span>-8, a transformation format of <span class="caps">ISO</span> 10646&#8221;.
+(<a class="reference external" href="https://tools.ietf.org/html/rfc3629">https://tools.ietf.org/html/rfc3629</a>)</td></tr>
+</tbody>
+</table>
+<table class="docutils footnote" frame="void" id="urlq" rules="none">
+<colgroup><col class="label" /><col /></colgroup>
+<tbody valign="top">
+<tr><td class="label"><a class="fn-backref" href="#id2">[2]</a></td><td><span class="caps">RFC</span> 3986, &#8220;Uniform Resource Identifier (<span class="caps">URI</span>): Generic Syntax&#8221;.
+(<a class="reference external" href="https://tools.ietf.org/html/rfc3986">https://tools.ietf.org/html/rfc3986</a>)</td></tr>
+</tbody>
+</table>
+<!-- Local Variables:
+mode: rst
+indent-tabs-mode: nil
+sentence-end-double-space: t
+fill-column: 70
+coding: utf-8
+End: -->
+</div>
+
+
+       </div><!-- /.row -->
+    </div><!-- /.container -->
+
+
+       <div class="container.nopad bg">
+
+
+        <footer id="credits" class="row">
+          <div class="seven columns left-center">
+
+                   <address id="about" class="vcard body">
+                    Proudly powered by <a href="http://getpelican.com/">Pelican</a>,
+                    which takes great advantage of <a href="http://python.org">Python</a>.
+                    <br />
+                    Based on the <a target="_blank" href="http://gumbyframework.com">Gumby Framework</a>
+                    </address>
+          </div>
+
+
+          <div class="seven columns">
+            <div class="row">
+              <ul class="socbtns">
+
+
+
+
+
+              </ul>
+            </div>
+          </div>
+        </footer>
+
+    </div>
+
+
+  <script src="http://www.structured-commons.org/theme/js/libs/jquery-1.9.1.min.js"></script>
+  <script src="http://www.structured-commons.org/theme/js/libs/gumby.min.js"></script>
+  <script src="http://www.structured-commons.org/theme/js/plugins.js"></script>
+</body>
+</html>