commonsrdf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From wik...@apache.org
Subject svn commit: r948898 - /websites/production/commonsrdf/content/index.html
Date Thu, 23 Apr 2015 15:14:26 GMT
Author: wikier
Date: Thu Apr 23 15:14:25 2015
New Revision: 948898

Log:
Site checkin for project Commons RDF

Modified:
    websites/production/commonsrdf/content/index.html

Modified: websites/production/commonsrdf/content/index.html
==============================================================================
--- websites/production/commonsrdf/content/index.html (original)
+++ websites/production/commonsrdf/content/index.html Thu Apr 23 15:14:25 2015
@@ -229,10 +229,50 @@
   </p>
 </div>
 <p>Commons RDF aims to provide a common library for <a class="externalLink" href="http://www.w3.org/TR/rdf11-concepts/">RDF
1.1</a> that could be implemented by systems on the Java Virtual Machine.</p>
+
+<div style="float: right; margin-left: 6em; margin-right: 2em;">
+    <a href="images/class-diagram.png">
+        <img src="images/class-diagram.png" alt="Class diagram" style="height: 48em" />
+    </a>
+</div>
 <p>The main motivation behind this simple library is revise an historical incompatibility
issue. This library does not pretend to be a generic api wrapping those libraries, but a set
of interfaces for the RDF 1.1 concepts that can be used to expose common RDF-1.1 concepts
using common Java interfaces. In the initial phase commons-rdf is focused on a subset of the
core concepts defined by RDF-1.1 (URI/IRI, Blank Node, Literal, Triple, and Graph). In particular,
commons RDF aims to provide a type-safe, non-general API that covers RDF 1.1. In a future
phase we may define interfaces for Datasets and Quads.</p>
-<p>A draft diagram of the interfaces which may be included in Commons RDF are:</p>
-<p><a href="images/class-diagram.png"><img src="images/class-diagram.png"
alt="Class diagram" style="height: 35em" /></a></p>
-<p>This library is still <b>work in progress</b>. Therefore everybody is
welcomed to <a href="mail-lists.html">join the project</a> and contribute!</p>
+<div class="section">
+<h2><a name="API"></a>API</h2>
+<p>The <a href="images/class-diagram.png">class diagram</a> on the right
depicts the main <a href="apidocs/index.html?org/apache/commons/rdf/api/package-summary.html">interfaces</a>
which may be included in Commons RDF, specifically:</p>
+
+<ul>
+  
+<li><a href="apidocs/index.html?org/apache/commons/rdf/api/Graph.html">Graph</a>:
a graph,  a set of RDF triples.</li>
+  
+<li><a href="apidocs/index.html?org/apache/commons/rdf/api/Triple.html">Triple</a>:
a  <tt>(subject, predicate, object)</tt> RDF triple.</li>
+  
+<li><a href="apidocs/index.html?org/apache/commons/rdf/api/RDFTerm.html">RDFTerm</a>:
a RDF 1.1  Term, where IRIs, literals and blank nodess are collectively known as RDF terms.</li>
+  
+<li><a href="apidocs/index.html?org/apache/commons/rdf/api/IRI.html">IRI</a>:
an  Internationalized Resource Identifier.</li>
+  
+<li><a href="apidocs/index.html?org/apache/commons/rdf/api/BlankNode.html">BlankNode</a>:
a  RDF-1.1 Blank Node, where they are disjoint from IRIs and literals.</li>
+  
+<li><a href="apidocs/index.html?org/apache/commons/rdf/api/BlankNodeOrIRI.html">BlankNodeOrIRI</a>:
 this interface represents the RDF Terms that may be used in the subject position  of an RDF
1.1 <tt>Triple</tt>, including <tt>BlankNode</tt> and <tt>IRI</tt>.</li>
+  
+<li><a href="apidocs/index.html?org/apache/commons/rdf/api/Literal.html">Literal</a>:
a RDF-1.1 literal.</li>
+  
+<li><a href="apidocs/index.html?org/apache/commons/rdf/api/RDFTermFactory.html">RDFTermFactory</a>:
 factory for creating <tt>RDFTerm</tt> and <tt>Graph</tt> instances.</li>
+</ul>
+<p>The design of the <a href="apidocs/index.html?org/apache/commons/rdf/api/package-summary.html">API</a>
follows the terminology as defined by <a class="externalLink" href="http://www.w3.org/TR/rdf11-concepts/">RDF
1.1 Concepts and Abstract Syntax</a>, a W3C Recommendation published on 25 February
2014. The idea is that Commons RDF will provide a common library for RDF 1.1 that could be
implemented by systems on the Java Virtual Machine, allowing the portability across different
implementations.</p></div>
+<div class="section">
+<h2><a name="Modules"></a>Modules</h2>
+<p>The project is actually composed by two modules:</p>
+
+<ul>
+  
+<li><a href="apidocs/index.html?org/apache/commons/rdf/api/package-summary.html">API</a>
defines  a common library of RDF 1.1 concepts.</li>
+  
+<li><a href="apidocs/index.html?org/apache/commons/rdf/simple/package-summary.html">Simple</a>
 provides a simple implementation, mainly for internal validation and very simple  scenarios.</li>
+</ul>
+<p>Following <a class="externalLink" href="http://semver.org/">semantic versioning</a>
both modules follow a common versioning schema, where version <tt>x.y.z</tt> of
<tt>Simple</tt> implements version <tt>x.y</tt> of the <tt>API</tt>;
i.e., the version <tt>z</tt> are backwards-compatible patches of the implementation.</p></div>
+<div class="section">
+<h2><a name="Contributing"></a>Contributing</h2>
+<p>Please, take into account that this library is still <b>work in progress</b>,
this set of interfaces are still under discussion and evolution. Therefore everybody is welcomed
to <a href="mail-lists.html">join the project</a> and <a href="contributing.html">contribute</a>!</p></div>
 <div class="section">
 <h2><a name="Disclaimer"></a>Disclaimer</h2>
 <p>Apache Commons RDF is an effort undergoing incubation at <a class="externalLink"
href="http://apache.org/">The Apache Software Foundation (ASF)</a> sponsored by the
<a class="externalLink" href="http://incubator.apache.org/">Apache Incubator PMC</a>.
Incubation is required of all newly accepted projects until a further review indicates that
the infrastructure, communications, and decision making process have stabilized in a manner
consistent with other successful ASF projects. While incubation status is not necessarily
a reflection of the completeness or stability of the code, it does indicate that the project
has yet to be fully endorsed by the ASF.</p></div>



Mime
View raw message