Author: fchrist
Date: Wed Jan 11 12:04:25 2012
New Revision: 1229969
URL: http://svn.apache.org/viewvc?rev=1229969&view=rev
Log:
STANBOL-453 Applied refactor patch from Alberto Musetti
Modified:
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/refactor.mdtext
Modified:
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/refactor.mdtext
URL:
http://svn.apache.org/viewvc/incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/refactor.mdtext?rev=1229969&r1=1229968&r2=1229969&view=diff
==============================================================================
---
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/refactor.mdtext
(original)
+++
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/refactor.mdtext
Wed Jan 11 12:04:25 2012
@@ -10,6 +10,28 @@ The Refactor is a service which allows t
## Usage Scenarios
+Supposing we have configured the IKS (i.e. Stanbol EntityHub) in order to
fetch entities about persons from DBpedia. Now we want to represent these
entities adopting the vocabulary from schema.org and produce schemaOrg Rich
Snippets in order to provide to the IKS search engine optimization
capabilities. What we need to do is to write a recipe and calling the Refactor
via HTTP REST passing to it the recipe itself and the entities we have fetched
frol Linked Data.
+
+## Usage
+
+
+### Service Endpoints
+
+
+____
+_[Back to Stanbol Rules](../rules.html)_
+Title: Refactor
+
+The Refactor is a service which allows to interpret rules in order to perform
refactoring of RDF graphs. For the refactoring the set of rules in the recipes
are interpreted and run as SPARQL CONTRUCT in which the where clause is derived
from the body of the rule and the construct clause is derived from the head of
the rule. The output of a refactoring is a transformed graph which satisfies
the constraints expressed in the rules. The refactoring in useful for tasks of
semantic harmonization of RDF graphs expressed with different
ontologies/vocabularies towards their representation with a single ontology or
vocagulary. The output of a refactoring is a transformed graph which satisfies
the constraints expressed in the rules.
+
+## Terminology
+
+* A __Recipe__ is a set of rules defined according to a specific task. Rules
are written in a specific syntax, and can then be executed for refactoring (as
SPARQL queries) or through reasoning services.
+* __Refactoring__ is the task aimed to perform the transformation of RDF
graphs. The transformation is driven by refactoring rules, basically Stanbol
Rules interpreted as SPARQL CONSTRUCT clauses.
+* __Reasoning__ is the activity of interpreting axioms for inferring new
knowledge, classifying, checking the consistency of an ontology, etc...
+
+## Usage Scenarios
+
Supposing we have configured the IKS (i.e. Stanbol EntityHub) in order to
fetch entities about persons from DBpedia. Now we want to represent these
entities adopting the vocabulary from schema.org and produce schemaOrg Rich
Snippets in order to provide to the IKS search engine optimization
capabilities. What we need to do is to write a recipe and calling the Refactor
via HTTP REST passing to it the recipe itself and the entities we have fetched
from Linked Data.
## Usage
