Hilfe:Semantisches Wiki

From Offene Naturführer
Jump to: navigation, search

Hier entsteht eine Seite/Werkstatt vorerst für Fortgeschrittene Wiki-Nutzer, um den Umgang mit semantischer Wiki-Syntax knapp und klar mit Anwendungsbeispielen zu beleuchten, also eine Art Kurzreferenz (Flag icon en.png) . Eine ausführliche Dokumentation hingegen hält semantic-mediawiki.org bereit.

Beziehungen in einem Semantischen Wiki

 

               Tipps Datentyp (Type) ·······─>······· Attribut (Property)
                 ↓ wichtig für Da-                                    ↓
                 ↓ tenauswertungTipps Beispiele
Maß ──────────────────────┐                                ┌─ Internetseite [[Internetseite::http://www.web.de]]
Datum ────────────────────┤                                ├─ Geografische Koordinaten
E-Mail ───────────────────┤                                ├─ Fläche
Geografische Koordinaten ─┤                                ├─ Länge, Breite [[Länge:: 3mm]]
Quellcode ────────────────┤                                ├─ Datentyp      → Attribut hat „Sonderfunktionen“
Seite ────────────────────┤     Zuweisung zu Attributen    ├─ Entspricht    [[Entspricht::1m², Quadratmeter]]
Temperatur ───────────────┼─>─  attributum: < lateinisch ─>┼─ Jahr
Text ─────────────────────┤     das beigelegte (Merkmal)   ├─ Journal
URI-Annotation ───────────┤     ························   ├─ Projektstatus [[Projektstatus::aktiv| ]] (verborgen)
URL ──────────────────────┤     #ask-Formate,ParameterWahrheitswert ────────────┤                                …
Zahl ─────────────────────┤                                ├─   Tipps Semantik MediaWiki,
Zeichenkette ─────────────┤                                └─     Institut für Angewandte Informatik
Verbund ──────────────────┤
Telefonnummer ────────────┘
                 ↑                                                    ↑
               Tipps Datentyp (Type) ·······─>······· Attribut (Property)
                 ↓                                                    ↓
                Suchen/Finden                                                  Suchen/Finden
Spezial:Datentypen (Special:Types)                           Spezial:Attribute (Special:Properties)
                                                             besondere/spezielle Attribute
                                                           + Attribute erstellen

 


Syntaxbeispiele

Abfragen werden u.a. bewältigt mit:

Folgende einfache Beispiele sollen die Funktionsweise verdeutlichen:

Attribut definieren

Mit [[Attributname::Attributwert]] wird generell eine Zuordnung gemacht:

[[Internsetseite::http://semantic-mediawiki.org| ]] versteckt
[[Internsetseite::http://semantic-mediawiki.org|]] ?Fehler
[[Internsetseite::http://semantic-mediawiki.org]] sichtbar
[[Internsetseite::http://semantic-mediawiki.org| Alternativtext]] sichtbar
[[Internsetseite :: http://semantic-mediawiki.org]] ?keine semantische Definition

Tipps Beispiel: mehrere Werte zuweisen.

Werte mit #arraymap zuweisen …

Datenintervalle

… (von-bis Angaben)

Kategorien/Namensräume anzeigen

Fragt man Kategorien ab, werden alle Unterkategorien mitgezählt. Bei {{PAGESINCATEGORY: Kategorie}} ist das Ergebnis jedenfalls anders.

 {{#ask: [[Hilfe:+]]  | default = Keine Hilfeseite gefunden.}} → alle Hilfeseiten
 {{#ask: [[Spezial:+]] }} → klappt nicht
 {{#ask: [[Kategorie:Zoologischer Fachausdruck]]  | default = Keine Kategorie gefunden.}}
 {{#ask: [[Kategorie:Zoologischer Fachausdruck]]  | default = Keine Kategorie gefunden. | format = table}}

Diverse vordefinierte Formate siehe semantic-mediawiki.org.

Seiten transkludieren

Mit der ask-Funktion und format = embedded ist so einiges möglich und der Seiten Titel wird als <h1>-Überschrift mit dazugefügt. Diese automatisch gesetzte Überschrift unterdrückt man, durch embedonly = yes. Bei gesetzten Kategorien jedoch muß man aufpassen, da sie mit übernommen werden. Ausschließen kann man sie mit einem <noinclude>… davor. Attribute, die in den einzulesenden Seiten definiert sind, werden i.d.R. nicht mit übernommen. Man kann dies ändern durch explizites an und ausschalten der semantischen Funktionalität mit [[SMW::On]] für an und mit [[SMW::Off]] für aus. Auf diese Weise können Attribute dann auch auf transkludierten Seiten aktiviert werden. Unter Spezial:Vorlagen_expandieren kann man die generierte Syntax einsehen.

Tipps Beispiel: finde alle Zitat-Schlüssel auf einer Seite und transkludiere sie. Dies geht nur mit inverser Suche durch ein Minus [[-Attribut::Seitenname]].
Zitat-Schlüssel (=Seiten) auslesen & einbinden…

Tipps Beispiel: Glossarseiten zusammenfassen.

Glossarseiten auslesen & einbinden…

Vorlagen einbinden

Interessant ist der Parameter format = embedded, was den Inhalt transkludiert, den man zusätzlich noch eingeschränkt formatieren kann. Man kann die Ausgabe auch mit eigenen Vorlagen verbinden, wobei die Ergebnisse automatisch den eigenen Vorlagen-Parametern 1, 2, usw. übergeben werden. Je nachdem wieviele Parameter man selbst in der eigenen Vorlage bestimmt hat. Mit template = meine Vorlage ist dies dann möglich. Um Seiten einfach mit HTML-Tags zu umschließen (wrappen) wurde die Vorlage WrapPageInHtmlElement entwickelt.

Tipps Beispiel: Seiten & Vorlagen verbinden.
Zitat-Schlüssel für Literaturverzeichnis auslesen …

Formulare erstellen

Die Wikiseite Spezial:CreateForm stellt einen Assistenten bereit, um Formulare neu zu erstellen. Eine Hilfestellung, um diese dann anzupassen, findet man auf der englischen Semantik Enterprise Wiki-Seite. Das Formular kann dann für eine Kategorie angeschaltet werden, indem man auf eben jener Kategorieseite das Attribut einträgt: [[Hat Standardformular::…]]. Sodann wird auf allen diesen Kategorieseiten das abgerufen, was auf den Definitionsseiten der Formulare steht.

Tipps Beispiel: Formularfelder.
Formularfelder definieren …

Daten auslesen und anzeigen

Datenseiten und Filter

Datenseiten stellt die SMW-Erweiterung Semantic Drilldown bereit. Erstellt man einen Filter und wird der Filter selbst in der Top-Kategorieseite mit [[Hat Filter::Filter:erstellter Name des Filters]] eingebunden, dann erscheint beim durchstöbern dieser Top-Kategorieseite auf der Datenseite zusätzlich eine Zeile mit diesem Filter. Die Reihenfolge der Filter auf der jeweiligen Top-Kategorieseite bestimmt die Reihenfolge auf der Seite, wo die Daten gelistet werden.

Filter erlauben es zu sehen, wieviele Seiten es zu einem bestimmten Filter gibt. Ein Filter wiederum kann auf einem Attribut basieren. Ein Beispiel ist Spezial:Daten browsen/Alle Bestimmungsschlüssel mit dem Filter:Zielgruppe.

Den Titel eines Filters ändert um mit [[Hat Bezeichnung::Abweichender Name des Filters]]. Um Verwirrung bei der Attribut-Zuordnung zu vermeiden, bietet es sich an der Konvention Attributname = Filtername zu folgen.

Abfrageformulare

Ein Formular zusammen mit einer gleichnamigen Vorlage kann auf Spezial:Abfrage ausführen benutzt werden (z.B. um Literatur nachzuschalgen. Die Vorlage muss die #ask/#show Abfrage enthalten und die Vorlagenparameter müssen im gleichnamigen Formular definiert sein, da das Formaluar die Werte an die Vorlage weiterreicht. Beispiel:

Abfragen unmittelbar filtern

Siehe http://semantic-mediawiki.org/wiki/Help:Filtered_format

Häufige Probleme

Die Daten der Seite erscheinen nicht in der Abfrage

Die Attribut-Daten der Seite müssen aufgefrischt werden. Mögliche Problemlösungen:

  • Aktions-Menü der Seite: „Refresh“ ausführen oder
  • Seite im Editmodus öffnen und gleich wieder abspeichern
  • global für alle noch aufzufrischenden Daten: Spezial:SMW-Administration s. Abschnitt „Datenreparatur oder -aktualisierung“