Hilfe:Vorlagen und Formulare – Fortgeschrittene Wikinutzung: Unterschied zwischen den Versionen

Version vom 11. März 2014, 18:55 Uhr

Diese Seite ist noch unvollständig

Vorlagen können mit der Extension Semantic Forms komfortabel bearbeitet werden. Dabei entspricht jeder Parameter der Vorlage einem gleichnamigen Formularfeld. Ebenso bezeichnet man die Vorlage und das Formular mit gleichem Namen, um Verwirrungen zu vermeiden.

Wie benenne ich die Vorlage und deren Parameter?

Sollte man eine selbsterklärende Benennung wählen? Beispiele:

{{Meine Vorlage|Parameter 1=Langer Text}} erklärt kaum selbsterklärend über Inhalt und Struktur der Vorlage

{{Anmerkung|Text=Langer Text}} ist in sich selbsterklärend und bedarf kaum einer Dokumentation

Die deutsche Wikipedia bietet eine

Wie strukturiere ich die Vorlage und deren Parameter?

Die Benennung der Vorlage und deren Parameter sollte das Ziel haben:

schlank
übersichtlich und
selbsterklärend

Einige Vorüberlegungen:

Möchte ich die Seiten „wiederfinden“, soll die Vorlage auf nur gewissen Seiten verwendet werden?

Lösung: Lassen Sie die Vorlage eine Kategorie speichern.

Reicht es, dass ein Parameter ein Mix an Informationen enthält (z.B. 1 Parameter „Adresse“)?
Oder sollen mehrere Parameter fein gegliederte Daten abspeichern, damit nachträglich die Daten genauer abfragbar sind (z.B. statt 1 Parameter „Adresse“ mehrere Parameter „PLZ“, „Ort“, „Straße“, „Hausnummer“ usw.)?

Lösung: Jenachdem, was man mit den Daten machen will, muss man sich entscheiden.

Vorlage erstellen

Vorlagen programmieren

Man erleichtert sich die Programmierung der Vorlagen, indem man den Wiki-Editor um Programmmier-Text-Schnipsel erweitert.

Klicken Sie auf Einstellungen (Tab Aussehen)
Klicken Sie unter (*) Vektor auf „Benutzerdefiniertes JavaScript“, eine neue Seite öffnet sich, auf der JavaScript gespeichert werden kann
Kopieren Sie den Inhalt der Seite Benutzer:Andreas_Plank/vector.js in ihre eigene Seite

Zuordnen von Semantischen Attributen zu Vorlagen-Parametern

1 Parameter und 1 Wert

in der Vorlage

