Quelltext der Seite Hilfe:Semantisches Wiki

{{Bildwegweiser | Titel = [[:Kategorie:Hilfe|Hilfe]] | Größe = 35px | Hilfe }}
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 [http://semantic-mediawiki.org/wiki/File:SMW_quick_reference.pdf Kurzreferenz ([[Datei:Flag_icon_en.png|link=]]) ]. Eine ausführliche Dokumentation hingegen hält [http://semantic-mediawiki.org/wiki/Help:Einführung_in_Semantic_MediaWiki semantic-mediawiki.org] bereit.

__INHALTSVERZEICHNIS__

== Beziehungen in einem Semantischen Wiki ==
{{Semantische Beziehungen}}

== Syntaxbeispiele ==

Abfragen werden u.a. bewältigt mit:
* <nowiki>{{#ask:...}}</nowiki> und [http://semantic-mediawiki.org/wiki/Help:Inline_queries#Standard_parameters_for_inline_queries diversen Funktionsparametern]
* <nowiki>{{#show:...}}</nowiki>
Folgende einfache Beispiele sollen die Funktionsweise verdeutlichen:
* <nowiki>{{#ask: [[Kategorie:Literatur]] | format = count}}</nowiki> → {{#ask: [[Kategorie:Literatur]] | format = count}}
* <nowiki>{{#ask: [[-Zitat::+]] | format = count}}</nowiki> → {{#ask: [[-Zitat::+]] | format = count}} (mit „inverser“ Abfrage durch <nowiki>[[-Attribut::…]]</nowiki>)
* <nowiki>{{#ask: [[-Zitat::+]] | format = list | limit = 10}}</nowiki> <br />{{#ask: [[-Zitat::+]] | format = list | limit = 10}}
* <nowiki>{{#ask: [[{{SEITENNAME}}]] | ?Hat Literaturverzeichnis#1,0=}}</nowiki> → gibt 0 oder 1 zurück
* Hilfe ist in <nowiki>{{#ask: [[Hilfe:Start]] | ?Kategorie= | intro = Kategorie_ | default = keiner Kategorie}}</nowiki> <br />Hilfe ist in {{#ask: [[Hilfe:Start]] | ?Kategorie= | intro = Kategorie_ | default = keiner Kategorie}}

=== Attribut definieren ===

Mit <code><nowiki>[[Attributname::Attributwert]]</nowiki></code> wird generell eine Zuordnung gemacht:
 <nowiki>[[Internsetseite::http://semantic-mediawiki.org| ]]</nowiki> versteckt
 <nowiki>[[Internsetseite::http://semantic-mediawiki.org|]]</nowiki> ?Fehler
 <nowiki>[[Internsetseite::http://semantic-mediawiki.org]]</nowiki> sichtbar
 <nowiki>[[Internsetseite::http://semantic-mediawiki.org| Alternativtext]]</nowiki> sichtbar
 <nowiki>[[Internsetseite :: http://semantic-mediawiki.org]]</nowiki> ?keine semantische Definition

{{Logo | Typ = Tipp}} Beispiel: mehrere Werte zuweisen.
{{Hidden
 | style = border: 1px dotted;border-radius:4px
 | contentstyle = border-top: 1px dotted; padding:0.25em;
 | 1=Werte mit <code>#arraymap</code> zuweisen …
| 2=<source lang="html4strict">
{{#arraymap:Werteliste|,|x|[[Stichwort::x]]}}<!-- Komma-getrennte Werte -->
{{#arraymap:Werteliste|,|x|[[Stichwort::x]]|&#32;•&#32;}}<!-- Ausgabe: Wert • Wert • Wert -->
{{#arraymap:Werteliste|,|x|[[Stichwort::x| ]]|}}<!-- versteckte Definition -->
</source>
}}<!-- Hidden Ende -->

==== Datenintervalle ====

… (von-bis Angaben)

=== Kategorien/Namensräume anzeigen ===

Fragt man Kategorien ab, werden ''alle'' Unterkategorien mitgezählt. Bei <nowiki>{{PAGESINCATEGORY: Kategorie}}</nowiki> ist das Ergebnis jedenfalls anders.
<pre style="border:none;">
 {{#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}}
</pre>
Diverse vordefinierte Formate siehe [http://semantic-mediawiki.org/wiki/Help:Inline_queries#Standard_parameters_for_inline_queries semantic-mediawiki.org].

=== Seiten transkludieren ===

Mit der ask-Funktion und <code>format = embedded</code> ist so einiges möglich und der Seiten Titel wird als &lt;h1>-Überschrift mit hinzugefügt. Diese automatisch gesetzte Überschrift unterdrückt man, durch <code>embedonly = yes</code>. Bei gesetzten Kategorien jedoch muss man aufpassen, da sie mit übernommen werden. Ausschließen kann man sie mit einem <nowiki><noinclude>…</nowiki> 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 <code><nowiki>[[SMW::On]]</nowiki></code> für an und mit <code><nowiki>[[SMW::Off]]</nowiki></code> 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.

{{Logo | Typ = Tipp}} Beispiel: finde alle Zitat-Schlüssel auf einer Seite und transkludiere sie. Dies  geht ''nur'' mit inverser Suche durch ein Minus <nowiki>[[-Attribut::Seitenname]]</nowiki>.{{Hidden
| style = border: 1px dotted;border-radius:4px
| contentstyle = border-top: 1px dotted;padding:0.8em;
| 1=Zitat-Schlüssel (=Seiten) auslesen &amp; einbinden…
| 2=
<source lang="html4strict">
<!-- Kommentar: Zitat-Schlüssel (=Seiten) auslesen & einbinden -->
{{#ask:  [[-Zitat::Fliegen und Mücken – Diptera (Familienübersicht)]]
 | format = embedded <!-- einbinden einschließlich der semantischen Attribute -->
 | embedonly = yes
}}</source>
Die Zitatschlüssel (z.B. versteckt <code><nowiki>[[Zitat::Schubert & Wagner 1993| ]]</nowiki></code>) müssen natürlich vorher auf den entsprechenden Seiten gesetzt worden sein.
}}

{{Logo | Typ = Tipp}} Beispiel: Glossarseiten zusammenfassen.
{{Hidden
| style = border: 1px dotted;border-radius:4px
| contentstyle = border-top: 1px dotted; padding:0.8em;
| 1=Glossarseiten auslesen &amp; einbinden…
| 2=
<source lang="html4strict">
{{#ask: <!-- Suchkriterien… -->
  [[Kategorie:Zoologischer Fachausdruck]] <!-- +Buchstabe aus Glossar:Fauna/… -->
  [[Seitenname::~M*]] <!-- M kann auch extrahiert werden mit: {{#titleparts: {{FULLPAGENAME}} | 2 | 2 }} -->
 |format = embedded <!-- embedded: Seiten lesen -->
 |embedonly= yes <!-- ohne Titel, NUR einbinden -->
 |default = {{Ombox | text = Keine Fachausdrücke gefunden.}}<!-- Falls nichts gefunden -->
}}
</source>
In Vorlagen eingetragene Attribute werden erst aktiv nach neuem speichern (1-2x). Finden sich in den Seiten auch <nowiki>{{SORTIERUNG: }}</nowiki>-Definitionen, kann eine Warnmeldung kommen wie…<br />
<span class="error">Achtung: Der Sortierungsschlüssel „Aehrenspindel“ überschreibt den vorher verwendeten Schlüssel „Aehrchen“.</span>

Lösung ist &lt;noinclude><nowiki>{{SORTIERUNG: }}</nowiki> zu schreiben.
{{#ask: <!-- Suchkriterien… -->
  [[Kategorie:Zoologischer Fachausdruck]] <!-- +Buchstabe aus Glossar:Fauna/… -->
  [[Seitenname::~M*]] <!-- M kann auch extrahiert werden mit: {{#titleparts: {{FULLPAGENAME}} | 2 | 2 }} -->
 |format = embedded <!-- embedded: Seiten lesen -->
 | embedonly= yes <!-- ohne Titel, NUR einbinden -->
 |default = {{Ombox | text = Keine Fachausdrücke gefunden.}}<!-- Falls nichts gefunden -->
}}}}

==== Vorlagen einbinden ====

Interessant ist der Parameter <code>format = embedded</code>, 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 wie viele Parameter man selbst in der eigenen Vorlage bestimmt hat. Mit <code>template = meine Vorlage</code> ist dies dann möglich. Um Seiten einfach mit HTML-Tags zu umschließen (wrappen) wurde die [[Vorlage: WrapPageInHtmlElement| Vorlage WrapPageInHtmlElement]] entwickelt.

{{Logo | Typ = Tipp}} Beispiel: Seiten &amp; Vorlagen verbinden.{{Hidden
| style = border: 1px dotted;border-radius:4px
| contentstyle = border-top: 1px dotted;padding:0.8em;
| 1=Zitat-Schlüssel für Literaturverzeichnis auslesen …
| 2=Siehe [[Vorlage:Literaturdaten]]. Diese Vorlage nutzt eine Abfrage, wobei die Ergebnisse als numerische Vorlagenparameter übergeben werden und in der Vorlage entsprechend formatiert werden können. Beispielabfrage:
<source lang="html4strict">
{{#ask: [[-Zitat::Fliegen und Mücken – Diptera (Familienübersicht)]]
      |format=template
      |template=Formatierte Literaturausgabe für ask
      |mainlabel=-
      |link=none
      |?#=<!-- {{{1}}} -->
      |?Autorenschaft#=<!-- {{{2}}} -->
      |?Herausgeberschaft#=<!-- {{{3}}} -->
      |?Titel#=<!-- {{{4}}} -->
      |?Originaltitel#=<!-- {{{5}}} -->
      |?Originalsprache#=<!-- {{{6}}} -->
      |?Übersetzerschaft#=<!-- {{{7}}} -->
      |?Tag#=<!-- {{{8}}} -->
      |?Monatsname#=<!-- {{{9}}} -->
      |?Jahr#YYYY=<!-- {{{10}}} -->
      |?Sammelwerk#=<!-- {{{11}}} -->
      |?Verlag#=<!-- {{{12}}} -->
      |?Ort#=<!-- {{{13}}} -->
      |?Literaturangabe in Freiform#=<!-- {{{14}}} -->
      |?Auflage#=<!-- {{{15}}} -->
      |?Band#=<!-- {{{16}}} -->
      |?Literaturangabe Nummer#=<!-- {{{17}}} -->
      |?Seiten#=<!-- {{{18}}} -->
      |?Spalten#=<!-- {{{19}}} -->
      |?Kapitel#=<!-- {{{20}}} -->
      |?ISBN#=<!-- {{{21}}} -->
      |?ISBN ist formal falsch#=<!-- {{{22}}} -->
      |?ISSN#=<!-- {{{23}}} -->
      |?arxiv#=<!-- {{{24}}} -->
      |?DOI#=<!-- {{{25}}} -->
      |?LCCN#=<!-- {{{26}}} -->
      |?PMID#=<!-- {{{27}}} -->
      |?OCLC#=<!-- {{{28}}} -->
      |?Lizenznummer#=<!-- {{{29}}} -->
      |?Quelle#=<!-- {{{30}}} -->
      |?Kommentar#=<!-- {{{31}}} -->
      |?Online#=<!-- {{{32}}} -->
      |?Letzter Zugriff#=<!-- {{{33}}} -->
      |?Literaturtyp#=<!-- {{{34}}} -->
      }}</source><span class="error">Klappt nicht, da formatierte Links übergeben werden! Erst mit <code>link = none</code> funktioniert es!</span>
{{#ask:  [[-Zitat::Fliegen und Mücken – Diptera (Familienübersicht)]]
| format   = template
| template = WrapPageInHtmlElement{{!}}class=highlight <!-- Vorlagen-Parameternamen: ?nur statische Zuweisung mgl. -->
}}
}}<!-- Hidden Ende -->

== 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 [http://smwforum.ontoprise.com/smwforum/index.php/Defining_Semantic_Forms Semantik Enterprise Wiki-Seite]. Das Formular kann dann für eine Kategorie angeschaltet werden, indem man auf eben jener Kategorieseite das Attribut einträgt: <code><nowiki>[[Hat Standardformular::…]]</nowiki></code>. Sodann wird auf allen diesen Kategorieseiten das abgerufen, was auf den [[Spezial:Forms|Definitionsseiten der Formulare]] steht.

{{Logo | Typ = Tipp}} Beispiel: Formularfelder.{{Hidden
| style = border: 1px dotted;border-radius:4px
| contentstyle = border-top: 1px dotted;padding:0.8em;
| 1 = Formularfelder definieren&nbsp;…
| 2 =
<source lang="html4strict">
<!-- Textfeld mit Autovervollständigung über Attribut:Autoren kommagetrennt (auch bei textarea) -->
  {{{field|Autor|size=100|autocomplete on property=Autoren|list|delimiter=,|input type=text}}}
<!-- Pflichtfeld mandatory -->
  {{{field|Titel|mandatory|input type=textarea|rows=3|cols=100}}}
<!-- Auswahlliste -->
  {{{field|Wochentag|values=1, 2, 3, 4, 5, 6, 7}}}
</source>
}}

== Daten auslesen und anzeigen ==
=== Datenseiten und Filter ===

----
ZUTUN: {{Prozentstatus der Aufgabe|Veraltete Dokumentation aktualisieren|0%|seit Semantic Drilldown 2.0 ist die Filterhandhabung verändert (s. [https://www.mediawiki.org/wiki/Extension:Semantic_Drilldown/Version_history englische Versionschronik daselbst])}}
----

[[Spezial:Daten_browsen|Datenseiten]] stellt die {{Abk.|SMW}}-Erweiterung [http://www.mediawiki.org/wiki/Extension:Semantic_Drilldown Semantic Drilldown] bereit. [[Spezial:Filter erstellen|Erstellt man einen Filter]] und wird der Filter selbst in der Top-Kategorieseite mit <code><nowiki>[[Hat Filter::Filter:erstellter Name des Filters]]</nowiki></code> eingebunden, dann erscheint beim durchstöbern dieser Top-Kategorieseite auf der [[Spezial:Daten browsen|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, wie viele 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 <code><nowiki>[[Hat Bezeichnung::Abweichender Name des Filters]]</nowiki></code>. Um Verwirrung bei der Attribut-Zuordnung zu vermeiden, bietet es sich an der Konvention ''Attributname''&nbsp;=&nbsp;''Filtername'' zu folgen.

=== Abfrageformulare ===

{{rechts|1=<div class="toc">→&nbsp;[[:Kategorie: Suchformular|Kategorie:<br />Suchformular]]</div>}}
Ein Formular zusammen mit einer ''gleichnamigen'' Vorlage kann auf Spezial:Abfrage ausführen benutzt werden (z.B. [[Spezial:Abfrage_ausführen/Literatur_nachschlagen|um Literatur nachzuschlagen]]. Die Vorlage muss die #ask/#show Abfrage enthalten und die Vorlagenparameter müssen im gleichnamigen Formular definiert sein, da das Formular die Werte an die Vorlage weiterreicht. Beispiel:
* [[Formular:Literatur nachschlagen]]
* [[Vorlage:Literatur nachschlagen]]

=== 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: „{{int:smw_purge}}“ 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“

[[Kategorie:Hilfe]]
[[Kategorie:Semantisches Wiki]]
{{SORTIERUNG: Semantisches Wiki}}