Difference between revisions of "Manual:Semantic MediaWiki"

[quality revision][quality revision]
(Tag: 2017 source edit)
 

Scope and Terminologyterminology[edit | edit source]

Semantic MediaWiki (SMW) is a MediaWiki extension that enables you to define and query data on a wiki page.

The following steps are necessaryusually taken to work with data-based content in your wiki :

  1. Define properties: Properties determine which values can be queried in the wiki.
  2. Create a template: This creates the output format of the data set on the wiki pages.
  3. Create a form: Using this form, Wiki users can comfortably enter their data.
  4. Assign a category: Each page that contains a semantic query is usually tagged with a category that was created for this purpose. This, in addition to the attributes, provides an important means of querying and filtering the pages. It also creates a form editing mode for the wiki pages that contain this category.

Define properties[edit | edit source]

Um Informationen auf einer Wikiseite als Daten verfügbar zu machen, erstellen wir sogenannte Attribute. Wenn ich zum Beispiel Kundendaten semantisch erfassen möchte, erstelle ich pro Kunde eine Wikiseite. Auf jeder Kundenseite erfassen wir Kundendaten wie zum Beispiel den Standort. Hierzu erstelle ich ein Attribut, das festhält, welchen Standort der Kunde hat.

To make information available as data on a wiki page, we create so-called properties. For example, if we want to semantically record customer data, we create a wiki page for each customer. We collect customer data such as location on every customer page. To do this, we create a property that records the location of the customer.

[[Has location::Regensburg]]

Afterwards I can list all customers at a certain location or all customers with their associated locations in the wiki.

Create a template[edit | edit source]

Since we often want to display several such properties and their values on one page at the same time, we format a special area that clearly shows the collected page attributes. This requires a (data) template, which can then be used on any wiki page.


Semantic template
Data template


Create a form[edit | edit source]

Um die Benutzereigen bei der Eingabe der Daten zu unterstützen, erstellen wir anschließend noch ein Eingabeformular. Das Eingabeformular wird entsprechend angezeigt, wenn Benutzer in den Bearbeitungsmodus einer Wikiseite wechseln, auf der die zugehörige semantische Vorlage eingebunden ist.

To support our users with data entry tasks, we create an input form. The input form is shown when users switch to the edit mode of a wiki page that has the semantic template included.
Data entry form
Data entry form


Assign a category[edit | edit source]

Wiki pages that use semantic templates are tagged with a category. This category enables the assignment of the input form to the wiki page. The category is also used to query the data collected via the template and display it anywhere in the wiki.

Example[edit | edit source]

Auf den nächsten Seiten sehen wir uns am Beispiel von Kundendaten an, wie wir diese im Wiki sammeln und darstellen können.

On the following pages, we will create an example that collects and displays customer data it in the wiki.


Example: Collect customer data


<bookshelf src="Book:Getting started with Semantic MediaWiki" />
        
        ==Scope and Terminologyterminology==
        
        Semantic MediaWiki (SMW) is a MediaWiki extension that enables you to define and query data on a wiki page.
        
        
        
        The following steps are necessaryusually taken to work with data-based content in your wiki :
        
        
        
        #'''Define properties:''' Properties determine which values can be queried in the wiki.
        
        #'''Create a template:''' This creates the output format of the data set on the wiki pages.
        
        #'''Create a form:''' Using this form, Wiki users can comfortably enter their data.
        
        #'''Assign a category:''' Each page that contains a semantic query is usually tagged with a category that was created for this purpose.  This, in addition to the attributes, provides an important means of querying and filtering the pages. It also creates a form editing mode for the wiki pages that contain this category.
        
        
        
        
        <br /><gallery widths="380" heights="360">
        
        File:Manual:SMW-Attribute-EN.png|Semantic properties
        
        File:Manual:SMW-Vorlage-EN.png|Semantic template
        
        File:Manual:SMW-Formular-EN.png|Data entry form
        
        File:Manual:SMW-Kategorie-EN.png|Category to organize data
        
        
        </gallery>
        
        
        
        ==Define properties==
        
        
        Um Informationen auf einer Wikiseite als Daten verfügbar zu machen, erstellen wir sogenannte '''Attribute.''' Wenn ich zum Beispiel Kundendaten semantisch erfassen möchte, erstelle ich pro Kunde eine Wikiseite. Auf jeder Kundenseite erfassen wir Kundendaten wie zum Beispiel den Standort. Hierzu erstelle ich ein Attribut, das festhält, welchen '''Standort''' der Kunde '''hat.'''
            
            
            
            
        To make information available as data on a wiki page, we create so-called '''properties'''. For example, if we want to semantically record customer data, we create a wiki page for each customer. We collect customer data such as location on every customer page. To do this, we create a property that records the location of the customer.
        
         <nowiki>[[Has location::Regensburg]]</nowiki>
        
        Afterwards I can list all customers at a certain location or all customers with their associated locations in the wiki.<br />
        
        
        
        ==Create a template==
        
        Since we often want to display several such properties and their values on one page at the same time, we format a special area that clearly shows the collected page attributes. This requires a (data) template, which can then be used on any wiki page.
        
        
        
        
        <br />
        
        [[File:Manual:screenshot-Vorlage-EN.png|alt=Semantic template|center|thumb|750x750px|Data template]]
        
        
        <br />
        
        
        
        ==Create a form==
        
        
        Um die Benutzereigen bei der Eingabe der Daten zu unterstützen, erstellen wir anschließend noch ein Eingabeformular. Das Eingabeformular wird entsprechend angezeigt, wenn Benutzer in den Bearbeitungsmodus einer Wikiseite wechseln, auf der die zugehörige semantische Vorlage eingebunden ist.
            
            
            
            
        To support our users with data entry tasks, we create an input form. The input form is shown when users switch to the edit mode of a wiki page that has the semantic template included.<br />
            
            
        [[File:screenshot-Formular-EN.png|alt=Data entry form|center|thumb|500x500px|Data entry form]]
        
        
        <br />
        
        
        
        ==Assign a category==
        
        Wiki pages that use semantic templates are tagged with a category. This category enables the assignment of the input form to the wiki page. The category is also used  to query the data collected via the template and display it anywhere in the wiki.<br />
        
        
        
        ==Example==
        
        
        Auf den nächsten Seiten sehen wir uns am Beispiel von Kundendaten an, wie wir diese im Wiki sammeln und darstellen können.
            
            
            
            
        On the following pages, we will create an example that collects and displays customer data it in the wiki.
        
        
        
        
        
        
        <span class="nextstep">[[Manual:Semantic MediaWiki/Examples/Customer data|Example: Collect customer data]]</span>
        
        
        
        
        <br />
        
        
        
        [[de:Handbuch:Semantic_MediaWiki]]
        
        [[en:{{FULLPAGENAME}}]]
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<bookshelf src="Book:Getting started with Semantic MediaWiki" />
 