Parameter + Attribuit sichtbar:
[[Attributname::{{{Vorl.-Parameter}}}]]
Parameter + Attribuit unsichtbar:
[[Attributname::{{{Vorl.-Parameter}}}| ]] oder
{{#set:Attributname={{{Vorl.-Parameter}}} }}

1 Parameter und mehrere Werte (=Liste)

in der Vorlage

Werteliste , Komma separiert
{{#arraymap: {{{Vorl.-Parameter|}}}|,|§|[[Attributname::§]]| • }}
Werteliste ; Semikolon separiert
{{#arraymap: {{{Vorl.-Parameter|}}}|;|§|[[Attributname::§]]| • }}

Es sei angemerkt, dass auch der Assistent Spezial:Vorlage erstellen benutzt werden kann, jedoch sind seine Erstellmöglichkeiten limitiert, daher ist es oft sinnvoller die Vorlage mit obigem Formular selber zu erstellen.

Formulare erstellen

Wenn die Vorlage fertig programmiert ist, kann über den Assistenten Spezial:Formular erstellen ein namensgleiches Formular erstellt werden und angepasst werden. In diesem Wiki wurde das Layout von Formularen in MediaWiki:Common.css umdefiniert.

Die englische MediaWiki-Dokumention bietet eine ausführliche technische Dokumentation zum Definieren von Formularen an.

@@ Zeile 11: / Zeile 11: @@
 : <code><nowiki>{{Anmerkung|Text=Langer Text}}</nowiki></code> ist in sich selbsterklärend und bedarf kaum einer Dokumentation
-Die deutsche Wikipedia bietet eine [https://de.wikipedia.org/wiki/Hilfe:Vorlagen ausführliche Hilfe zu Vorlagen] und eine [https://de.wikipedia.org/wiki/Hilfe:Vorlagenprogrammierung Hilfe zur Vorlagenprogrammierung].
+Die deutsche Wikipedia bietet eine
+* [https://de.wikipedia.org/wiki/Hilfe:Vorlagen ausführliche Hilfe zu Vorlagen] und
+* eine [https://de.wikipedia.org/wiki/Hilfe:Vorlagenprogrammierung Hilfe zur Vorlagenprogrammierung]
 == Wie strukturiere ich die Vorlage und deren Parameter? ==
@@ Zeile 23: / Zeile 25: @@
 {{Logo|Frage|18px}} Möchte ich die Seiten „wiederfinden“, soll die Vorlage auf nur gewissen Seiten verwendet werden?<br />
-: '''Lösung:''' Lassen Sie die Vorlage eine Kategorie speichern, die derlei Seiten wiederfinden lässt.
+: '''Lösung:''' Lassen Sie die Vorlage eine Kategorie speichern.
-{{Logo|Frage|18px}} Reicht es, dass ein Parameter ein Mix an Informationen enthält (z.B. 1&nbsp;Parameter „Adresse“)?<br/>Oder sollen mehrere Parameter fein gegliederte Daten abspeichern, damit die Daten genauer abfragbar sind (z.B. statt 1&nbsp;Parameter „Adresse“ mehrere Parameter „PLZ“, „Ort“, „Straße“, „Hausnummer“ usw.)?<br />
+{{Logo|Frage|18px}} Reicht es, dass ein Parameter ein Mix an Informationen enthält (z.B. 1&nbsp;Parameter „Adresse“)?<br/>Oder sollen mehrere Parameter fein gegliederte Daten abspeichern, damit nachträglich die Daten genauer abfragbar sind (z.B. statt 1&nbsp;Parameter „Adresse“ mehrere Parameter „PLZ“, „Ort“, „Straße“, „Hausnummer“ usw.)?<br />
 : '''Lösung:''' Jenachdem, was man mit den Daten machen will, muss man sich entscheiden.
@@ Zeile 39: / Zeile 41: @@
 }}
+=== Vorlagen programmieren ===
+Man erleichtert sich die Programmierung der Vorlagen, indem man den Wiki-Editor um Programmmier-Text-Schnipsel erweitert.
+# Klicken Sie auf [[Spezial:Einstellungen#mw-prefsection-rendering|Einstellungen (Tab Aussehen)]]
+# Klicken Sie unter (*) Vektor auf „Benutzerdefiniertes JavaScript“, eine neue Seite öffnet sich, auf der JavaScript gespeichert werden kann
+# Kopieren Sie den Inhalt der Seite [[Benutzer:Andreas_Plank/vector.js]] in ihre eigene Seite
+=== Zuordnen von Semantischen Attributen zu Vorlagen-Parametern ===
+; 1 Parameter und 1 Wert : in der Vorlage <ul><!--
+ --><li>Parameter + Attribuit sichtbar:<br /><code><nowiki>[[Attributname::{{{Vorl.-Parameter}}}]]</nowiki></code></li><!--
+ --><li>Parameter + Attribuit '''unsichtbar''':<br /> <code><nowiki>[[Attributname::{{{Vorl.-Parameter}}}| ]]</nowiki></code> oder<br /><code><nowiki>{{#set:Attributname={{{Vorl.-Parameter}}} }}</nowiki></code></li></ul>
+; 1 Parameter und mehrere Werte (=Liste) : in der Vorlage <ul><!--
+ --><li>Werteliste , Komma separiert<br /><code>'''{{'''<nowiki>#arraymap: {{{Vorl.-Parameter|}}}</nowiki>&lt;!-- Werte<br />-->|,&lt;!-- Trennung bei ,<br />-->|§&lt;!-- Einzelwert temporär in „§“ speichern<br />-->|<nowiki>[[Attributname::§]]</nowiki>&lt;!-- Ausgabe<br />-->|&amp;#32;•&amp;#32;&lt;!-- Ausgabe-Trenner<br />-->'''}}'''</code></li><!--
+ --><li>Werteliste ; Semikolon separiert<br /><code>'''{{'''<nowiki>#arraymap: {{{Vorl.-Parameter|}}}</nowiki>&lt;!-- Werte<br />-->|;&lt;!-- Trennung bei ;<br />-->|§&lt;!-- Einzelwert temporär in „§“ speichern<br />-->|<nowiki>[[Attributname::§]]</nowiki>&lt;!-- Ausgabe<br />-->|&amp;#32;•&amp;#32;&lt;!-- Ausgabe-Trenner<br />-->'''}}'''</code></li></ul>
+Es sei angemerkt, dass auch der Assistent [[Spezial:Vorlage erstellen]] benutzt werden kann, jedoch sind seine Erstellmöglichkeiten limitiert, daher ist es oft sinnvoller die Vorlage mit obigem Formular selber zu erstellen.
+== Formulare erstellen ==
+Wenn die Vorlage fertig programmiert ist, kann über den Assistenten [[Spezial:Formular erstellen]] ein namensgleiches Formular erstellt werden und angepasst werden. In diesem Wiki wurde das Layout von Formularen in [[MediaWiki:Common.css]] umdefiniert.
+Die englische MediaWiki-Dokumention bietet eine ausführliche [https://www.mediawiki.org/wiki/Extension:Semantic_Forms/Defining_forms technische Dokumentation zum Definieren von Formularen] an.
 [[Kategorie: Hilfe]]