Quelltext der Seite Vorlagen

Wer sich mit der Verwendung von Vorlagen auskennt, findet auf dieser Seite im Abschnitt [[#Übersicht der Vorlagen|Übersicht der Vorlagen]] einen Überblick und wie man diese Vorlagen anwendet.

Wer wissen will, wie das so mit den Vorlagen überhaupt funktioniert kann weiterlesen.

== Was sind Vorlagen? ==
Eine Vorlage ist eine Seite, die die Einbindung häufig verwendeter Elemente in andere Seiten erleichtert. Im einfachsten Fall handelt es sich dabei um einen vorformulierten Textbaustein, der auf einer anderen Seite eingefügt werden kann.

Häufig enthalten Vorlagen auch die Möglichkeit, veränderliche Daten einzufügen, binden grafische Elemente ein und verwenden eine einfache Programmierung.

Vorteile von solchen Vorlagen sind:
* Man muss sich nicht jedes Mal mit einer kompliziertes Definition von Kästchen und deren Formatierung beschäftigen, sondern hat einen einfachen Befehl.
* Der Text erhält dadurch wieder erkennbare Elemente, an denen sich der Leser orientieren kann.
* Die Vorlage kann an einer Stelle verändert werden und muss nicht auf vielen Seiten korrigiert werden.

== Wie setzt man sie ein? ==

Im einfachsten Fall fügst du eine Vorlage mit <code><nowiki>{{Vorlagenname}}</nowiki></code> ein. Beim Anzeigen der Seite ersetzt die MediaWiki-Software dies dann durch den Inhalt der Vorlage ''„Vorlagenname“''. Ändert jemand die Vorlage, ändert sich dadurch auch die Darstellung.


{|
|- 
|[[File:Transclusion simple.svg|300px]]|| Das Bild verdeutlicht, wie es funktioniert. Die Seite B ist eine Vorlage, was man im Wiki normalerweise daran erkennt, dass der Seitenname die Bezeichnung des Namensraumes "Vorlage:" vorangestellt hat. Bei der Benutzung des Codes <code><nowiki>{{B}}</nowiki></code> (erkennbar im unteren Bereich) wird auf der Seite A der Inhalt von B eingefügt, ohne dass man erkennt, dass es von einer anderen Seite kommt. Übrigens wird sich auch Formatierungen wie Seitenumbrüche in B auf die Seite A aus. Das muss dann in B korrigiert werden, wenn
|}


=== Parameter einfügen und verwenden ===

Oft sollen in einer Vorlage Inhalte auftauchen, die sich jedoch von Seite zu Seite ändern, zum Beispiel die Nummerierung einer Aufgabe, die Beschriftung eines Bildes oder die Aufgabenstellungen. Das erreicht man mit '''Parametern'''.

Auf der Vorlagen-Seite selber kennzeichnet man durch drei geschweifte Klammern <nowiki>{{{1}}}</nowiki> Stellen als Platzhalter; diese werden meist durchnummeriert. Alternativ kann man auch Namen dafür verwenden, was auf dem Chemie-digital-Wiki aber bisher nicht gemacht wird. 

Ein Platzhalter kann auch als einfacher Text ausgegeben werden oder auch beliebig anders eingesetzt werden. Etwa als interner Link, wenn er seinerseits in der Vorlage mit zwei eckigen Klammern umgeben ist, wie zum Beispiel in <nowiki>[[{{{1}}}]]</nowiki>, beliebig formatiert oder kombiniert mit anderen Ausgaben um etwa einen externen Link anzusteuern.

Eine Vorlage mit Parametern verwendet man, indem man nach dem Namen der Vorlage, getrennt mit jeweils einem senkrechten Strich die gewünschten Werte der Parameter angibt.

'''Beispiel:'''

Wenn man eine Vorlage mit dem Namen „Vorlage:Titel 1“ hat, die folgenden Text enthält
 <nowiki>Nach Angaben von Wikipedianer {{{1}}} ist diese Seite kopiert von {{{2}}}</nowiki>
Und die Vorlage so auf einer beliebigen Seite einbindet:
 <nowiki>{{Titel 1|wikiwichtel|http://www.irgendwo.de/}}</nowiki>
Entsteht dort der Text
 Nach Angaben von Wikipedianer wikiwichtel ist diese Seite kopiert von http://www.irgendwo.de/

Bei der Angabe der Parameter ist die Reihenfolge zu beachten, die entsprechend der Nummern der Platzhalter in der Vorlage sein muss. Alternativ könnte man zwar auch folgendes verwenden ...
 <nowiki>{{Titel 1|2=http://www.irgendwo.de/|1=wikiwichtel}}</nowiki>
aber es geht ja auch einfacher.

Wenn für einen Parameter kein Wert übergeben wird, so erscheint er leer bzw. es wird der Platzhalter <nowiki>{{{1}}}</nowiki> angezeigt.

Wird ein Parameter nachträglich in eine bestehende Vorlage eingefügt, so müssten eventuell die verwendenden Artikel entsprechend geändert werden. Deshalb sollte dies vermieden werden!

=== Problem: Aufzählungszeichen ===
* Will man Aufzählungszeichen (<code>*</code> oder <code>#</code>), wie am Anfang dieser Zeile eines steht, als Parameterwert benutzen, so sollte in der Vorlage vor dem Parameter eine neue Zeile begonnen werden. Natürlich kann man dies auch bei der Anwendung der Vorlage einfügen:
 <nowiki>{{Vorlagenamen|</nowiki>
 * Aufzählungstext 
 * Aufzählungstext
 }}

=== Problem: Gleichheitszeichen in Parameterwerten ===
Übergibt man einer Vorlage als Parameterwert einen Text, der ein Gleichheitszeichen enthält, nimmt die MediaWiki-Software an, vor dem ersten Gleichheitszeichen stünde der Name eines Parameters, dem der Rest des Textes hinter dem ersten Gleichheitszeichen als Wert zugewiesen werden solle. 

Dieses Problem tritt etwa auf, wenn man als Parameterwert an eine Vorlage eine URL oder eine Rechenformel übergeben will, in der ein Gleichheitszeichen enthalten ist.

Die Abhilfe gegen diese unerwünschte Interpretation ist, dass man dem Parameterwert den numerischen Index des Parameters und ein ''weiteres'' Gleichheitszeichen voranstellt. Dann wird wie gewünscht interpretiert, dass der Parameterwert erst hinter dem (hinzugefügten) ersten Gleichheitszeichen beginnt, und der diesem vorangestellte Index bezeichnet unmissverständlich den ''Zielparameter'' für den Wert. Die Zählung der Parameter beginnt dabei mit 1 beim ersten Parameter nach dem Vorlagennamen.

{|
|Statt:
|<code><nowiki>{{Vorlagenname|http://…/index.php?title=…&action=edit&section=3}}</nowiki></code>
|-
|Richtig:
|<code><nowiki>{{Vorlagenname|</nowiki><span style="color:#0000ff;">'''1='''</span><nowiki>http://…/index.php?title=…&action=edit&section=3}}</nowiki></code>
|}


Danach folgende unbenannte Parameter müssen ebenfalls nummeriert werden, da die automatische Zählung die explizite Nummerierung nicht berücksichtigt, d.&nbsp;h. bei <code><nowiki>{{Vorlagenname|erster Wert|2=zweiter Wert|dritter Wert}}</nowiki></code> würde <code>zweiter Wert</code> durch <code>dritter Wert</code> ersetzt werden.

Im normalen Fließtext, in dem das Gleichheitszeichen keine syntaktische Bedeutung hat, kann das Gleichheitszeichen durch '''&amp;#61;''' ersetzt werden.

===Weitere Probleme mit Parametern===
Gründe, warum eine Vorlage nicht funktioniert, gibt es viele. Am einfachsten sind Schreibfehler. Falls es nach mehreren Versuchen nicht klappt sollte man nach Hilfe fragen.

Es gibt auch Hilfe für weitere typische Probleme, die auf den [http://de.wikipedia.org/wiki/Hilfe:Vorlagen#Parameter_einf.C3.BCgen_und_verwenden Hilfe-Seite] der Wikipedia nachgelesen werden können.

== Wie erstellt man eigene Vorlagen? ==
Wenn hier eine Vorlage fehlt, die es noch nicht gibt, so kann sich natürlich eine neue Vorlage erstellen. Wenn es ähnliche Vorlagen gibt, die nur nicht ganz den Wünschen entsprechen, sollte man darauf achten, dass die neue Vorlage, nicht zu sehr von den anderen abweicht.

Am einfachsten ist es natürlich, wenn man sich eine vorhandene Vorlage kopiert und sie den Wünschen entsprechend anpasst. Dann sollte man so vorgehen:
* Die Seite der zu kopierenden Vorlage ''"Vorlage:Vorlagenname"'' in einem Extra-Tab anzeigen und zum Bearbeiten öffnen.
* Eine neue Vorlagen-Seite erstellen, indem man ''"http://wikis.zum.de/chemie-digital/Vorlage:VorlagennameErgänzt"'' in die Eingabezeile eingibt. ''Dazu muss man von einer Seite des Chemie-digital-Wikis aus, nur den Seitennamen abändern!''
* Man kopiert den Code aus der alten Vorlage und fügt ihn in die neue Vorlage ein.
* Dann passt man die Vorlage der Wünsche entsprechend an. Wenn neue Parameter eingefügt werden, muss man darauf achten, dass jede Platzhalternummer nur einmal verwendet wird. 
* Mit der Vorschau kann man sehen, ob alles richtig ist. Man sieht dann natürlich die Platzhalter und keine richtigen Werte.
* Man sollte die Vorlage auch einmal richtig ausprobieren, ob alles passt.
* Die Vorlage sollte dann auch vorgestellt und in die Übersicht hier bzw. auf den Unterseiten aufgenommen werden, damit andere Benutzer nicht noch einmal die gleiche Vorlage erstellen.

== Video zur Anwendung von Vorlagen ==

<center><iframe width="640" height="360" src="https://www.youtube-nocookie.com/embed/0oHVSAVf65o?rel=0&amp;showinfo=0" frameborder="0" allowfullscreen></iframe></center>

== Übersicht der Vorlagen ==
Eine unsortierte Übersicht aller definierter Vorlagen gibt es [[Spezial:Meistbenutzte_Vorlagen|hier]].

=== Häufig benutzte Vorlagen ===
==== Link auf deutsche Wikipedia-Seite ====
<u>Allgemein:
 </u> <nowiki>{{Wpde|Wikipedia-Seitenname|Linktext}}</nowiki>
::''Mit Seitenname ist wirklich nur der Name der Seite gemeint und nicht die Adresse. Das kann auch ein Unterabschnitt sein, den man über das Inhaltsverzeichnis erreicht.''

 <nowiki>{{Wpde|Eisen#Eisenerzeugung_aus_Erz|Abschnitt in Eisen-Artikell}}</nowiki> 

führt zu

{{wpde|Eisen#Eisenerzeugung_aus_Erz|Abschnitt in Eisen-Artikel}}

==== Aufgabe ohne Nummer ====
<u>Allgemein:</u>
 <nowiki>{{Aufgabe|Aufgabentext}}</nowiki>
::''Beim Aufgabentext muss man beachten, dass eine Aufzählung nach dem senkrechten Strich | in der nächsten Zeile beginnen muss, wenn man vorher keinen Text stehen hat.''

 <nowiki>{{Aufgabe|
 * Aufgabe Bla 1
 * Aufgabe Bla 2
 }}</nowiki>

führt zu

{{Aufgabe|
* Aufgabe Bla 1
* Aufgabe Bla 2
}}

==== Aufgabe mit Nummer ====
<u>Allgemein:</u>
 <nowiki>{{AufgabeNr|Nummer|Aufgabentext}}</nowiki>
::''Zuerst die Nummer, oder ein beliebiger Text in die Üebrschrift, dann der Aufgabentext.''

 <nowiki>{{AufgabeNr|2a|Und nun mache das folgende ...
 * Bla 1
 * Bla 2
 }}</nowiki>

führt zu

{{AufgabeNr|2a|Und nun mache das folgende ...
* Bla 1
* Bla 2
}}

==== Roter Kasten zum Hervorheben wichtiger Informationen ====
<u>Allgemein:</u>
 <nowiki>{{Kurzregel|Informationstext}}</nowiki>
::''Kann zum Hervorheben von Text, z.B. regeln oder Informationen, verwendet werden. Ein anderer Rahmen mit anderer Farbe oder Hintergrund kann natürlich noch erstellt werden! Bei Aufzählungszeichen gilt das gleiche, wie vorher angesprochen. Im zentralen ZUM-Wiki gibt es weitere Beispiele.''

 <nowiki>{{Kurzregel|Wichtige Info ...
 * Bla 1
 * Bla 2
 }}</nowiki>

führt zu

{{Kurzregel|Wichtige Info ...
* Bla 1
* Bla 2
}}

==== Verweis auf eine Buchseite ====
<u>Allgemein:</u>
 <nowiki>{{Buch|Thema|Angaben zu Seiten}}</nowiki>
::''Verweist auf Seiten im Buch zu bestimmten Themen. Die Vorlage scheint etwas eingeschränkt, aber erspart Schreibarbeit und bietet ein hübsches Bildchen.''

 <nowiki>{{Buch|Redoxreaktionen|31 bis 33 (erster Abschnitt)}}</nowiki>

führt zu

{{Buch|Redoxreaktionen|31 bis 33 (erster Abschnitt)}}


=== Symbole ===
Diese einfachen Vorlagen sind als Ergänzungen '''im''' Text gedacht (im Gegensatz zu den Kästen vorher!). problematisch ist, dass der mouse-over-Effekt, der hier teilweise genutzt wird, nicht auf Tablets funktioniert.

{|
!Informationen!!Anwendung!!Aussehen
|- 
| <code><nowiki>{{Hinweis|Hinweistext}}</nowiki></code> || {{Hinweis|Hinweistext}} || Gedacht als Kurzinformation, vor allem für Begriffe, die einer kurzen Erläuterung bedürfen. Wenn etwa die Verlinkung auf einen Wikipedia-Artikel keinen Sinn macht.
|- 
| <code><nowiki>{{Wichtig|Hinweistext}}</nowiki></code> || {{Wichtig|Hinweistext}} || Gedacht als Kurzinformation, wenn der Leser etwas wichtiges zu beachten hat. Dies soll sozusagen einer erneute Erinnerung sein, was zum Beispiel vorher schon einmal erwähnt wurde.
|- 
| <code><nowiki>{{Video}}</nowiki></code> || {{Video}} || Soll als Hinweis für Links auf einen Film verwendet werden.
|- 
| <code><nowiki>{{Audio}}</nowiki></code> || {{Audio}} || Soll als Hinweis für Links auf eine Audio-Datei verwendet werden.
|- 
| <code><nowiki>{{Artikel|Artikelthema|Link}}</nowiki></code> || {{Artikel|Mini-Brennstoffzelle lädt Handys unterwegs auf|http://www.heise.de/newsticker/meldung/Mini-Brennstoffzelle-laedt-Handys-unterwegs-auf-748003.html}} || Damit kann auf Externe Artikel aus Online-Zeitschriften oder Portalen verwiesen werden, die für die Schüler verständlich genug sind.
|- 
| <code><nowiki>{{}}</nowiki></code> || 2 || 3
|- 
| <code><nowiki>{{}}</nowiki></code> || 2 || 3
|- 
| <code><nowiki>{{}}</nowiki></code> || 2 || 3
|}







{{Audio}}


[[Kategorie:Hilfe]]