Author: alexdma
Date: Mon Oct 10 16:54:17 2011
New Revision: 1181067
URL: http://svn.apache.org/viewvc?rev=1181067&view=rev
Log:
- Added missing Apache committer IDs
- Added early Rules documentation
Added:
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules.mdtext
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/language.mdtext
Modified:
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/index.mdtext
incubator/stanbol/site/trunk/content/stanbol/team.mdtext
Modified: incubator/stanbol/site/trunk/content/stanbol/docs/trunk/index.mdtext
URL:
http://svn.apache.org/viewvc/incubator/stanbol/site/trunk/content/stanbol/docs/trunk/index.mdtext?rev=1181067&r1=1181066&r2=1181067&view=diff
==============================================================================
--- incubator/stanbol/site/trunk/content/stanbol/docs/trunk/index.mdtext
(original)
+++ incubator/stanbol/site/trunk/content/stanbol/docs/trunk/index.mdtext Mon
Oct 10 16:54:17 2011
@@ -86,7 +86,7 @@ A detailed technical documentation of it
* Ontology Manager
* Reasoners
* Reengineer
-* Rules
+* [Rules] (rules.html)
* FactStore
* Benchmark
@@ -102,6 +102,6 @@ A detailed technical documentation of it
[stan-admin]: http://localhost:8080/system/console/
[stan-engines]: http://localhost:8080/engines
[stan-contenthub]: http://localhost:8080/contenthub
-
+[stan-rules]: http://localhost:8080/rules
Added: incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules.mdtext
URL:
http://svn.apache.org/viewvc/incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules.mdtext?rev=1181067&view=auto
==============================================================================
--- incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules.mdtext (added)
+++ incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules.mdtext Mon
Oct 10 16:54:17 2011
@@ -0,0 +1,31 @@
+Title: Rules
+
+Stanbol Rules is a component that supports the construction and execution of
inference rules. An __inference rule__, or transformation rule, is a syntactic
rule or function which takes premises and returns a conclusion. Stanbol Rules
allows to add a layer for expressing business logics by means of axioms, which
encode the inference rules. These axioms can be organized into a container
called __recipe__, which identifies a set of rules that share the same business
logic and interpret them as a whole.
+
For instance, with Stanbol Rules the administrator can define integrity checks
for data fetched from heterogeneous and external sources in order to prevent
unwanted formats or inconsistent data. Also, Stanbol Rules can be used to
derive new knowledge or integrate information from different semantically
enhanced contents.
+
+## Rule Language
+
+Rules are written in the [Stanbol Rule](rules/language.html) language and can
be interpreted either as SWRL rules (for classical Description Logic reasoning)
or SPARQL CONSTRUCT queries (for RDF querying and transformation).
+
+## Service Endpoints
+
+The Rules RESTful API is structured as follows:
+
+### Rule Manager ("/rules/rule"):
+
+- The Rule Manager @ [/rules/rule](http://localhost:8080/rules/rule) allows to
manage and retrieve inference rules.
+
+### Recipe Manager ("/rules/recipe"):
+
+- The Recipe Manager @ [/rules/rule](http://localhost:8080/rules/rule) allows
to manage, store and retrieve pre-defined rule sequences, or __recipes__.
+
+### Refactorer ("/rules/refactor"):
+
+- The Refactorer @ [/rules/refactor](http://localhost:8080/rules/refactor)
applies a recipe to a supplied RDF graph, in order to return a new graph
containing the output of the recipe execution.
+
+ - [__Refactor__](http://localhost:8080/rules/refactor) refactors the input
RDF graph using a recipe already stored in Stanbol.
+
+ - [__Apply__](http://localhost:8080/rules/refactor/apply) refactors the input
RDF graph using a recipe provided on the fly.
+
+____
+_[Back to index](index.html)_
\ No newline at end of file
Added:
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/language.mdtext
URL:
http://svn.apache.org/viewvc/incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/language.mdtext?rev=1181067&view=auto
==============================================================================
---
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/language.mdtext
(added)
+++
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/language.mdtext
Mon Oct 10 16:54:17 2011
@@ -0,0 +1,52 @@
+Title: Stanbol Rule Language
+
+## Example
+
+The following is a rule for inferring the relation _hasUncle_ between
individuals _x_ and _y_ if _z_ is a parent of _x_ and _z_ is brother of _y_.
+
+In Stanbol Rule syntax it is:
+
+ uncleRule[has(<http://www.foo.org/myont.owl#hasParent>, ?x, ?z) .
+ has(<http://www.foo.org/myont.owl#hasSibling>, ?z, ?y)
+ ->
+ has(<http://www.foo.org/myont.owl#hasUncle>, ?x, ?y)
+ ]
+
+The rule above becomes the following SWRL rule:
+
+ <swrl:Variable rdf:ID="x"/>
+ <swrl:Variable rdf:ID="z"/>
+ <swrl:Variable rdf:ID="y"/>
+ <ruleml:Imp>
+ <ruleml:body rdf:parseType="Collection">
+ <swrl:IndividualPropertyAtom>
+ <swrl:propertyPredicate rdf:resource="⪚hasParent"/>
+ <swrl:argument1 rdf:resource="#x" />
+ <swrl:argument2 rdf:resource="#z" />
+ </swrl:IndividualPropertyAtom>
+ <swrl:IndividualPropertyAtom>
+ <swrl:propertyPredicate rdf:resource="⪚hasSibling"/>
+ <swrl:argument1 rdf:resource="#z" />
+ <swrl:argument2 rdf:resource="#y" />
+ </swrl:IndividualPropertyAtom>
+ </ruleml:body>
+ <ruleml:head rdf:parseType="Collection">
+ <swrl:IndividualPropertyAtom>
+ <swrl:propertyPredicate rdf:resource="⪚hasUncle"/>
+ <swrl:argument1 rdf:resource="#x" />
+ <swrl:argument2 rdf:resource="#y" />
+ </swrl:IndividualPropertyAtom>
+ </ruleml:head>
+ </ruleml:Imp>
+
+
+or the following SPARQL query:
+
+ PREFIX myont: <http://www.foo.org/myont.owl#>
+
+ CONSTRUCT { ?x myont:hasUncle} ?y }
+ WHERE { ?x myont:hasParent ?z .
+ ?z myont:hasSibling ?y}
+
+____
+_[Back to Rules](rules.html)_
\ No newline at end of file
Modified: incubator/stanbol/site/trunk/content/stanbol/team.mdtext
URL:
http://svn.apache.org/viewvc/incubator/stanbol/site/trunk/content/stanbol/team.mdtext?rev=1181067&r1=1181066&r2=1181067&view=diff
==============================================================================
--- incubator/stanbol/site/trunk/content/stanbol/team.mdtext (original)
+++ incubator/stanbol/site/trunk/content/stanbol/team.mdtext Mon Oct 10
16:54:17 2011
@@ -2,16 +2,16 @@ Title: Apache Stanbol project team
The Stanbol team currently consists of (in alphabetical order):
-* Alessandro Adamou (C-P)
-* Andrea Nuzzolese (C-P)
+* Alessandro Adamou (alexdma) (C-P)
+* Andrea Nuzzolese (anuzzolese) (C-P)
* Andreas Filler (filler) (C-P)
* Andreas Gruber (agruber) (C-P)
* Andreas Kuckartz (aku) (C-P)
* Ard Schrijvers (ard) (C-P)
* Benjamin Nagel (bnagel) (C-P)
* Bertrand Delacretaz (bdelacretaz) (C-P and champion)
-* Cihan Cimen (C-P)
-* Concetto Bonafede (C-P)
+* Cihan Cimen (cihan) (C-P)
+* Concetto Bonafede (concelvio) (C-P)
* Enrico Daga (enridaga) (C-P)
* Fabian Christ (fchrist) (C-P)
* Florent André (florent) (C-P)
@@ -24,7 +24,7 @@ The Stanbol team currently consists of (
* Ross Gardler (rgardler) (M)
* Rupert Westenthaler (rwesten) (C-P)
* Stefane Fermigier (sfermigier) (C-P)
-* Suat Gonul (C-P)
+* Suat Gonul (suat) (C-P)
* Szaby Grünwald (szabyg) (C-P)
* Ted Dunning (tdunning) (M)
* Tommaso Teofili (tommaso) (C-P-M)
