Author: rwesten
Date: Wed Jul 4 07:43:00 2012
New Revision: 1357129
URL: http://svn.apache.org/viewvc?rev=1357129&view=rev
Log:
corrected some links
Modified:
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/enhancer/enhancementstructure.mdtext
Modified:
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/enhancer/enhancementstructure.mdtext
URL:
http://svn.apache.org/viewvc/incubator/stanbol/site/trunk/content/stanbol/docs/trunk/enhancer/enhancementstructure.mdtext?rev=1357129&r1=1357128&r2=1357129&view=diff
==============================================================================
---
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/enhancer/enhancementstructure.mdtext
(original)
+++
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/enhancer/enhancementstructure.mdtext
Wed Jul 4 07:43:00 2012
@@ -15,7 +15,7 @@ While this document focuses on the first
## Overview on the Stanbol Enhancement Structure
-The Stanbol Enhancement Structure is a central part of the [Stanbol
Enhancer](index.html) architecture as it represents the binding element between
the [ContentItem](contentitem.html) analyzed by the the
[EnhancementEngine](engines)s as configured by an [EnhancementChain](chains).
Together with the [ContentParts](content item.html#content-parts) it represents
the state that is constantly updated during the enhancement process.
+The Stanbol Enhancement Structure is a central part of the [Stanbol
Enhancer](index.html) architecture as it represents the binding element between
the [ContentItem](contentitem.html) analyzed by the the
[EnhancementEngine](engines)s as configured by an [EnhancementChain](chains).
Together with the [ContentParts](contentitem.html#content-parts) it represents
the state that is constantly updated during the enhancement process.
The following graphic provides an overview on how the EnhancementStructure is
used by the Stanbol Enhancer to formally represent the enhancement results.
@@ -23,12 +23,12 @@ The following graphic provides an overvi
The above figure shows
-* A [ContentItem](contentitem.html) with a single plain text
[ContentParts](content item.html#content-parts) containing the text "Apache
Stanbol can detect famous entities such as Paris or Bob Marley!"
+* A [ContentItem](contentitem.html) with a single plain text
[ContentParts](contentitem.html#content-parts) containing the text "Apache
Stanbol can detect famous entities such as Paris or Bob Marley!"
* 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
[DBpedia.org](http://dbpedia.org).
-* Two referenced Entities: Both
[dbpedia:Bob_Marley](http://dbpedia.org/resource/Bob-Marley) and
[dbpedia:Bob_Marley_(comedian)](http://dbpedia.org/resource/Bob_Marley_%28comedian%29)
are part of [DBpedia.org](http://dbpedia.org) and referenced by
fise:EntityAnnotations created by instance of the the [NamedEntityLinging
engine](engines/namedentitytaggingengine.html) configured to link with
[DBpedia.org](http://dbpedia.org)
+* Two referenced Entities: Both
[dbpedia:Bob_Marley](http://dbpedia.org/resource/Bob_Marley) and
[dbpedia:Bob_Marley_(comedian)](http://dbpedia.org/resource/Bob_Marley_%28comedian%29)
are part of [DBpedia.org](http://dbpedia.org) and referenced by
fise:EntityAnnotations created by instance of the the [NamedEntityLinging
engine](engines/namedentitytaggingengine.html) configured to link with
[DBpedia.org](http://dbpedia.org)
* An [EnhancementChain](chains) with four [EnhancementEngine](engines)s.
However only the enhancements of the later two are shown in the figure.
-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
[dbpedia:Bob_Marley](http://dbpedia.org/resource/Bob-Marley). However it is
also stated that there is a disambiguation with an other person
[dbpedia:Bob_Marley_(comedian)](http://dbpedia.org/resource/Bob_Marley_%28comedian%29).
+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
[dbpedia:Bob_Marley](http://dbpedia.org/resource/Bob_Marley). However it is
also stated that there is a disambiguation with an other person
[dbpedia:Bob_Marley_(comedian)](http://dbpedia.org/resource/Bob_Marley_%28comedian%29).
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 [ExecutionMetadata](executionmetadata.html)
collected during the enhancement process.
@@ -48,7 +48,7 @@ This provides the list of namespaces use
* __rdf__ (_http://www.w3.org/1999/02/22-rdf-syntax-ns#_)
* in addition [EnhancementEngine](engines)s are free to add/use properties of
any additional Ontology (e.g. when adding the rdf:type's of suggested Entities).
-_(*) Historical side note: FISE was the name of the Stanbol Enhancer before
its [incubation to Apache](TODO: add link). The Enhancement Structure does
still use the original namespace for compatibility reasons._
+_(*) Historical side note: FISE was the name of the Stanbol Enhancer before
its [incubation to Apache](http://wiki.apache.org/incubator/StanbolProposal).
The Enhancement Structure does still use the original namespace for
compatibility reasons._
__About Expressiveness:__
@@ -88,7 +88,7 @@ The following properties provide informa
TextAnnotations are used to select portions parsed textual content by using
the following properties:
-* __fise:start__ _(optional, single)_: 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 [multi-part content item
support](enhancerrest.thml#multi-part-contentitem-support) of the Stanbol
Enhancer RESTful API.
+* __fise:start__ _(optional, single)_: 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 [multi-part content item
support](enhancerrest.html#multi-part-contentitem-support) of the Stanbol
Enhancer RESTful API.
* __fise:end__ _(required of fise:start is present, single)_: The end
character position. This MUST only be present of "fise:start" is also defined.
* __fise:selected-text__ _(optional, single)_: 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.
* __fise:selection-context__ _(required if fise:selected-text is present,
single)_: 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.
@@ -123,7 +123,7 @@ EntityAnnotations are used to suggest/li
* __entityhub:site__ _(optional, single)_: 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}".
-The following figure shows an fise:EntityAnnotation for the Entity
['dbpedia:Bob_Marley'](http:dbpedia.org/resource/Bob_Marley).
+The following figure shows an fise:EntityAnnotation for the Entity
['dbpedia:Bob_Marley'](http://dbpedia.org/resource/Bob_Marley).
