Hilfe:Vorlagen

Aus Macwrench

		Hilfe
	Hauptportal       Portal     Hilfeartikel       Einführung     Editierhilfe

Vorlagen bieten eine Möglichkeit, die Nutzung häufig verwendeter Seitenelemente zu vereinfachen. Es existieren bereits einige von uns erstellte Vorlagen, die weiter unten in diesem Artikel vorgestellt werden. Die Erstellung eigener Vorlagen ist theoretisch ohne Probleme möglich, sollte jedoch mit Bedacht erfolgen um kein Chaos zu verursachen und das einheitliche Erscheinungsbild der Seite zu gewährleisten.

Eine komplette Übersicht aller zur Verfügung stehenden Vorlagen ist über diesen Link zu erreichen. Wichtige und häufig verwendete Vorlagen sind außerdem über die Kategorie "Vorlage" zu finden.

Im Zweifelsfall ist der für das Wiki zuständige oder ein anderer Administrator zu kontaktieren oder der Wunsch in die Feature Request Liste einzutragen.

Zu bemerken ist noch, dass - wohl duch ein Problem des MediaWiki Parsers - die Variablenübergabe an MediaWiki-Extensions innerhalb von Vorlagen (Templates) nicht funktioniert. Das bedeutet, dass beispielsweise bei einer Variable namens var1 der String {{{var1}}} an die Extension übergeben wird, was ja in den meisten Fällen eher medium sinnvoll sein dürfte.

Inhaltsverzeichnis 1 Verwenden von Vorlagen (Inklusion) 2 Einbinden von Artikeln (Transklusion) 3 Vorlagen mit Variablen 4 Unsichtbarer Text 5 Macwrench-Vorlagen 5.1 OS Versionshinweise 5.2 ContentboxWithTitle 5.3 Navimg 5.4 Texttt 5.5 Clr 5.6 Article 5.7 Unsigned 6 Weitere Informationen

Verwenden von Vorlagen (Inklusion)

Artikel im Namesraum Vorlage können für die automatische Einbindung in Artikel verwendet werden. Der Aufruf erfolgt dabei so:

{{Vorlagenname}}

Durch den Aufruf mit

{{msgnw:Vorlagenname}}

wird der Vorlageninhalt in <noinclude /> Tags eingeschlosse eingebunden, er taucht also in keiner Kategorie auf.

Durch den Aufruf mit

{{subst:Vorlagenname}}

erfolgt die Einsetzung einmalig und dauerhaft (wie beispielsweise auch bei den Signaturen), es bleibt also nicht die Aufruf-Syntax mit den geschwungenen Klammern im Artikel sondern der Inhalt der eingebundenen Vorlage.

Einbinden von Artikeln (Transklusion)

Auch einzelne Artikel können direkt in weiteren Artikeln eingebunden werden, um beispielsweise mehrere kürzere, in sich abgeschlossene Kapitel zu einem einzigen großen Artikel zusammenführen zu können. Das erfolgt durch Transklusion mit Hilfe doer folgenden Syntax:

{{:Einzubindender_Artikel}}

Zu beachten ist der Doppelpunkt vor dem Artikelnamen!

Nicht darzustellende Bereiche (wie z.B. Navigationselemente, Kopf- und Fußzeilen oder Referenzlisten) können in <noinclude> Bereiche gefasst werden (s.u.), damit die einzelnen Artikel auch für sich einzeln abgeschlossen und vollständig sind.

Vorlagen mit Variablen

Variablen können auf zwei Arten verwendet werden. Entweder mit Name oder ohne:

{{Vorlagenname|foo|bar}}

oder

{{Vorlagenname|VAR1=foo|VAR2=bar}}

Zu beachten ist, das Variablennamen IMMER GROSSGESCHRIEBEN werden müssen.

Innerhalb der Vorlage werden die Variablen dann wie folgt verwendet:

Variablen ohne Namen (1. Fall):

{{{1}}} {{{2}}} ... usw.

Variablen mit Namen (2. Fall):

{{{VAR1}}} {{{VAR2}}}

Anmerkung: erfahrungsgemäß kommt der Wikicode-Parser aus dem Tritt, wenn nach dem Vorlagenname das Pipe-Symbol nicht direkt dahinter steht sondern erst nach einem Zeilenumbruch. Daher sollte dieses Trennsymbol zwischen Vorlagenname und erster Variable IMMER direkt nach dem Vorlagennamen kommen. Bei den anschließenden Trennsymbolen zwischen den Variablen scheint das wohl keine Rolle mehr zu spielen. - hagbard

Unsichtbarer Text

Mit Hilfe der Tags

<noinclude>...</noinclude>

lässt sich Beschreibungstext in Vorlagen einfügen, der bei Verwendung in Artikeln nicht dargestellt wird.

Macwrench-Vorlagen

