Difference between revisions of "Manual:Semantic MediaWiki"

[unchecked revision][quality revision]
(Created page with "==Scope and Terminology== Semantic MediaWiki (SMW) is a MediaWiki extension that enables you to define and query data on a wiki page. The following steps are necessary: #'''...")
 
(Tag: 2017 source edit)

Scope and Terminology[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 necessary:

  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.
alternativtext=Semantische Vorlage|zentriert|mini|750x750px| Datenvorlage

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.
alternativtext=Eingabeformular|zentriert|mini|500x500px|Eingabeformular

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


==Scope and Terminology==
        
        Semantic MediaWiki (SMW) is a MediaWiki extension that enables you to define and query data on a wiki page.
        
        
        
        The following steps are necessary:
        
        
        
        #'''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 />
        
        [[DateiFile:screenshot-Vorlage.png|alternativtext=Semantische Vorlage|zentriert|mini|750x750px|Datenvorlage]]
        
        
        <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 />
        
        [[DateiFile:screenshot-Formular.png|alternativtext=Eingabeformular|zentriert|mini|500x500px|Eingabeformular]]
        
        
        <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}}]]
Line 8: Line 8:
 
#'''Create a form:''' Using this form, Wiki users can comfortably enter their data.
 
#'''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.
 
#'''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==
 
==Define properties==
Line 18: Line 25:
 
==Create a template==
 
==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 />
 
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 />
[[Datei:screenshot-Vorlage.png|alternativtext=Semantische Vorlage|zentriert|mini|750x750px|Datenvorlage]]
+
[[File:screenshot-Vorlage.png|alternativtext=Semantische Vorlage|zentriert|mini|750x750px|Datenvorlage]]
 
<br />
 
<br />
  
Line 25: Line 32:
  
 
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 />
 
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 />
[[Datei:screenshot-Formular.png|alternativtext=Eingabeformular|zentriert|mini|500x500px|Eingabeformular]]
+
[[File:screenshot-Formular.png|alternativtext=Eingabeformular|zentriert|mini|500x500px|Eingabeformular]]
 
<br />
 
<br />
  
Line 40: Line 47:
  
 
<br />
 
<br />
 +
 +
[[de:Handbuch:Semantic_MediaWiki]]
 +
[[en:{{FULLPAGENAME}}]]

Attachments

Discussions