Mediawiki1 - User contributions [en]

Writing Mappings/Templates

2010-04-12T10:18:02Z

ChrisBizer: /* How to map a Wikipedia template */

== How to map a Wikipedia template ==

* Get the encoded template page name from Wikipedia. Make sure that the template is no redirect page.
** ''Example'': For the Wikipedia template [http://en.wikipedia.org/wiki/Template:Infobox_musical_artist Infobox musical artist] use <code>Infobox_musical_artist</code>.
* Create a wiki page in this wiki in the Mapping namespace, using the encoded Wikipedia template page name.
** ''Example'': For the Wikipedia template [http://en.wikipedia.org/wiki/Template:Infobox_musical_artist Infobox musical artist] create the wiki page [[Mapping:Infobox_musical_artist]].
* Decide on the ontology class you would like to map the template to.
** ''Example'': Ontology classes belong to the Class namespace. A list of existing ontology classes can be found via the sidebar ([http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=200 Ontology Classes]).
* Write a [[Template:TemplateMapping]] or [[Template:ConditionalMapping]] to map the Wikipedia template to an ontology class and save it to the created wiki page in the Mapping namespace.

The full [http://dbpedia.svn.sourceforge.net/viewvc/dbpedia/trunk/extraction/core/doc/mapping%20language/ documentation] on writing mappings can be found via the DBpedia SVN Repository.

== Template to Ontology Mapping Language ==

When mapping a Wikipedia template to an ontology class and mapping template properties to ontology properties for this template, users will have to edit the corresponding template documentation page in MediaWiki.

The following templates cover the template to ontology schema mapping:
* [[#Template_Mapping|TemplateMapping]] Mapping from Wikipedia templates to ontology classes.
* [[#Property_Mapping|PropertyMapping]] Mapping from Wikipedia template properties to ontology properties.
* [[#Intermediate_Node_Mapping|IntermediateNodeMapping]] For extracting multiple values from a single property it is necessary to introduce an intermediate node. The IntermediateNodeMapping allows to express mappings from Wikipedia template properties to ontology properties on an additional node and to connect the additional node to the mapped instance.
* [[#Conditional_Mapping|ConditionalMapping]] Maps templates to ontology classes. In comparison to a TemplateMapping the mapping can be defined depending on template properties and their values.
* [[#Custom_Mappings|Custom mappings]]
** To cover specific, more complex mapping cases, the DBpedia extraction framework can be extended with custom parsers which have to implement a specific PHP interface. These parsers are invoked using custom mappings.

=== Template Mapping ===

The [[Template:TemplateMapping|TemplateMapping]] template offers the following template parameters:
* ''mapToClass''
** Templates are mapped to ontology classes. The template parameter mapToClass allows one DBpedia ontology class as a value.
* ''correspondingClass'', ''correspondingProperty''
** In the case that different templates are used on the same page (for instance Automobile and Automobile Generation), the instance resulting from the second grade template (Automobile Generation) can be connected to the instance of the first grade template (Automobile) using a corresponding property. Thus, if an instance of type correspondingClass is found on the same page, it will be connected to the instances of the mapped template by correspondingProperty.
* ''mappings''
** Mappings map template properties to ontology properties, they have to be defined by using PropertyMapping or IntermediateNodeMapping. Custom, user-defined, mappings like the GeocoordinatesMapping can also be defined.

=== Property Mapping ===

The [[Template:PropertyMapping|PropertyMapping]] template offers the following template parameters:
* ''ontologyProperty''
** A template property to ontology property mapping should list one ontology property.
* ''templateProperty''
** A template property to ontology property mapping should list one template property which is to be mapped.
* ''unit''
** If a template property containing a numerical value and a unit is mapped, the unit has to be defined. If a template property has no default unit defined, e.g. its values can contain different units of the same dimension, the dimension has to be defined for usability as well as validation reasons. Possible dimensions are [http://mappings.dbpedia.org/index.php/DBpedia_Datatypes Length or Mass].

=== Intermediate Node Mapping ===

The [[Template:IntermediateNodeMapping|IntermediateNodeMapping]] template offers the following template parameters:
* ''nodeClass'', ''correspondingProperty''
** Creates an additional node of the type nodeClass, which will be connected to the instance extracted from template by the property provided by correspondingProperty.
* ''mappings''
** Mappings map template properties to ontology properties, they have to be defined by using PropertyMapping, IntermediateNodeMapping, or a CustomMapping.

=== Conditional Mapping ===

The [[Template:ConditionalMapping|ConditionalMapping]] template offers mapping templates to ontology classes. In comparison to a TemplateMapping the mapping can be defined depending on template properties and their values.

* ''cases'': Cases define conditions on template properties and their values and can change the default mapping, like the ontology class the template is mapped to and the ontology properties the template properties are mapped to. The cases template property should contain a list of [[Template:Condition|Condition]] templates.
* ''defaultMappings'': The default mapping defines the default template property mappings using PropertyMapping etc.. The default ontology class the template is mapped to has to be defined by an ''otherwise'' condition.

=== Custom Mappings ===

For specific tasks, such as extracting durations or calculating a geo-location-ID based on multiple properties, we allow the DBpedia extraction framework to be extended with custom value parsers and allow the definition of DBpedia custom mapping templates. The name of a custom mapping template has to be equal to the name of the corresponding DBpedia parser class.
As examples of custom mapping, we define the DateIntervalMapping and the GeocoordinatesMapping.

The [[Template:DateIntervalMapping|DateIntervalMapping]] template provides an exact mapping from start and end dates of a template property value to ontology properties. It offers the following template parameters:
* ''templateProperty''
* ''startDateOntologyProperty''
* ''endDateOntologyProperty''

The [[Template:GeocoordinatesMapping|GeocoordinatesMapping]] template offers the following template parameters:
* ''coordinates''
** Use the coordinates parameter if the geo coordinates are covered by one template property.

* ''latitude''
* ''longitude''

* ''latitudeDirection''
* ''latitudeDegrees''
* ''latitudeMinutes''
* ''latitudeSeconds''
* ''longitudeDirection''
* ''longitudeDegrees''
* ''longitudeMinutes''
* ''longitudeSeconds''

* ''ontologyProperty''

The [[Template:CombineDateMapping|CombineDateMapping]] template offers the following template parameters:
* ''templateProperty1''
* ''unit1''
* ''templateProperty2''
* ''unit2''
* ''templateProperty3''
* ''unit3''
* ''ontologyProperty''

The [[Template:CalculateMapping|CalculateMapping]] template offers the following template parameters:
* ''operation''
* ''templateProperty1''
* ''unit1''
* ''templateProperty2''
* ''unit2''
* ''ontologyProperty''

Main Page

2010-04-12T07:54:09Z

ChrisBizer: /* Tutorials */

== About DBpedia ==

[http://dbpedia.org/ DBpedia] is a community effort to extract structured information from Wikipedia and to make this information available on the Web. DBpedia allows you to ask sophisticated queries against Wikipedia, and to link other data sets on the Web to Wikipedia data. The [http://wiki.dbpedia.org/Datasets DBpedia knowledge base], which has been created by extracting stuctured information from Wikipedia, currently describes more than 2.9 million things, including at least 282,000 persons, 339,000 places (including 241,000 populated places), 88,000 music albums, 44,000 films, 15,000 video games, 119,000 organizations (including 20,000 companies and 29,000 educational institutions), 130,000 species and 4400 diseases.

== About mappings.dbpedia.org ==
This wiki contains the infobox-to-ontology and the table-to-ontology mappings which are used by the DBpedia extraction framework as well as the ontology definition itself. The framework collects the templates defined in this Wiki and extracts the Wikipedia content according to them (As of March 2010, only the dump extraction uses the mappings. DBpedia Live is going to follow shortly).

=== DBpedia Mappings ===

The type of Wikipedia content that is most valuable for the DBpedia extraction are infoboxes and tables. Infoboxes display an article's most relevant facts as a table of attribute-value pairs on the top right-hand side of the Wikipedia page.

As Wikipedia's infobox template system has decentrally evolved over time, different communities of Wikipedia editors use different templates to describe the same type of things (e.g. infobox_city_japan, infobox_swiss_town and infobox_town_de). Different templates use different names for the same attribute (e.g. birthplace and
placeofbirth). As many Wikipedia editors do not strictly follow the recommendations given on the page that describes a template, attribute values are
expressed using a wide range of different formats and units of measurement.

In order to overcome the problems of synonymous attribute names and multiple templates being used for the same type of things, the DBpedia project maps Wikipedia templates as well as tables within an article to the [http://wiki.dbpedia.org/Ontology DBpedia ontology].
These mappings are specified using the '''DBpedia Mapping Language'''. The mapping language makes use of MediaWiki templates that define DBpedia ontology classes and properties as well as template/table to ontology mappings.

The following mappings map Wikipedia infoboxes and tables to this ontology:

* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=204 Infobox Mappings]
* [http://mappings.dbpedia.org/index.php?title=Special%3APrefixIndex&prefix=Table&namespace=204 Table Mappings]

=== DBpedia Ontology ===

The DBpedia ontology is based on OWL and forms the structural backbone of DBpedia. It describes classes, e.g. person, city, country, and properties, e.g. birth place, longitude. Information in Wikipedia articles is then mapped via the above described mapping to this ontology. Most prominently, many Wikipedia pages use so called infoboxes. For instance, the English wikipedia article about [http://en.wikipedia.org/wiki/London London] contains a "settlement infobox". This infobox may be mapped to e.g. the class "populated place" (see [[OntologyClass:PopulatedPlace|PopulatedPlace]]) in the DBpedia ontology and the attributes in the infobox are mapped to properties in the DBpedia ontology.  This way, a unified view over all data in infoboxes can be obtained. Since this information conforms to Semantic Web standards, it can be queried and combined by a broad range of tools in a useful way. This increases the value of information entered by the Wikipedia community.

A listing of all classes, properties and datatypes (units of measurement) used by the DBpedia ontology is found below:

* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=200 Ontology Classes] - OWL classes and their definitons
* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=202 Ontology Properties] - OWL Object and Datatype properties
* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=206 Datatypes]

== How is the Mapping and the Ontology maintained? ==
So far, few people inside the DBpedia project maintained the mapping and ontology, but in the spirit of open source projects, control will be handed over to the Wikipedia and DBpedia community. The members of the DBpedia team are not able to extend the mappings to cover all Wikipedia infoboxes and tables, due to the size of the task and the knowledge required to map templates from exotic domains. Therefore, the idea of this Wiki is to enable the interested public to contribute to the definition of DBpedia mappings by updating existing mappings and by adding new mappings to this wiki.

''This wiki is read-only. If you like to edit the mappings or ontology schema, please [[Special:UserLogin|register]] and the DBpedia team will add you to the editors list.''

=== Tutorials ===

The Specification of the '''DBpedia Mapping Language''' can be found [http://dbpedia.svn.sourceforge.net/viewvc/dbpedia/trunk/extraction/core/doc/mapping%20language/ here]. Please find below step-by-step tutorials on:

* [[Ontology_Editing|How to edit the ontology schema]]
* How to write
** [[Writing_Mappings/Templates|Template mappings]]
** [[Writing_Mappings/Tables|Table mappings]]

=== Tools ===

This wiki provides several tools that help you to edit the mappings and the ontology:

* '''Ontology View.''' The [http://mappings.dbpedia.org/server/ontology/classes ontology view] gives you an overview about the current shape of the DBpedia ontology.
* '''Mapping Validator.''' When you are editing a mapping, there is a validate button on the bottom of the page. Pressing the button validates your changes for syntactic correctness and highlights inconsistencies such as missing property definitions.
* '''Extraction Tester.''' The extraction tester tests a mapping against a set of example Wikipedia pages. This gives you direct feedback about whether a mapping works and how the resulting data will look like.

Main Page

2010-03-24T09:24:21Z

ChrisBizer: /* Tools */

== About DBpedia ==

[http://dbpedia.org/ DBpedia] is a community effort to extract structured information from Wikipedia and to make this information available on the Web. DBpedia allows you to ask sophisticated queries against Wikipedia, and to link other data sets on the Web to Wikipedia data. The [http://wiki.dbpedia.org/Datasets DBpedia knowledge base], which has been created by extracting stuctured information from Wikipedia, currently describes more than 2.9 million things, including at least 282,000 persons, 339,000 places (including 241,000 populated places), 88,000 music albums, 44,000 films, 15,000 video games, 119,000 organizations (including 20,000 companies and 29,000 educational institutions), 130,000 species and 4400 diseases.

== About this wiki ==

=== DBpedia Mappings ===

The type of Wikipedia content that is most valuable for the DBpedia extraction are infoboxes and tables. Infoboxes display an article's most relevant facts as a table of attribute-value pairs on the top right-hand side of the Wikipedia page.

As Wikipedia's infobox template system has decentrally envolved over time, different communities of Wikipedia editors use different templates to describe the same type of things (e.g.
infobox_city_japan, infobox_swiss_town and infobox_town_de). Different templates use different names for the same attribute (e.g. birthplace and
placeofbirth). As many Wikipedia editors do not strictly follow the recommendations given on the page that describes a template, attribute values are
expressed using a wide range of different formats and units of measurement.

In order to overcome the problems of synonymous attribute names and multiple templates being used for the same type of things, the DBpedia project maps Wikipedia templates as well as tables within an article to the [http://wiki.dbpedia.org/Ontology DBpedia ontology].
These mappings are specified using the '''DBpedia Mapping Language'''. The mapping language makes use of MediaWiki templates that define DBpedia ontology classes and properties as well as template/table to ontology mappings.

=== mappings.dbpedia.org ===

This wiki contains the infobox-to-ontology and the table-to-ontology mappings which are used by the DBpedia extraction framework as well as the ontology definition itself. The framework collects the templates defined in this Wiki and extracts the Wikipedia content according to them (As of March 2010, only the dump extraction uses the mappings. DBpedia Live is going to follow shortly).

A listing of all classes, properties and datatypes (units of measurement) used by the DBpedia ontology is found below:

* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=200 Ontology Classes]
* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=202 Ontology Properties]
* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=206 Datatypes]

The following mappings map Wikipedia infoboxes and tables to this ontology:

* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=204 Infobox Mappings]
* [http://mappings.dbpedia.org/index.php?title=Special%3APrefixIndex&prefix=Table&namespace=204 Table Mappings]

The members of the DBpedia team are not able to extend the mappings to cover all Wikipedia infoboxes and tables, due to the size of the task and the knowledge required to map templates from exotic domains. Therefore, the idea of this Wiki is to enable the interested public to contribute to the definition of DBpedia mappings by updating existing mappings and by adding new mappings to this wiki.

''This wiki is read-only. If you like to edit the mappings or ontology schema, please [[Special:UserLogin|register]] and the DBpedia team will add you to the editors list.''

== Tutorials ==

The Specification of the '''DBpedia Mapping Language''' can be found [http://dbpedia.svn.sourceforge.net/viewvc/dbpedia/trunk/extraction/doc/mapping%20language/DBpedia%20Mapping%20Language.pdf here]. Please find below step-by-step tutorials on:

* [[Ontology_Editing|How to edit the ontology schema]]
* How to write
** [[Writing_Mappings/Templates|Template mappings]]
** [[Writing_Mappings/Tables|Table mappings]]

== Tools ==

This wiki provides several tools that help you to edit the mappings and the ontology:

* '''Ontology View.''' The [http://mappings.dbpedia.org/server/ontology/classes ontology view] gives you an overview about the current shape of the DBpedia ontology.
* '''Mapping Validator.''' When you are editing a mapping, there is a validate button on the bottom of the page. Pressing the button validates your changes for syntactic correctness and highlights inconsistencies such as missing property definitions.
* '''Extraction Tester.''' The extraction tester tests a mapping against a set of example Wikipedia pages. This gives you direct feedback about whether a mapping works and how the resulting data will look like.

Main Page

2010-03-24T09:23:58Z

ChrisBizer: /* Tools */

== About DBpedia ==

[http://dbpedia.org/ DBpedia] is a community effort to extract structured information from Wikipedia and to make this information available on the Web. DBpedia allows you to ask sophisticated queries against Wikipedia, and to link other data sets on the Web to Wikipedia data. The [http://wiki.dbpedia.org/Datasets DBpedia knowledge base], which has been created by extracting stuctured information from Wikipedia, currently describes more than 2.9 million things, including at least 282,000 persons, 339,000 places (including 241,000 populated places), 88,000 music albums, 44,000 films, 15,000 video games, 119,000 organizations (including 20,000 companies and 29,000 educational institutions), 130,000 species and 4400 diseases.

== About this wiki ==

=== DBpedia Mappings ===

The type of Wikipedia content that is most valuable for the DBpedia extraction are infoboxes and tables. Infoboxes display an article's most relevant facts as a table of attribute-value pairs on the top right-hand side of the Wikipedia page.

As Wikipedia's infobox template system has decentrally envolved over time, different communities of Wikipedia editors use different templates to describe the same type of things (e.g.
infobox_city_japan, infobox_swiss_town and infobox_town_de). Different templates use different names for the same attribute (e.g. birthplace and
placeofbirth). As many Wikipedia editors do not strictly follow the recommendations given on the page that describes a template, attribute values are
expressed using a wide range of different formats and units of measurement.

In order to overcome the problems of synonymous attribute names and multiple templates being used for the same type of things, the DBpedia project maps Wikipedia templates as well as tables within an article to the [http://wiki.dbpedia.org/Ontology DBpedia ontology].
These mappings are specified using the '''DBpedia Mapping Language'''. The mapping language makes use of MediaWiki templates that define DBpedia ontology classes and properties as well as template/table to ontology mappings.

=== mappings.dbpedia.org ===

This wiki contains the infobox-to-ontology and the table-to-ontology mappings which are used by the DBpedia extraction framework as well as the ontology definition itself. The framework collects the templates defined in this Wiki and extracts the Wikipedia content according to them (As of March 2010, only the dump extraction uses the mappings. DBpedia Live is going to follow shortly).

A listing of all classes, properties and datatypes (units of measurement) used by the DBpedia ontology is found below:

* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=200 Ontology Classes]
* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=202 Ontology Properties]
* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=206 Datatypes]

The following mappings map Wikipedia infoboxes and tables to this ontology:

* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=204 Infobox Mappings]
* [http://mappings.dbpedia.org/index.php?title=Special%3APrefixIndex&prefix=Table&namespace=204 Table Mappings]

The members of the DBpedia team are not able to extend the mappings to cover all Wikipedia infoboxes and tables, due to the size of the task and the knowledge required to map templates from exotic domains. Therefore, the idea of this Wiki is to enable the interested public to contribute to the definition of DBpedia mappings by updating existing mappings and by adding new mappings to this wiki.

''This wiki is read-only. If you like to edit the mappings or ontology schema, please [[Special:UserLogin|register]] and the DBpedia team will add you to the editors list.''

== Tutorials ==

The Specification of the '''DBpedia Mapping Language''' can be found [http://dbpedia.svn.sourceforge.net/viewvc/dbpedia/trunk/extraction/doc/mapping%20language/DBpedia%20Mapping%20Language.pdf here]. Please find below step-by-step tutorials on:

* [[Ontology_Editing|How to edit the ontology schema]]
* How to write
** [[Writing_Mappings/Templates|Template mappings]]
** [[Writing_Mappings/Tables|Table mappings]]

== Tools ==

This wiki provides several tools that help you to edit the mappings and the ontology:

* '''Ontology View.''' The [[http://mappings.dbpedia.org/server/ontology/classes ontology view]] gives you an overview about the current shape of the DBpedia ontology.
* '''Mapping Validator.''' When you are editing a mapping, there is a validate button on the bottom of the page. Pressing the button validates your changes for syntactic correctness and highlights inconsistencies such as missing property definitions.
* '''Extraction Tester.''' The extraction tester tests a mapping against a set of example Wikipedia pages. This gives you direct feedback about whether a mapping works and how the resulting data will look like.

Main Page

2010-03-24T09:16:04Z

ChrisBizer:

== About DBpedia ==

[http://dbpedia.org/ DBpedia] is a community effort to extract structured information from Wikipedia and to make this information available on the Web. DBpedia allows you to ask sophisticated queries against Wikipedia, and to link other data sets on the Web to Wikipedia data. The [http://wiki.dbpedia.org/Datasets DBpedia knowledge base], which has been created by extracting stuctured information from Wikipedia, currently describes more than 2.9 million things, including at least 282,000 persons, 339,000 places (including 241,000 populated places), 88,000 music albums, 44,000 films, 15,000 video games, 119,000 organizations (including 20,000 companies and 29,000 educational institutions), 130,000 species and 4400 diseases.

== About this wiki ==

=== DBpedia Mappings ===

The type of Wikipedia content that is most valuable for the DBpedia extraction are infoboxes and tables. Infoboxes display an article's most relevant facts as a table of attribute-value pairs on the top right-hand side of the Wikipedia page.

As Wikipedia's infobox template system has decentrally envolved over time, different communities of Wikipedia editors use different templates to describe the same type of things (e.g.
infobox_city_japan, infobox_swiss_town and infobox_town_de). Different templates use different names for the same attribute (e.g. birthplace and
placeofbirth). As many Wikipedia editors do not strictly follow the recommendations given on the page that describes a template, attribute values are
expressed using a wide range of different formats and units of measurement.

In order to overcome the problems of synonymous attribute names and multiple templates being used for the same type of things, the DBpedia project maps Wikipedia templates as well as tables within an article to the [http://wiki.dbpedia.org/Ontology DBpedia ontology].
These mappings are specified using the '''DBpedia Mapping Language'''. The mapping language makes use of MediaWiki templates that define DBpedia ontology classes and properties as well as template/table to ontology mappings.

=== mappings.dbpedia.org ===

This wiki contains the infobox-to-ontology and the table-to-ontology mappings which are used by the DBpedia extraction framework as well as the ontology definition itself. The framework collects the templates defined in this Wiki and extracts the Wikipedia content according to them (As of March 2010, only the dump extraction uses the mappings. DBpedia Live is going to follow shortly).

A listing of all classes, properties and datatypes (units of measurement) used by the DBpedia ontology is found below:

* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=200 Ontology Classes]
* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=202 Ontology Properties]
* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=206 Datatypes]

The following mappings map Wikipedia infoboxes and tables to this ontology:

* [http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=204 Infobox Mappings]
* [http://mappings.dbpedia.org/index.php?title=Special%3APrefixIndex&prefix=Table&namespace=204 Table Mappings]

The members of the DBpedia team are not able to extend the mappings to cover all Wikipedia infoboxes and tables, due to the size of the task and the knowledge required to map templates from exotic domains. Therefore, the idea of this Wiki is to enable the interested public to contribute to the definition of DBpedia mappings by updating existing mappings and by adding new mappings to this wiki.

''This wiki is read-only. If you like to edit the mappings or ontology schema, please [[Special:UserLogin|register]] and the DBpedia team will add you to the editors list.''

== Tutorials ==

The Specification of the '''DBpedia Mapping Language''' can be found [http://dbpedia.svn.sourceforge.net/viewvc/dbpedia/trunk/extraction/doc/mapping%20language/DBpedia%20Mapping%20Language.pdf here]. Please find below step-by-step tutorials on:

* [[Ontology_Editing|How to edit the ontology schema]]
* How to write
** [[Writing_Mappings/Templates|Template mappings]]
** [[Writing_Mappings/Tables|Table mappings]]

== Tools ==

This wiki provides several tools that help you to edit mappings.

* '''Ontology View.''' The [[http://mappings.dbpedia.org/server/ontology/classes ontology view]] gives you an overview about the current shape of the DBpedia ontology.
* '''Mapping Validator.''' When you are editing a mapping, there is a validate botton on the bottom of the page. Pressing the botton validates your changes for syntactic correctness and highlights inconsistencies such as missing property definitions.
* '''Extraction Tester.''' The extraction tester tests a mapping against a set of example Wikipedia pages. This gives you direct feedback about wheather a mapping works and how the resulting data will look like.

Main Page

2010-03-08T15:58:02Z

ChrisBizer: /* mappings.dpedia.org */

Main Page

2010-03-08T15:57:11Z

ChrisBizer: /* mappings.dpedia.org */

Template:PropertyMapping

2010-03-08T15:55:43Z

ChrisBizer: /* Meanings */

<includeonly><table class="wikitable">
<tr><th style="text-align:left" colspan="2"> Property Mapping <small>([[Template:PropertyMapping|<span style="cursor:help;">help</span>]])</small>
</th></tr>
<tr>
<td width="150px"> template property
</td><td width="400px">{{#if:{{{templateProperty|}}}|{{{templateProperty}}}|<span style="color:red">please define a template property</span>}}</td></tr>
<tr>
<td> ontology property
</td><td>{{#if:{{{ontologyProperty|}}}|[[OntologyProperty:{{#replace:{{{ontologyProperty}}}|:|/}}]]|<span style="color:red">please define an ontology property</span>}}</td></tr>
{{#if:{{{unit|}}}|<tr>
<td>unit</td><td>{{{unit}}}</td>
</tr>}}
</table></includeonly>
<noinclude>'''<nowiki>{{PropertyMapping}}</nowiki>''' maps template properties to ontology properties.

=== Usage ===

<pre>
{{PropertyMapping
| templateProperty =
| ontologyProperty =
| unit =
}}
</pre>

=== Meanings ===

* '''templateProperty''': A template property to ontology property mapping should list one template property which is to be mapped.
* '''ontologyProperty''': A template property to ontology property mapping should list one ontology property.
* '''unit''': If a template property containing a numerical value and a unit is mapped, the unit has to be defined (Please use only values from [http://mappings.dbpedia.org/index.php/DBpedia_Datatypes DBpedia unit and dimensions]). If a template property has no default unit defined, e.g. its values can contain different units of the same dimension, the dimension has to be defined for usability as well as validation reasons. Possible dimensions are Length or Mass.

=== Example ===

The property mapping from the template property birth_date to the ontology property birthDate:

<pre>
{{PropertyMapping
| templateProperty = birth_date
| ontologyProperty = birthDate
}}
</pre>
</noinclude>

Template:PropertyMapping

2010-03-08T15:55:24Z

ChrisBizer: /* Meanings */

<includeonly><table class="wikitable">
<tr><th style="text-align:left" colspan="2"> Property Mapping <small>([[Template:PropertyMapping|<span style="cursor:help;">help</span>]])</small>
</th></tr>
<tr>
<td width="150px"> template property
</td><td width="400px">{{#if:{{{templateProperty|}}}|{{{templateProperty}}}|<span style="color:red">please define a template property</span>}}</td></tr>
<tr>
<td> ontology property
</td><td>{{#if:{{{ontologyProperty|}}}|[[OntologyProperty:{{#replace:{{{ontologyProperty}}}|:|/}}]]|<span style="color:red">please define an ontology property</span>}}</td></tr>
{{#if:{{{unit|}}}|<tr>
<td>unit</td><td>{{{unit}}}</td>
</tr>}}
</table></includeonly>
<noinclude>'''<nowiki>{{PropertyMapping}}</nowiki>''' maps template properties to ontology properties.

=== Usage ===

<pre>
{{PropertyMapping
| templateProperty =
| ontologyProperty =
| unit =
}}
</pre>

=== Meanings ===

* '''templateProperty''': A template property to ontology property mapping should list one template property which is to be mapped.
* '''ontologyProperty''': A template property to ontology property mapping should list one ontology property.
* '''unit''': If a template property containing a numerical value and a unit is mapped, the unit has to be defined (Please use only values from[http://mappings.dbpedia.org/index.php/DBpedia_Datatypes DBpedia unit and dimensions]). If a template property has no default unit defined, e.g. its values can contain different units of the same dimension, the dimension has to be defined for usability as well as validation reasons. Possible dimensions are Length or Mass.

=== Example ===

The property mapping from the template property birth_date to the ontology property birthDate:

<pre>
{{PropertyMapping
| templateProperty = birth_date
| ontologyProperty = birthDate
}}
</pre>
</noinclude>

Writing Mappings/Templates

2010-03-08T15:53:16Z

ChrisBizer: /* Property Mapping */

== How to map a Wikipedia template ==

* Get the encoded template page name from Wikipedia.
** ''Example'': For the Wikipedia template [http://en.wikipedia.org/wiki/Template:Infobox_musical_artist Infobox musical artist] use <code>Infobox_musical_artist</code>.
* Create a wiki page in this wiki in the Mapping namespace, using the encoded Wikipedia template page name.
** ''Example'': For the Wikipedia template [http://en.wikipedia.org/wiki/Template:Infobox_musical_artist Infobox musical artist] create the wiki page [[Mapping:Infobox_musical_artist]].
* Decide on the ontology class you would like to map the template to.
** ''Example'': Ontology classes belong to the Class namespace. A list of existing ontology classes can be found via the sidebar ([http://mappings.dbpedia.org/index.php?title=Special%3AAllPages&from=&to=&namespace=100 Ontology Classes]).
* Write a [[Template:TemplateMapping]] or [[Template:ConditionalMapping]] to map the Wikipedia template to an ontology class and save it to the created wiki page in the Mapping namespace.

The full [http://dbpedia.svn.sourceforge.net/viewvc/dbpedia/trunk/extraction/doc/mapping%20language/DBpedia%20Mapping%20Language.pdf documentation] on writing mappings can be found via the DBpedia SVN Repository.

== Template to Ontology Mapping Language ==

When mapping a Wikipedia template to an ontology class and mapping template properties to ontology properties for this template, users will have to edit the corresponding template documentation page in MediaWiki.

The following templates cover the template to ontology schema mapping:
* [[#Template_Mapping|TemplateMapping]] Mapping from Wikipedia templates to ontology classes.
* [[#Property_Mapping|PropertyMapping]] Mapping from Wikipedia template properties to ontology properties.
* [[#Intermediate_Node_Mapping|IntermediateNodeMapping]] For extracting multiple values from a single property it is necessary to introduce an intermediate node. The IntermediateNodeMapping allows to express mappings from Wikipedia template properties to ontology properties on an additional node and to connect the additional node to the mapped instance.
* [[#Conditional_Mapping|ConditionalMapping]]
* [[#Custom_Mappings|Custom mappings]]
** To cover specific, more complex mapping cases, the DBpedia extraction framework can be extended with custom parsers which have to implement a specific PHP interface. These parsers are invoked using custom mappings.

=== Template Mapping ===

The [[Template:TemplateMapping|TemplateMapping]] template offers the following template parameters:
* ''mapToClass''
** Templates are mapped to ontology classes. The template parameter mapToClass allows one DBpedia ontology class as a value.
* ''correspondingClass'', ''correspondingProperty''
** In the case that different templates are used on the same page (for instance Automobile and Automobile Generation), the instance resulting from the second grade template (Automobile Generation) can be connected to the instance of the first grade template (Automobile) using a corresponding property. Thus, if an instance of type correspondingClass is found on the same page, it will be connected to the instances of the mapped template by correspondingProperty.
* ''mappings''
** Mappings map template properties to ontology properties, they have to be defined by using PropertyMapping or IntermediateNodeMapping. Custom, user-defined, mappings like the GeocoordinatesMapping can also be defined.

=== Property Mapping ===

The [[Template:PropertyMapping|PropertyMapping]] template offers the following template parameters:
* ''ontologyProperty''
** A template property to ontology property mapping should list one ontology property.
* ''templateProperty''
** A template property to ontology property mapping should list one template property which is to be mapped.
* ''unit''
** If a template property containing a numerical value and a unit is mapped, the unit has to be defined. If a template property has no default unit defined, e.g. its values can contain different units of the same dimension, the dimension has to be defined for usability as well as validation reasons. Possible dimensions are [http://mappings.dbpedia.org/index.php/DBpedia_Datatypes Length or Mass].

=== Intermediate Node Mapping ===

The [[Template:IntermediateNodeMapping|IntermediateNodeMapping]] template offers the following template parameters:
* ''nodeClass'', ''correspondingProperty''
** Creates an additional node of the type nodeClass, which will be connected to the instance extracted from template by the property provided by correspondingProperty.
* ''mappings''
** Mappings map template properties to ontology properties, they have to be defined by using PropertyMapping, IntermediateNodeMapping, or a CustomMapping.

=== Conditional Mapping ===

=== Custom Mappings ===

For specific tasks, such as extracting durations or calculating a geo-location-ID based on multiple properties, we allow the DBpedia extraction framework to be extended with custom value parsers and allow the definition of DBpedia custom mapping templates. The name of a custom mapping template has to be equal to the name of the corresponding DBpedia parser class.
As examples of custom mapping, we define the DateIntervalMapping and the GeocoordinatesMapping.

The [[Template:DateIntervalMapping|DateIntervalMapping]] template provides an exact mapping from start and end dates of a template property value to ontology properties. It offers the following template parameters:
* ''templateProperty''
* ''startDateOntologyProperty''
* ''endDateOntologyProperty''

The [[Template:GeocoordinatesMapping|GeocoordinatesMapping]] template offers the following template parameters:
* ''coordinates''
** Use the coordinates parameter if the geo coordinates are covered by one template property.

* ''latitude''
* ''longitude''

* ''latitudeDirection''
* ''latitudeDegrees''
* ''latitudeMinutes''
* ''latitudeSeconds''
* ''longitudeDirection''
* ''longitudeDegrees''
* ''longitudeMinutes''
* ''longitudeSeconds''

* ''ontologyProperty''

The [[Template:CombineDateMapping|CombineDateMapping]] template offers the following template parameters:
* ''templateProperty1''
* ''unit1''
* ''templateProperty2''
* ''unit2''
* ''templateProperty3''
* ''unit3''
* ''ontologyProperty''

The [[Template:CalculateMapping|CalculateMapping]] template offers the following template parameters:
* ''operation''
* ''templateProperty1''
* ''unit1''
* ''templateProperty2''
* ''unit2''
* ''ontologyProperty''

Help:Contents

2010-03-08T14:28:56Z

ChrisBizer:

This wiki contains the infobox-to-ontology and the table-to-ontology mappings which are used by the DBpedia extraction framework as well as the ontology definition itself. The framework collects the templates defined in this Wiki and extracts the Wikipedia content according to them.

The Specification of the '''DBpedia Mapping Language''' can be found [http://dbpedia.svn.sourceforge.net/viewvc/dbpedia/trunk/extraction/doc/mapping%20language/DBpedia%20Mapping%20Language.pdf here]. Please find below step-by-step tutorials on:

* [[Ontology_Editing|How to edit the ontology schema]]
* How to write
** [[Writing_Mappings/Templates|Template mappings]]
** [[Writing_Mappings/Tables|Table mappings]]

Help:Contents

2010-03-08T14:28:45Z

ChrisBizer:

This wiki contains the infobox-to-ontology and the table-to-ontology mappings which are used by the DBpedia extraction framework as well as the ontology definition itself. The framework collects the templates defined in this Wiki and extracts the Wikipedia content according to them

The Specification of the '''DBpedia Mapping Language''' can be found [http://dbpedia.svn.sourceforge.net/viewvc/dbpedia/trunk/extraction/doc/mapping%20language/DBpedia%20Mapping%20Language.pdf here]. Please find below step-by-step tutorials on:

* [[Ontology_Editing|How to edit the ontology schema]]
* How to write
** [[Writing_Mappings/Templates|Template mappings]]
** [[Writing_Mappings/Tables|Table mappings]]

Help:Contents

2010-03-08T14:27:53Z

ChrisBizer: Created page with ' The Specification of the '''DBpedia Mapping Language''' can be found [http://dbpedia.svn.sourceforge.net/viewvc/dbpedia/trunk/extraction/doc/mapping%20language/DBpedia%20Mappin...'

The Specification of the '''DBpedia Mapping Language''' can be found [http://dbpedia.svn.sourceforge.net/viewvc/dbpedia/trunk/extraction/doc/mapping%20language/DBpedia%20Mapping%20Language.pdf here]. Please find below step-by-step tutorials on:

* [[Ontology_Editing|How to edit the ontology schema]]
* How to write
** [[Writing_Mappings/Templates|Template mappings]]
** [[Writing_Mappings/Tables|Table mappings]]

Main Page

2010-03-08T14:24:24Z

ChrisBizer: /* mappings.dpedia.org */

Main Page

2010-03-08T14:24:15Z

ChrisBizer: /* mappings.dpedia.org */

Main Page

2010-03-08T14:23:57Z

ChrisBizer: /* mappings.dpedia.org */

Main Page

2010-03-08T14:08:59Z

ChrisBizer: /* Tutorials */

Main Page

2010-03-08T14:08:38Z

ChrisBizer: /* DBpedia Mappings */

Main Page

2010-03-08T14:07:47Z

ChrisBizer: /* Tutorials */

Main Page

2010-03-08T14:07:26Z

ChrisBizer: /* Tutorials */

Main Page

2010-03-08T14:06:58Z

ChrisBizer: /* Tutorials */

Main Page

2010-03-08T14:05:21Z

ChrisBizer: /* mappings.dpedia.org */

Main Page

2010-03-08T14:03:26Z

ChrisBizer: /* mappings.dpedia.org */

Main Page

2010-03-08T13:52:42Z

ChrisBizer: /* DBpedia Mappings */

Main Page

2010-03-08T13:49:48Z

ChrisBizer: /* DBpedia Mappings */

Main Page

2010-03-08T13:45:11Z

ChrisBizer: