|
|
| (One intermediate revision by one other user not shown) |
| Line 1: |
Line 1: |
| == How to map a Wikipedia template ==
| | #REDIRECT [[How to edit DBpedia Mappings]] |
| | |
| * 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 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''
| |
