Quelltext der Seite Vorlage:Glossareintrag/doc

{{Documentation/subpage}}
== Benutzung ==

Glossareinträge werden in den Kategorien [[:Kategorie:Botanischer Fachausdruck|Botanischer Fachausdruck]] und in [[:Kategorie:Zoologischer Fachausdruck|Zoologischer Fachausdruck]] gesammelt. Im allgemeinen wird diese Kategorie als Teil des Glossareintrags gesetzt:

 | Kategorie = Zoologischer Fachausdruck

Auf Dauer sind Unterkategorien (Entomologischer Fachausdruck, Mykologischer Fachausdruck, etc.) sinnvoll und erwünscht. Werden dabei mehrere Glossareinträge auf einer Seite platziert, so vergibt man zusätzlich den Parameter:
 | Inline = 1
…&nbsp;der die Navigation unterdrückt.

=== Glossar===

Neben der Definitionsliste in Wiki-Syntax (Zeilenanfang mit Semikolon&nbsp;…&nbsp;Doppelpunkt) gibt es in der {{#titleparts:  {{FULLPAGENAME}}| 1 }} die Möglichkeit Definitionslisten eine abweichenden Formatierung zu verleihen. Auf den Glossarseiten steht je ein Formular zur Bearbeitung zur Verfügung.
Als Parameter verwendet die Vorlage:
* '''Begriff''' = eigentlicher Begriff
* '''Auch''' = „synonymer“ Begriff (im allgemeinen wurde von diesem unter „Auch=…“ angegebenen Begriff mittels Parameter "Siehe" verwiesen)
<tt>┌─</tt>  '''Definition''' = Knappe Erklärung <br/><!-- 
--> <tt>│ </tt> optional '''Zusatzinformationen''' = ausführlichere Informationen (können auch Bilder enthalten)<br/><!-- 
--> <tt>↑ </tt> optional '''Mögliche Zustände''' = Mögliche Zustände oder Ausformungen von z.B. Merkmalen (Semikolon saperierte Liste)<br/><!-- 
-->oder<br/><!-- 
--> <tt>↓</tt><br/><!-- 
--> <tt>└─</tt> '''Siehe''' = direkter Verweis auf die tatsächliche Definitionsseite (Definition/Zusatzinformationen müssen leer bleiben, werden nicht angezeigt)
* '''Siehe auch''' = Verweise auf thematisch verwandte Begriffe (keine synonymen Begriffe!)
* '''Quellen''' = Angabe von Quellen (wörtliches Abschreiben ist eine Urheberrechtsverletzung!!)
* '''Kategorie''' = Botanischer Fachausdruck, Zoologischer Fachausdruck, etc.
*: Das Kategoriefeld sollte leer bleiben, wenn die Vorlage innerhalb einer geschlossenen Arbeit verwendet wird, der Begriff also hier in "Originalzustand" definiert wird. 
* '''Inline''' = irgendein Wert, z.B. „1“ oder „ja“ d.h. wenn mehrere Einträge auf einer Seite sind, wird dadurch die Navigation unterdrückt
* Bis zu vier Bilder können zu Unterstützung der Definition angegeben werden. Im allgemeinen sollte man sich auf ein oder zwei Bilder beschränken, da Glossareinträge ein Thema knapp und übersichtlich definieren sollen. Wenn mehr als 4 Bilder nötig sind, sollte auf eine separate Seite verwiesen werden.
*# '''Bild a''' = Datei:xya.jpg<br/><!-- 
-->'''Beschriftung a''' = Bildunterschrift zu Bild a
*# '''Bild b''' = Datei:xyb.jpg<br/><!-- 
-->'''Beschriftung b''' = Bildunterschrift zu Bild b
*# '''Bild c''' = Datei:xyc.jpg<br/><!-- 
-->'''Beschriftung c''' = Bildunterschrift zu Bild c
*# '''Bild d''' = Datei:xyd.jpg<br/><!-- 
-->'''Beschriftung d''' = Bildunterschrift zu Bild d
* '''Bildbreite''' = Standard ist 180
----

Hier können Sie über ein Formular neue Begriffe eingeben:
{{#forminput:form=Glossareintrag
  |button text=… als Botanischen Fachausdruck bearbeiten
  |size=50
  |query string=Glossareintrag[Kategorie]=Botanischer Fachausdruck
  |autocomplete on category = Botanischer Fachausdruck
  |remote autocompletion 
  |no autofocus
}}
{{#forminput:form=Glossareintrag
  |button text=… als Zoologischen Fachausdruck bearbeiten
  |size=50
  |query string=Glossareintrag[Kategorie]=Zoologischer Fachausdruck
  |autocomplete on category = Zoologischer Fachausdruck
  |remote autocompletion
  |no autofocus
}}

== Benutzung im Detail ==
So ergibt:

<blockquote>
<code><pre><nowiki>
{{Glossareintrag 
 | Begriff    = Ährchen
 | Definition = Die einzelnen, einen zusammengesetzten Blütenstand bildenden Ähren.
 | Quellen    = Quelle: {{Zitat |Foerster 2008}}
}}
</nowiki></pre></code>
</blockquote>
{{Glossareintrag 
 | Begriff    = Ährchen
 | Definition = Die einzelnen, einen zusammengesetzten Blütenstand bildenden Ähren.
 | Quellen    = Quelle: {{Zitat |Foerster 2008}}
}}

=== Synonyme / Ähnliche Begriffe ===

Der Eintrag …
<blockquote>
<pre>
 <nowiki>{{Glossareintrag 
 | Begriff    = Begriff
 | Auch       = Synonymer Begriff, auf den verwiesen wurde
 | Definition = Vollständige Erklärung
 | Siehe auch = Querverweis: Ähnlicher oder übergeordneter Begriff
}}</nowiki>
</pre>
</blockquote>
… ergibt …
<blockquote>
{{Glossareintrag 
 | Begriff    = Begriff
 | Auch       = Synonymer Begriff, auf den verwiesen wurde
 | Definition = Vollständige Erklärung
 | Siehe auch = Wikiseite
}}
</blockquote>

=== Siehe-Einträge ===
„Siehe“-Einträge sind von „Siehe auch“-Einträgen zu unterscheiden. Bei „Siehe“ entfällt die Definition, aber nicht bei „Siehe auch“. Beispiel:
<blockquote>
<pre>
{{Glossareintrag 
 | Begriff = Ähre
 | Siehe   = Blütenstand
}}
</pre>
</blockquote>
… ergibt …
<blockquote>
{{Glossareintrag 
 | Begriff = Ähre
 | Siehe   = Blütenstand
}}
</blockquote>

… oder falls der Begriff auf ''derselben'' Seite steht kann man auch die Link Syntax <nowiki>[[…]]</nowiki> verwenden:
<blockquote>
<pre>
{{Glossareintrag 
 | Begriff = Ähre
 | Siehe   = [[#Blütenstand|Blütenstand]]
}}
</pre>
</blockquote>

Zu vermeiden&nbsp;– aber möglich&nbsp;– ist das Weglassen der Feldnamen, wie die Kurzform zeigt:
<blockquote>
<pre>
 <nowiki>{{Glossareintrag | Ährchen | Die einzelnen, einen zusammengesetzten Blütenstand bildenden Ähren }}</nowiki>
</pre>
</blockquote>

Dabei gilt: die Form ''mit'' Angabe der Feldnamen ist hier sicherer, da sie in ''jedem'' Falle funktioniert, auch wenn im Begriff oder der Definition ein »=«-Zeichen vorkommen muß.

== Technische Dokumentation ==

Die Vorlage fragt mit Hilfe der semantischen Wikifunktion #ask Glossareinträge aus den entsprechenden Kategorien ab und gliedert sich wie folgt (falls Änderungen bitte hier dann auch):
 Glossareintrag mit Unterseiten:
   ├ [[Vorlage:Glossareintrag/Datensätze_holen |/Datensätze_holen]]: alle Datensätze mit [[Hilfe:Semantisches Wiki |#ask-Semantik]] holen + [[Vorlage:Literaturverzeichnis|<nowiki>{{Literaturverzeichnis}}</nowiki>]]
   ·  ├ [[Vorlage:Glossareintrag/Datensätze |/Datensätze]]:    einzelne Seiten transkludieren als Vorlage für [[Hilfe:Semantisches Wiki |#ask]] + Zitate neu setzen
   ·  ├ [[Vorlage:Glossareintrag/Leer |/Leer]]:          nichts gefunden
   ·  └ [[Vorlage:Glossareintrag/Fuß |/Fuß]]:           Fußteil
   ├ [[Vorlage:Glossareintrag/Vorgabe |/Vorgabe]]:          Vorgabe-Seite für neue Einträge
   └ [[Vorlage:Glossareintrag/Zustand für Tabelle |/Zustand für Tabelle]]: Merkmalsausprägung/Zustand (in Tabellenform: einzelne Tabellenzeile)

Die eigentliche ask-Abfrage dabei ist <code><nowiki>[[Kategorie:Zoologischer Fachausdruck]] [[Seitenname::~A*]]</nowiki></code>, jedoch wird der Buchstabe (A im Beispiel) durch den letzten Teil des Seitentitels über <nowiki>{{#titleparts: }}</nowiki> geliefert. Für das Vorgabe-Formular wird folgender Wiki-Code verwendet:
<source lang="html4strict">
<inputbox>
    type        = create
    break       = no
    preload     = Vorlage:Glossareintrag/Vorgabe
    default     = Begriff
    buttonlabel = …als neuen Fachausdruck?
</inputbox>
</source>

Es können Fehlermeldungen beim Transkludieren von Seiten kommen wie:
<span class="error">Achtung: Der Sortierungsschlüssel „Aehrenspindel“ überschreibt den vorher verwendeten Schlüssel „Aehrchen“.</span>
Die Lösung ist &lt;noinclude><nowiki>{{SORTIERUNG: …}}&lt;/noinclude></nowiki> am Ende der Seite zu schreiben. Die Sortierung scheint trotzdem zu stimmen.

=== Semantik MediaWiki ===

{| class="wikitable sortable"
|+ Verknüpfungen von Vorlagen-Parameter und Eigenschaft (Attribut)
|-
! Vorlagen-Parameter !! Eigenschaft (Attribut)
|-
| Begriff || [[Attribut:skos:prefLabel]]
|-
| Auch || [[Attribut:skos:altLabel]]
|-
| Definition || [[Attribut:skos:definition]]
|-
| Zusatzinformationen || [[Attribut:skos:notes]]
|-
| Mögliche Zustände || ??
|-
| Siehe || [[Attribut:skos:closeMatch]]
|-
| Siehe auch || [[Attribut:rdfs:seeAlso]]
|-
| Quellen || [[Attribut:dcterms:source]]
|-
| Bild a (etc.) || [[Attribut:imageRef]], ??[[Attribut:imageRef a]] etc.
|-
| Beschriftung a (etc.) || [[Attribut:ac:caption]]
|}

== Siehe auch ==

[[Vorlage:Glossareintrag/Vorgabe]] als Vorlage für neue Fachbegriffe.

<includeonly>
[[Kategorie:Formatierung]]
[[Kategorie:Glossar]]
</includeonly>