aus Wikipedia, der freien Enzyklopädie
Diese Seite beschreibt, wie Vorlagen mit der Bearbeitungsumgebung VisualEditor eingebunden werden können. Diese wird an der aktuellen Cursorposition eingefügt.
Vorlagenbestandteile
Eine Vorlage, wie die Vorlage:Literatur, kann auf einer Seite eingebunden werden, um einheitliche Formatierungen anzubieten. Vorlagen werden jeweils unter einen spezifischen Namen zumeist im Vorlagennamensraum angelegt. Wenn du eine Vorlage verwenden möchtest, solltest du ihre Funktion und diesen Namen kennen, um sie sinnvoll einzubinden. Das normale Menü mit den Eingabefeldern führt bislang nur wenige Wertüberprüfungen (Validierungen) aus.
- Titel oder Name der Vorlage – Internetquelle, Literatur, Zitat, Personendaten, …
- Vorlagenspezifische Parameter und Pflichtparameter – in vielen Vorlagen muss mindestens ein Parameter als Pflichtangabe ausgefüllt werden
- Inhaltstext für die Parameterwerte – Inhalt eines benannten oder nummerierten Parameters
- Optionale oder unbenutzte Parameter – manche Vorlagen bieten eine Vielzahl an optionalen Parametern an. Bei Zitationsvorlagen sollten nicht verwendete, leere, nicht zutreffende Parameter entfernt werden.
Vorlagen einfügen
Das Bearbeitungswerkzeug bietet im Bearbeitungsmodus zu einer Seite einen Menüpunkt InsertAll Elemente einfügen. In dessen Drop-Down-Bereich befindet sich ein Unterpunkt Datei:Codex icon puzzle (v2.6).svg Vorlage, der ein neues Dialogfenster öffnet, das Optionen zum Hinzufügen und Ausfüllen von Vorlagen anbietet. Alternativ kann dieses Dialogfenster auch über die Eingabe von zwei geschweiften öffnenden Klammern {{ an der Cursorposition aufgerufen werden.
| Datei:VisualEditor-logo.svg
|
| Vorlage an der Cursorposition einfügen
|
| Im Dialogfeld kannst du den Namen der gewünschten Vorlage in das Eingabefeld einfügen. Sobald du einen Buchstaben einfügst, wird dir eine Auswahlliste der vorhandenen Vorlagen angezeigt, in der du den Namen anklicken kannst.
|
|
↓
|
| Die Suchauswahl zeigt nun Ergebnisse, die entweder die Zeichenkette im Suchfeld enthalten oder in deren Beschreibung eine solche Zeichenkette enthalten ist. Dies soll helfen eine passende Vorlage zu finden, selbst wenn man ihren genauen Namen nicht kennt.
 Info: Wenn der Name einen Schrägstrich / enthält, solltest du ihn in der Regel nicht auswählen, da es sich um eine Unterseite der Vorlage handeln könnte.
Die Seite Vorlage:MediaWiki-Button/styles.css hat keinen Inhalt.⧼visualeditor-dialog-transclusion-add-template-save⧽ – übernimmt die Vorlage und zeigt im nächsten Dialogfeld die Parameter zum Ausfüllen an, wenn diese dokumentiert sind.
|
|
|
| Der Klick auf das Fragezeichen öffnet ein Dialogfeld. Es muss erst über das Vorlage:CodexIcon wieder geschlossen werden, ehe man die Bearbeitung fortsetzen kann. Ein Schließen über die darunter angezeigte runde, blaue Schaltfläche, die anstelle des Fragezeichens nun angezeigt wird, ist nicht möglich.
|
| Vorlage ausfüllen und einfügen
|
| Pflichtangaben werden durch ein Sternchen Datei:OOjs UI indicator required.svg gekennzeichnet.
|
|
|
| Auf der rechten Seite werden die benannten und (mittels TemplateData) als erwünscht oder explizit erforderlich ausgewiesenen Parameter der Vorlage aufgelistet. Zu jedem Parameter wird ein Eingabefeld oder eine Checkbox angezeigt, um die benötigten Angaben einfügen zu können.
Auf der linken Seite ist eine Auflistung aller weiteren Parameter, die durch Auswählen der Checkboxen hinzugefügt oder entfernt werden können. Pflichtparameter lassen sich nicht abwählen.
| Vorlage:CodexIcon
|
Parameter suchen
|
|
|
– optionale, unbenannte oder nicht über TemplateData dokumentierte Parameter können über das Eingabefeld gefunden oder benannt werden.
|
Ungenutzte ausblenden
Alle anzeigen
|
– Umschalten zwischen nur die rechts verwendeten oder alle Parameter in der Listen anzeigen
|
Info: Bei Parametern, die nicht mit TemplateData zugewiesen wurden, sollte zuvor geprüft werden, wie der Parameter innerhalb der Vorlagenprogrammierung benannt wurde, um zu verhindern, dass Inhalte in falsch benannte oder nicht existierende Felder eingefügt und so nicht angezeigt oder erkannt werden. Daher bitte einen Blick auf die Vorlagenseite werfen.<ref>Hier wird direkt auf die Vorlagenseite verlinkt, um eventuell dort vorhandene Parameterbezeichnungen oder Hinweise lesen zu können.</ref>
|
|
|
Es gibt Vorlagen, die unbenannten Parameter verwenden, die fortlaufend nummeriert sind 1, 2 …, das kann zu Problemen führen, wenn der eingefügte Inhalt beispielsweise ein = enthält.
|
| Sind alle Parameter optional und wurden nicht als Vorgabe bestimmt, so werden sie links in der Liste mit einer leeren Checkbox angezeigt. Diese können nun durch Anklicken zur Vorlage hinzugefügt werden. Sind alle gewünschten Parameter ausgefüllt, kannst du die Vorlag übernehmen.
|
Ausfüllen anhand eines Beispiels
Hier wird die Vorlage {{Personendaten}}, die in keinem Personenartikel fehlen sollte, als Muster verwendet.
| Datei:VisualEditor-logo.svg
|
| ⧼visualeditor-dialog-transclusion-title-insert-template⧽
|
| Sobald du einen Buchstaben einfügst wird dir eine Auswahlliste der vorhandenen Vorlagen angezeigt, in der du den Namen anklicken kannst.
|
Die Seite Vorlage:MediaWiki-Button/styles.css hat keinen Inhalt.
⧼templatedata-search-description⧽
| Personendaten Personendaten zum Ein…
|
| Personendaten/Test
|
| Personendaten/XML
|
Personendaten/Editnotice
…
|
|
|
|
| Klicke auf die gewünschte Vorlage „Personendaten“, um nun ihre Parameter auszufüllen.
|
Vorlage ausfüllen
| Datei:VisualEditor-logo.svg
|
| Vorlage Personendaten ausfüllen
|
| Parameter, die mit einem Sternchen Datei:OOjs UI indicator required.svg gekennzeichnet sind, sind Pflichtangaben, ohne die die Vorlage nicht eingefügt werden sollte. Diese Parameter lassen sich nicht entfernen.
|
|
|
| Alle Felder der Vorlage sind eingeblendet, es sind keine optionalen Parameter vorhanden. Erwünscht ist das Ausfüllen aller Felder, Pflicht- oder Mindestangaben sind der Name und eine kurze Beschreibung zur Person. Die übrigen Parameter sollten „nicht“ entfernt werden, da es sich um Angaben handelt, die möglicherweise erst später mit Inhalt gefüllt werden können, wie beispielsweise die Sterbedaten, bei noch lebenden Personen.
|
Vorlagen bearbeiten oder Parameter hinzufügen
| Datei:VisualEditor-logo.svg
|
| Fehlende oder gelöschte Parameter hinzufügen
|
| Wurden Parameter entfernt oder sind in der Programmierung hinzugekommen, so können diese zur Vorlage hinzugefügt werden. Vorhandene Vorlagen können direkt auf der Seite angeklickt und anschließend über einen Klick zur Bearbeitung geöffnet werden.
|
| Personendaten
|
| NAME |
Mustermann, Maximilian
|
| KURZBESCHREIBUNG |
Musterperson
|
|
| In diesem Beispiel sind bislang nur die Pflichtparameter angegeben worden, normalerweise würden bei dieser Vorlage alle erwünschten Parameter sofort nach dem Klick auf Bearbeiten wieder als erwünschte Parameter in das Dialogfeld eingefügt werden. Hier ist es zur Demonstration so dargestellt, als wenn es sich um rein „optionale“ oder bewusst entfernte Parameter handeln würde.
|
|
|
| Die einzelnen Vorschläge aus der Liste links lassen sich durch Anklicken Die Seite Vorlage:MediaWiki-Button/styles.css hat keinen Inhalt.0→Die Seite Vorlage:MediaWiki-Button/styles.css hat keinen Inhalt.Datei:OOjs UI icon check-invert.svg hinzufügen und können anschließend ausgefüllt werden. Bei umfangreichen Vorlagen mit sehr vielen optionalen Parametern wie beispielsweise bei der Vorlage:Literatur können Parameter auch mithilfe des Sucheingabefeldes gefunden werden.
|
Die Seite Vorlage:MediaWiki-Button/styles.css hat keinen Inhalt.
|
|
| Vorlage:CodexIcon Vorlage:CodexIcon Personendaten
|
| Personendaten zum Einfügen …
|
Name
Parameter ist erforderlich.
Beispiel: Mustermann, Maximilian
|
Alternativnamen
Beispiel: Mustermann, Max
|
Kurzbeschreibung
Parameter ist erforderlich.
Beispiel: deutscher Musterleger
|
Geburtsdatum
Beispiel: 1. Januar 2000
|
Geburtsort
Verlinken
Beispiel: [[Musterstadt]]
|
Sterbedatum
Beispiel: 31. Dezember 2000
|
Sterbeort
Verlinken
Beispiel: [[Musterstadt]]
|
|
|
Der gerade bearbeitete Parameter wird links in der Liste hellblau hinterlegt. Sollen einzelne Inhalte verlinkt werden so müdden die [[]] über die Tastatur erfänzt werden. Sind alle bekannten Angaben ergänzt oder korrigiert wird die Vorlage über Änderungen übernehmen in die Seitenansicht übernommen und kann über das Hauptmenü gespeichert werden.
|
Fehlende Pflichtangaben
| Datei:VisualEditor-logo.svg
|
| Durch ein Sternchen Datei:OOjs UI indicator required.svg gekennzeichnete Pflichtangaben
|
| Wenn versucht wird eine Vorlage einzufügen, ohne die erforderlichen Pflixhtangaben auszufüllen, so wird eine Warnmeldung ausgegeben
|
| Es fehlt ein erforderlicher Parameter
|
| Bist du sicher, dass du ohne das Ausfüllen des Parameters fortfahren möchtest?
|
| Zurück gehen
|
Trotzdem fortfahren
|
|
| Die Vorlage sollte dann nicht eingefügt werden, da dies zum einen Darstellungsfehler oder, je nach Vorlage, generelle Meldungen in Fehlerkategorien auslösen kann, wenn die Seite anschließend gespeichert wird.
Die Seite Vorlage:MediaWiki-Button/styles.css hat keinen Inhalt.Zurück gehen – zum Formular zurückkehren, um die fehlende Angabe zu ergänzen oder den Vorgang abzubrechen.
Die Seite Vorlage:MediaWiki-Button/styles.css hat keinen Inhalt.Trotzdem fortfahren – die Vorlage ohne die nötigen Angaben einfügen
|
Vorlage entfernen
| Datei:VisualEditor-logo.svg
|
| Vorhandene Vorlagen von der Seite entfernen.
|
| Manchmal ist es notwendig eine Vorlage wieder aus der Seite zu entfernen weil sie ausgetauscht werden sollen oder weil es sich um Wartungsbausteine handelt, die beispielsweise Mängel an einem Artikel anzeigen. Sind diese Mängel behoben kann der Baustein entfernt werden. Klicke die Vorlage an, um das Dialogfeld zu öffnen.
|
| Datei:Qsicon Quelle.svg
|
Dieser Artikel oder nachfolgende Abschnitt ist nicht hinreichend mit Belegen (beispielsweise Einzelnachweisen) ausgestattet. Angaben ohne ausreichenden Beleg könnten demnächst entfernt werden. Bitte hilf Wikipedia, indem du die Angaben recherchierst und gute Belege einfügst.
|
|
| Klicke auf die Vorlage, die entfernt werden soll, als wenn du sie bearbeiten möchtest, sie wird nun blau angezeigt und kann üner die Taste Entf gelöscht werden.
|
Boolesche Parameter
| Datei:VisualEditor-logo.svg
|
| Auswahl zwischen zwei Zuständen (boolesche Variablen)
|
Es gibt Parameter, die eine einfache Auswahl zwischen zwei definierten Zuständen ermöglichen. Der Parameter erwartet einen Wert 0 für „nein“ oder 1 für „ja“. Eine der beiden Optionen ist als Standard vorgegeben. Beim ersten Aufruf des Parameters wird zumeist ein Texteingabefeld angezeigt, das die Standardwertzuweisung anzeigt. Wird das Feld leer gelassen, wird diese Standardauswahl übernommen. Ist hier bereits eine Eingabe 0 oder 1 erfolgt, wandelt sich das Feld in eine Checkbox. Der Zustand kann von jetzt an durch einfaches Anklicken geändert werden.
|
|
|
Im Falle einer Checkbox werden für 0 Die Seite Vorlage:MediaWiki-Button/styles.css hat keinen Inhalt.0 oder für 1 Die Seite Vorlage:MediaWiki-Button/styles.css hat keinen Inhalt.Datei:OOjs UI icon check-invert.svg angezeigt.
|
Anzeige
|
Bei Eingaben, die nicht der booleschen Variable entsprechen, wird der Wert als 1 interpretiert. Eine Vorlage kann jederzeit durch Anklicken des Icons Vorlage:CodexIcon/Vorlage:CodexIcon zu den Favoriten hinzugefügt oder wieder entfernt werden.
|
Parameter mit Vorschlagsliste
| Datei:VisualEditor-logo.svg
|
| Parameterwerte aus einer Vorschlagsliste hinzufügen
|
Manche Vorlagen bieten für einzelne Parameter eine Liste mit möglichen Werten an, aus der diese durch Anklicken ausgewählt werden können. Als Beispiel dient hier der Parameter Sprachcode (lang) der Vorlage:Wikisource. Zu erkennen sind diese Parameter an diesem Symbol Vorlage:CodexIcon.
|
Die Seite Vorlage:MediaWiki-Button/styles.css hat keinen Inhalt.
|
|
| Vorlage:CodexIcon Vorlage:CodexIcon Wikisource
|
| Zuordnung unseres gesamten Artikels zu Textquellen im Schwesterprojekt Wikisource (Abschnitt „Weblinks“); zu Syntax und Anwendung siehe auch Wikipedia:Textbausteine/Schwesterprojekte (WP:TB/S)
|
Sprachcode
Code einer fremdsprachigen Wikisource; siehe auch…
Standard: deutschsprachig
Beispiel: en
|
|
|
Klickt man das Eingabefeld des Parameters Sprachcode an, so öffnet sich automatisch die Vorschlagsliste aus der der gewünschte Code ausgewählt werden kann. Das Eingabefeld bietet zudem die Möglichkeit durch manuelle Eingabe nach passenden Einträgen zu suchen.
Info: Es können hier auch Werte angegeben werden, die nicht in der Auswahlliste stehen, es erfolgt keine Warnung, falls diese Eingabe ungültig sein sollte.
|
Weitere Informationen[Bearbeiten]
<references />
.svg){kind=link}
.svg){kind=link}
.svg){kind=link}