Es existieren bereits einige von uns vordefinierte Vorlagen, die in eigenen Artikeln verwendet werden können. Eine Gesamtübersicht dieser Vorlagen ist in Form einer Kategorie verfügbar:

OS Versionshinweise

Für die Angaben bezüglich der Versionskompatibilität vorgestellter Funktionen existieren 2 Vorlagen, um entsprechende Mac OS Versions Logos einzublenden. Mehr Informationen dazu gibt es im entsprechenden Hilfeartikel.

ContentboxWithTitle

Diese Vorlage stellt eine graue Box mit Titelzeile dar, wie sie beispielsweise im Portal verwendet wird. Auch das Einbinden weiterer Vorlagen funktioniert, und zwar beispielsweise so:

	Aktuelles
	Aktuelle Informationen rund um dieses Wiki: iOS 4.3 Seit Kurzem ist die iOS Version 4.3 (Build 8F190) für iPhone (ab 3GS), iPod touch (ab 3G), iPad und Apple TV (2G) verfügbar und entweder über iTunes oder – wie üblich – als direkter Download über unsere Linklisten zu beziehen. Die aktualisierte Version 3.2 des iPhone Configuration Utility ist nun ebenfalls verfügbar (für Mac OS X und Windows), ebenso eine aktualisierte Version des iOS SDK (wahlweise mit Xcode 4 oder 3.2.6) hagbard 22:14, 9. Mär. 2011 (CET)

Die grundlegende Syntax ist also

	TITELZEILENTEXT
	...INHALT...

Navimg

... erstellt Links mit Wiki-internen Grafiken und wird so eingesetzt: {{Navimg|xsize={{{width}}}|ysize={{{height}}}|image={{{image}}}|link={{{link}}}}}

also z.B. so:

{{Navimg|xsize=150px|ysize=50px|image=Icon_macwrench.png|link=Hauptseite}} {{Navimg|xsize=150px|ysize=150px|image=Icon_macwrench.png|link=Hauptseite}}

oder

Wenn die Höhe also zu klein ist, wird das Bild abgeschnitten.

Texttt

... ist eine ganz simple Vorlage, um Text im "Typewriter-Style", also mit einer Monospaced-Font wie "Courier" auszugeben. Das ist insbesondere für kleine Codeschnippsel und Syntaxbeispiele ganz praktisch, weil es weniger Tipperei ist als das entsprechende Pendant im HTML-Code und sich so auch mitten im Fließtext kleine Codebeispiele einfügen lassen. Erreicht wird das ganze durch Einfügen von

{{Texttt|TEXT}}

was dann eine Ausgabe wie die folgende bewirkt:

<?php echo phpinfo();?>

Falls innerhalb des Templates Wiki-Code ausgegeben werden soll, ist dieser mit den Tags

<nowiki> ... </nowiki>

zu klammern.

Clr

Um den Textumfluss um Bilder herum manuell abzubrechen, existiert diese Vorlage hier. Sie funktioniert jedoch nur, wenn der Grafik ein Ausrichtungsparameter (right|center|left) mit auf den Weg gegeben wurde:

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Nulla ultrices consectetuer leo. Nulla volutpat. Sed tincidunt, nibh vel hendrerit vestibulum, metus ligula sollicitudin purus, vitae egestas enim purus in est. Aenean magna justo, molestie non,
tristique sit amet, sagittis vitae, ipsum. Praesent fermentum metus ac metus. Curabitur hendrerit felis vel velit. Phasellus mattis venenatis nisl. Fusce consectetuer gravida lacus. Integer lobortis augue vitae dolor. Etiam bibendum ipsum a sapien eleifend placerat. Etiam id nibh vel ipsum vestibulum vestibulum. Morbi a ante sed eros pretium eleifend. Ut erat lorem, ullamcorper vulputate, lacinia ut, rutrum vel, ipsum. Phasellus lacus arcu, venenatis id, porttitor et, molestie bibendum, nisi. Ut elit. Donec aliquet odio vitae felis. Aliquam turpis mi, fermentum at, egestas eleifend, porta ut, lacus. Suspendisse non ante.

Article

...

Unsigned

Für Signaturen existiert bekanntermaßen ein entsprechendes Kürzel, das z.B. auf Diskussionsseiten zu verwenden ist. Zusätzlich dazu existiert die Vorlage "Unsigned", die an Stelle obiger Signaturkürzel verwendet werden kann. Dies ist insbesondere dann gegeben, wenn wichtige Einträge nicht signiert' sind und dies nachträglich erfolgen muss.

Verwendung:

{{Unsigned|hagbard}}

ergibt

Vorlage:Unsigned

Weitere Informationen

• Übersicht aller macwrench-Vorlagen: Kategorie:Vorlage

Mehr zur Verwendung von Templates steht ...

• im MediaWiki Handbuch (de, en)
• im Artikel Extended Template Syntax