Infobox

Vorlagenbeispiel: Benachrichtigungsfeld

Um Textpassagen hervorzuheben, wird häufig eine Art Benachrichtigungsfeld verwendet.

In diesem Beispiel erstellen wir ein Benachrichtigungsfeld, in dem eine Warnung, ein Tipp oder eine Notiz angezeigt werden kann:

Die Farbe der Box und die Boxbezeichnung ändern sich automatisch, je nachdem, welchen Boxtyp der Benutzer auswählt.

Vorlage erstellen

1. Erstelle die Seite Vorlage:Box Note
2. Füge den Vorlageninhalt hinzu und speichere die Seite:

   <div class="infobox notification-{{{boxtype}}}">
   <span class="boxlabel">
   {{#switch: {{{boxtype}}}
    | note = Hinweis:
    | tip = Tipp:
    | warning = Achtung:
    | example = Beispiel:
    | important = Wichtig!
    | backgroundbox = 
    | #default = Hinweis:
   }}
   </span>{{{Note text}}}
   </div>
   

Was dieser Code bewirkt:

• Der Container (<div>...</div>) wird zum Gestalten der Box verwendet. Es hat die Stilklassen Infobox und {{{boxtype}}}. Der Parameter boxtype gibt den tatsächlichen Wert an, den der Benutzer bei der Verwendung der Vorlage auswählt.
• Das <span>...</ span> enthält die Beschriftung für die Box. Es zeigt die Beschriftung für den vom Benutzer ausgewählten Kastentyp an. Es hat die Stilklasse boxlabel, mit der das Etikett formatiert wird.
• {{{Hinweistext}}} ist der Platzhalter für den tatsächlichen Text, den der Benutzer auf einer bestimmten Seite erstellt.

Um Benutzern das Einfügen und Verwenden dieser Vorlage im visuellen Bearbeitungsmodus zu erleichtern, haben wir einen Abschnitt <nowicki><templatedata></nowiki> in die Vorlage aufgenommen. Der Tag ist in <nowiki>...<nowiki> eingewickelt, um sicherzustellen, dass dieser Teil der Vorlage nicht auf der Zielseite übertragen wird, die die eigentliche Vorlage verwendet. Diese Funktion der Vorlagenabschnitte beschreibt die Parameter der Vorlage. Außerdem wird das Formular für die visuelle Bearbeitung ausgefüllt:

<div class="infobox notification-{{{boxtype}}}">
<span class="boxlabel">
{{#switch: {{{boxtype}}}
 | note = Hinweis:
 | tip = Tipp:
 | warning = Achtung:
 | example = Beispiel:
 | important = Wichtig!
 | backgroundbox = 
 | #default = Hinweis:
}}
</span>{{{Note text}}}
</div>

<noinclude>
<templatedata>
{
	"params": {
		"boxtype": {
			"description": "Possible values: note, tip, warning",
			"example": "note",
			"type": "string",
			"default": "note",
			"required": true
		},
		"Note text": {}
	},
	"description": "To add standard infoboxes such as notes or related links to a page"
}
</templatedata>
</noinclude>

Was dieser Code bewirkt:

• Es listet die beiden Parameter (boxtype und Note text) auf, die durch ein Komma getrennt sind.
• Es listet die Parameterobjekte auf (optional): Beschreibung, Beispiel, Typ usw. Eine vollständige Liste der Vorlagendatenobjekte finden Sie unter www.mediawiki.org/wiki/Extension:TemplateData#Param_Objekt
• Beschreibt den Zweck der Vorlage (description), damit Benutzer sie von ähnlichen Vorlagen unterscheiden können.

Erstellen der Vorlagenstile

Um das Benachrichtigungsfeld zu formatieren, haben wir drei Stilklassen zugewiesen:

• Infobox: Behälter für die Infobox. Wir können Layout-Eigenschaften wie Rahmen, Hintergrund oder Abstand festlegen
• notification-{{{boxtype}}}: Wird zur Farbcodierung der Box basierend auf dem Typ der Box verwendet, die ein Benutzer auf einer Seite einfügen möchte.
• Boxlabel: Gestaltung des Boxlabels.

Da wir die Stile nur laden möchten, wenn diese Vorlage auf einer Seite verwendet wird, erstellen wir die Stylesheet-Seite als Unterseite der Vorlage.

So erstellen Sie das Stylesheet:

1. Erstellen der Stylesheet-Seite:Vorlage:Box Note/styles.css. Falls dies in Ihrem Wiki nicht funktioniert,, können Sie die styles auch der Seite MediaWiki:Common.css hinzufügen.
2. Füge die Styles hinzu und speichere die Seite:

/* Box Note*/
.infobox {
	padding: 1em;
	margin: 2em 0;
	border:1px solid #ccc;
}
.infobox p {
	padding: 0;
	margin: 0;
}
.boxlabel {	
	font-weight:bold;
	padding-right:0.5em;
}
.notification-note {
border-left: solid 4px #3498db;
}
.notification-tip {
border-left: solid 4px #f2c412;
}
.notification-warning {
border-left: solid 4px #c23c2b;
}
.notification-backgroundbox {
background:#ffd67f; 
padding:12px;
}
.notification-backgroundbox .boxlabel {
display:none;
}

Fügen Sie nun den Verweis auf das Stylesheet oben auf der Vorlagenseite hinzu (Vorlage:Box-Hinweis) und speichern Sie die Vorlage erneut:

<templatestyles src="Template:Box_Note/styles.css" />
<div class="infobox notification-{{{boxtype}}}">
    ....

Ihre Vorlage kann jetzt verwendet werden.

Mit der Vorlage

So erstellen Sie ein Benachrichtigungsfeld auf einer Seite:

1. Wählen Sie Einfügen > Vorlage im visuellen Bearbeitungsmodus:
   
2. Wählen Sie die Vorlage Box Note und klicken Sie auf Add template:
   
3. Geben Sie den Namen für den Typ der Box ein, die Sie erstellen möchten, zum Beispiel note:
   
4. Klicken Sie auf Weitere Informationen hinzufügen
5. Klicken Sie auf Text notieren und geben Sie den Text für Ihr Benachrichtigungsfeld ein:
   
6. Klicken Sie auf Einfügen. Das Benachrichtigungsfeld ist jetzt auf Ihrer Seite enthalten:
   
   
   

Speichern Sie die Seite, wenn Sie keine weiteren Änderungen vornehmen müssen.

Um die Benachrichtigung später im visuellen Bearbeitungsmodus zu bearbeiten, doppelklicken Sie einfach auf die Benachrichtigung, und das Vorlagendialogfenster wird geöffnet.