Author: buildbot
Date: Wed Jul 4 07:43:07 2012
New Revision: 824418
Log:
Staging update by buildbot for stanbol
Modified:
websites/staging/stanbol/trunk/content/ (props changed)
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/enhancementstructure.html
Propchange: websites/staging/stanbol/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Jul 4 07:43:07 2012
@@ -1 +1 @@
-1357123
+1357129
Modified:
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/enhancementstructure.html
==============================================================================
---
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/enhancementstructure.html
(original)
+++
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/enhancementstructure.html
Wed Jul 4 07:43:07 2012
@@ -96,17 +96,17 @@
</ol>
<p>While this document focuses on the first Engine and provides details on how
the Stanbol Enhancement Structure it the integral part of the Stanbol Enhancer
there is also a <a href="../enhancementusage.html">Usage Scenario</a> available
that focuses on how the Enhancements can be consumed by Stanbol Enhancer
users.</p>
<h2 id="overview-on-the-stanbol-enhancement-structure">Overview on the Stanbol
Enhancement Structure</h2>
-<p>The Stanbol Enhancement Structure is a central part of the <a
href="index.html">Stanbol Enhancer</a> architecture as it represents the
binding element between the <a href="contentitem.html">ContentItem</a> analyzed
by the the <a href="engines">EnhancementEngine</a>s as configured by an <a
href="chains">EnhancementChain</a>. Together with the <a href="content
item.html#content-parts">ContentParts</a> it represents the state that is
constantly updated during the enhancement process.</p>
+<p>The Stanbol Enhancement Structure is a central part of the <a
href="index.html">Stanbol Enhancer</a> architecture as it represents the
binding element between the <a href="contentitem.html">ContentItem</a> analyzed
by the the <a href="engines">EnhancementEngine</a>s as configured by an <a
href="chains">EnhancementChain</a>. Together with the <a
href="contentitem.html#content-parts">ContentParts</a> it represents the state
that is constantly updated during the enhancement process.</p>
<p>The following graphic provides an overview on how the EnhancementStructure
is used by the Stanbol Enhancer to formally represent the enhancement
results.</p>
<p><img alt="EnhancementStructure Overview" src="enhancementstructure.png"
title="Overview of the Stanbol Enhancement Structure showing 'Bob Marley'
recognized as Person within the parsed Text with two suggested Entities 'Bob
Marley' the musician and 'Bob Marley' the comedian" /></p>
<p>The above figure shows </p>
<ul>
-<li>A <a href="contentitem.html">ContentItem</a> with a single plain text <a
href="content item.html#content-parts">ContentParts</a> containing the text
"Apache Stanbol can detect famous entities such as Paris or Bob Marley!"</li>
+<li>A <a href="contentitem.html">ContentItem</a> with a single plain text <a
href="contentitem.html#content-parts">ContentParts</a> containing the text
"Apache Stanbol can detect famous entities such as Paris or Bob Marley!"</li>
<li>Three Enhancements: One TextAnnotation describing "Bob Marley" as
Named-Entity as extracted by the NER (NamedEntityRecognition) engine and two
EntityAnnotation that suggest different Entities from <a
href="http://dbpedia.org";>DBpedia.org</a>.</li>
-<li>Two referenced Entities: Both <a
href="http://dbpedia.org/resource/Bob-Marley";>dbpedia:Bob_Marley</a> and <a
href="http://dbpedia.org/resource/Bob_Marley_%28comedian%29";>dbpedia:Bob_Marley_(comedian)</a>
are part of <a href="http://dbpedia.org";>DBpedia.org</a> and referenced by
fise:EntityAnnotations created by instance of the the <a
href="engines/namedentitytaggingengine.html">NamedEntityLinging engine</a>
configured to link with <a href="http://dbpedia.org";>DBpedia.org</a></li>
+<li>Two referenced Entities: Both <a
href="http://dbpedia.org/resource/Bob_Marley";>dbpedia:Bob_Marley</a> and <a
href="http://dbpedia.org/resource/Bob_Marley_%28comedian%29";>dbpedia:Bob_Marley_(comedian)</a>
are part of <a href="http://dbpedia.org";>DBpedia.org</a> and referenced by
fise:EntityAnnotations created by instance of the the <a
href="engines/namedentitytaggingengine.html">NamedEntityLinging engine</a>
configured to link with <a href="http://dbpedia.org";>DBpedia.org</a></li>
<li>An <a href="chains">EnhancementChain</a> with four <a
href="engines">EnhancementEngine</a>s. However only the enhancements of the
later two are shown in the figure.</li>
</ul>
-<p>The bold relations within the figure are central as they show how the
EnhancementStructure is used to formally specify that the mention "Bob Marley"
within the analyzed text is believed to represent the Entity <a
href="http://dbpedia.org/resource/Bob-Marley";>dbpedia:Bob_Marley</a>. However
it is also stated that there is a disambiguation with an other person <a
href="http://dbpedia.org/resource/Bob_Marley_%28comedian%29";>dbpedia:Bob_Marley_(comedian)</a>.</p>
+<p>The bold relations within the figure are central as they show how the
EnhancementStructure is used to formally specify that the mention "Bob Marley"
within the analyzed text is believed to represent the Entity <a
href="http://dbpedia.org/resource/Bob_Marley";>dbpedia:Bob_Marley</a>. However
it is also stated that there is a disambiguation with an other person <a
href="http://dbpedia.org/resource/Bob_Marley_%28comedian%29";>dbpedia:Bob_Marley_(comedian)</a>.</p>
<p>The dashed relations are also important as they are used to formally
describe the extraction context: which EnhancementEngine has extracted a
feature from what ContentItem. If even more contextual information are needed,
users can combine those information with the <a
href="executionmetadata.html">ExecutionMetadata</a> collected during the
enhancement process.</p>
<h2 id="general-information">General Information</h2>
<p><strong>Used Namespaces</strong></p>
@@ -126,7 +126,7 @@
<li><strong>rdf</strong>
(<em>http://www.w3.org/1999/02/22-rdf-syntax-ns#</em>)</li>
<li>in addition <a href="engines">EnhancementEngine</a>s are free to add/use
properties of any additional Ontology (e.g. when adding the rdf:type's of
suggested Entities).</li>
</ul>
-<p><em>(*) Historical side note: FISE was the name of the Stanbol Enhancer
before its <a href="TODO: add link">incubation to Apache</a>. The Enhancement
Structure does still use the original namespace for compatibility
reasons.</em></p>
+<p><em>(*) Historical side note: FISE was the name of the Stanbol Enhancer
before its <a
href="http://wiki.apache.org/incubator/StanbolProposal";>incubation to
Apache</a>. The Enhancement Structure does still use the original namespace for
compatibility reasons.</em></p>
<p><strong>About Expressiveness:</strong></p>
<p>All Stanbol Ontologies are encoded using OWL but restrict itself to basic
features. Users need to be aware that not all rules defined in this
documentation are formally expressed within the Ontology. However all the
stated rules are validated by the <a
href="http://svn.apache.org/repos/asf/incubator/stanbol/trunk/enhancer/generic/test/src/main/java/org/apache/stanbol/enhancer/test/helper/EnhancementStructureHelper.java";>EnhancementStructureHelper</a>
UnitTest utility part of the "org.apache.stanbol.enhancer.test" module. This
ensures that EnhancementEngine implementation that validate there enhancement
using this utility comply to this specification.</p>
<p><strong>About Reasoning:</strong></p>
@@ -157,7 +157,7 @@
<h3 id="fisetextannotation">fise:TextAnnotation</h3>
<p>TextAnnotations are used to select portions parsed textual content by using
the following properties:</p>
<ul>
-<li><strong>fise:start</strong> <em>(optional, single)</em>: The start
character position within the plain text version of the parsed content. Note
that the plain text version can be retrieved by using the <a
href="enhancerrest.thml#multi-part-contentitem-support">multi-part content item
support</a> of the Stanbol Enhancer RESTful API.</li>
+<li><strong>fise:start</strong> <em>(optional, single)</em>: The start
character position within the plain text version of the parsed content. Note
that the plain text version can be retrieved by using the <a
href="enhancerrest.html#multi-part-contentitem-support">multi-part content item
support</a> of the Stanbol Enhancer RESTful API.</li>
<li><strong>fise:end</strong> <em>(required of fise:start is present,
single)</em>: The end character position. This MUST only be present of
"fise:start" is also defined.</li>
<li><strong>fise:selected-text</strong> <em>(optional, single)</em>: The text
selected by the TextAnnotation. This MUST be the same as the text from index
"fise:start" to "fise:end" within the plain text version of the parsed
content.</li>
<li><strong>fise:selection-context</strong> <em>(required if
fise:selected-text is present, single)</em>: The selection context such as the
current sentence or a fixed number of characters/word before and after the
selected text. This MUST be present if "fise:selected-text" is defined.</li>
@@ -188,7 +188,7 @@
<li><strong>entityhub:site</strong> <em>(optional, single)</em>: The name of
the Entityhub ReferencedSite managing the the suggested Entity. If this
property is present users can dereference the suggested Entity with a GET
request to "{stanbol}/entityhub/site/{site-name}/entity?id={entity}" where
{site-name} is the value of this property and {entity} is the value of the
"fise:entity-reference" property.
NOTE: the values "local" and "entityhub" need to be treated separately. In
those cases the GET request need to use
"{stanbol}/entityhub/entity?id={entity}".</li>
</ul>
-<p>The following figure shows an fise:EntityAnnotation for the Entity <a
href="http:dbpedia.org/resource/Bob_Marley">'dbpedia:Bob_Marley'</a>.</p>
+<p>The following figure shows an fise:EntityAnnotation for the Entity <a
href="http://dbpedia.org/resource/Bob_Marley";>'dbpedia:Bob_Marley'</a>.</p>
<p><img alt="'fise:EntityAnnotation' example" src="es_entityannotation.png"
title="This Example shown an EntityAnnotation that suggests the Entity
'dbpedia:Bob_Marley' for the TextAnnotation" /></p>
<h3 id="fisetopicannotation">fise:TopicAnnotation</h3>
<p>TopicAnnotation are used to categorize/classify the parsed content along
some categorization system. This is done by suggesting/linking Topics of that
categorization system for (possible parts) of the parsed content. A
"fise:TextAnnotation" is used to select the part of the content where the
linked topics apply.</p>