<bookshelf src="Book:Getting started with Semantic MediaWiki" />
==Scope and Terminology==
+
==Scope and terminology==
 
Semantic MediaWiki (SMW) is a MediaWiki extension that enables you to define and query data on a wiki page.
 
Semantic MediaWiki (SMW) is a MediaWiki extension that enables you to define and query data on a wiki page.
  
The following steps are necessary:
+
The following steps are usually taken to work with data-based content in your wiki :
  
 
#'''Define properties:''' Properties determine which values can be queried in the wiki.
 
#'''Define properties:''' Properties determine which values can be queried in the wiki.
Line 18: Line 18:
  
 
==Define properties==
 
==Define properties==
Um Informationen auf einer Wikiseite als Daten verfügbar zu machen, erstellen wir sogenannte '''Attribute.''' Wenn ich zum Beispiel Kundendaten semantisch erfassen möchte, erstelle ich pro Kunde eine Wikiseite. Auf jeder Kundenseite erfassen wir Kundendaten wie zum Beispiel den Standort. Hierzu erstelle ich ein Attribut, das festhält, welchen '''Standort''' der Kunde '''hat.'''
 
 
 
To make information available as data on a wiki page, we create so-called '''properties'''. For example, if we want to semantically record customer data, we create a wiki page for each customer. We collect customer data such as location on every customer page. To do this, we create a property that records the location of the customer.
 
To make information available as data on a wiki page, we create so-called '''properties'''. For example, if we want to semantically record customer data, we create a wiki page for each customer. We collect customer data such as location on every customer page. To do this, we create a property that records the location of the customer.
 
  <nowiki>[[Has location::Regensburg]]</nowiki>
 
  <nowiki>[[Has location::Regensburg]]</nowiki>
Line 32: Line 30:
  
 
==Create a form==
 
==Create a form==
Um die Benutzereigen bei der Eingabe der Daten zu unterstützen, erstellen wir anschließend noch ein Eingabeformular. Das Eingabeformular wird entsprechend angezeigt, wenn Benutzer in den Bearbeitungsmodus einer Wikiseite wechseln, auf der die zugehörige semantische Vorlage eingebunden ist.
+
To support our users with data entry tasks, we create an input form. The input form is shown when users switch to the edit mode of a wiki page that has the semantic template included.<br />[[File:screenshot-Formular-EN.png|alt=Data entry form|center|thumb|500x500px|Data entry form]]
 
 
To support our users with data entry tasks, we create an input form. The input form is shown when users switch to the edit mode of a wiki page that has the semantic template included.<br />
 
[[File:screenshot-Formular-EN.png|alt=Data entry form|center|thumb|500x500px|Data entry form]]
 
 
<br />
 
<br />
  
Line 42: Line 37:
  
 
==Example==
 
==Example==
Auf den nächsten Seiten sehen wir uns am Beispiel von Kundendaten an, wie wir diese im Wiki sammeln und darstellen können.
 
 
 
On the following pages, we will create an example that collects and displays customer data it in the wiki.
 
On the following pages, we will create an example that collects and displays customer data it in the wiki.
  

Attachments

Discussions