HowTo:Vorlage erstellen

Aus Piratenwiki
Wechseln zu: Navigation, Suche

HowTo: Vorlage erstellen

HowTo und Anleitungen

Grundsätzliches zum Erstellen und Nutzen von Vorlagen

Hier im Wiki gibt es drei verschiedene Arten von Seiten:

  1. Die Benutzerseiten zum Texten und Text formatieren mittels Befehle der Wiki-Syntax. Siehe auch Hilfe:Formatierung.
  2. Die Vorlagen-Seiten, auf der sich Vorlagen erstellen lassen. Siehe auch Vorlagen und Kategorie:Vorlage.
  3. Und die Kategorie-Seiten, auf denen die Seiten sortiert und verwaltet werden. Siehe auch Hilfe:Kategorie.

Diese Seiten unterscheiden sich durch die Hintergrundinformationen, also die Quelltexte, mit denen sie programmiert wurden. Man kann eine Sorte Seite nicht für eine andere Sorte verwenden. Siehe auch Namensräume.


1. Vorlageseite erstellen

Um eine neue Seite zu erstellen: Einfach [[ "Neuer Seitenname" ]] mit dem neuen Namen der Seite erstellen. Siehe Hilfe:Seite bearbeiten

Beispiel: "Neuer Seitenname" Achtung, hier nicht draufklicken, da dies ein Beispiel ist und die Seite nicht angelegt werden soll

  • Dies ist der Link für eine Seite (z.B. zum Ausprobieren)
  • Diese Links sind orange, und wenn du den Mauszeiger darüber bewegst, kannst du lesen was damit ist: "Neuer Seitenname" (Seite nicht Vorhanden) ..... das bedeutet, dass es diese Seite noch nicht gibt.
  • Klick auf den Link, eine leere neue Seite öffnet sich mit der eingegebenen Überschrift "Neuer Seitenname" wird geöffnet.
  • Wenn Du alles richtig gemacht hast, Überschrift richtig geschrieben usw. speichere die Seite und die Seite wird im Wiki angelegt.
  • Wenn Du jetzt siehst, du hast dich verschrieben, dann schließe die Seite einfach mit Abbrechen und die Seite wird geschloßen und ist weg. Dadurch brauchst du später nicht zu löschen.
[[https://wiki.wiki.piratenpartei.de/Vorlage:Seitenlayout]]
Dies ist ein WebLink und sollte nicht genutzt werden!! (ein Namensraumfehler)

Neue Seite füllen:

  • Mit Bearbeiten den Quelltext der Seite in der Wiki-Syntax erstellen. Um die Korrekte Eingabe zu prüfen solltest du die Seite mit der Vorschau testen, die Eingabe prüfen und wenn alles richtig ist erst dann Speichern
  • Unten unter den Quelltext die Kategorie einfügen, wo die Vorlage in den Kategorienbaum eingefügt werden, mit doppelt [[ ]]:
Beispiel: [[Kategorie: AK Arbeit und Soziales|Vorlage Seitenlayout]] oder
Beispiel: [[Kategorie:Ak_Arbeit_und_Soziales|Vorlage Seitenlayout]]
Schreibweise ist egal, Hauptsache, es ist immer die gleiche.


2. Vorlage erstellen

Jetzt gibt es die Große Auswahl an Befehlen. Dazu auch Hilfe:Vorlage. Und ab hier aber am Beispiel einer Farbvorlage:

Die Befehlssyntax: Dazu auch Hilfe:Syntax

Syntax ist die Befehlsschreibweise.

<span style="color:{{{Farbe}}}">{{{Text}}}</span>

  • <nowiki> bedeutet, das ein Befehl außer Kraft gesetzt wird, also nicht vollzogen wird. Dadurch ist die Formel nicht ausgeführt (hier: bunter Text), sondern als Formel zu sehen.
  • </nowiki> bedeutet Aufheben/Beenden des Befehles. Jeder Befehl gilt so lange, bis er wieder aufgehoben wird. Das geschieht durch den gleichen Befehl, nur dass darin ein / eingefügt wird. Hier bedeutet es also, dass jetzt Befehle (Formel) wieder ausgeführt werden.
  • <onlyinlude> bedeutet, dass nur das Eingeschlossene bis zum </onlyinclude> gezeigt wird.
  • <noinclude> bedeutet das Gegenteil, dass das Eingeschlossene bis zum </noinclude> nicht gezeigt wird.
  • <span style="color:Farbcode"> ist die Formel für den Befehl für die farbige Schrift und gilt, bis der Befehl wieder mit </span> aufgehoben wird. Der dawischen liegender Text wird bunt.

3. In die neue Seite einfügen

  • Zwei geschwungene Klammern umschließen die Vorlage.
Damit wird die Vorlage angewendet = in die neue Seite eingesetzt (eingebunden).
Das bedeutet, der "Vorlage-Link" inclusive der zwei geschwungenen Klammern vorne und hinten wird kopiert und in die Seite eingefügt.
  • Die Syntax, der Formel-Befehl der Vorlage, wird dann auf der Seite ausgeführt.
So wird z.B. Vorlage {{ok}} zu Ja  oder Vorlage {{Flausch}} zu Flausch.svg' .
  • Ist die Syntax (Formel für die Befehle) abgeschlossen, wird sie in zwei geschweifte Klammern {{ }} vorne und hinten gesetzt. Auf der Seite Vorlage erscheint dann der Vorlagename (Seitenname) als Vorlage-Link {{Vorlagenname}}, wird nicht als Befehl angezeigt, sondern ausgeführt. Das heißt: Anzeige des Befehls im Quelltext, Ausführung in der Ansicht.
Um diese Vorlage in einen Artikel zu integrieren, musst du nur {{HowTo:Vorlage erstellen}} in die entsprechende Seite eintragen. Mehr dazu in der Hilfe Vorlage.
fügt Deinen Text unter der Überschrift der Vorlagenseite ein.
  • Pipe | ist eine Trennung im Befehl zwischen den Parametern oder auch der Trenner im Link zwischen Adressteil | Anzeigeteil. Weil Parameter aber auch optional verwendet werden können, kann man verschiedene Vorlagen damit auch erweitern. Sie werden dynamisch, d.h. Teile veränderbar.
So wird dann z.B. die Vorlage {{OK|Geschafft}} zu Symbol OK.svgGuter Versuch  und Vorlage {{Flausch|Dankle für Deine Hilfe.}} zu Flausch.svgLeider noch etwas Arbeit zu Tun.  Oder aber Vorlage {{NotOK}} zu Warnschild.png Nicht OK , bzw. Oder aber Vorlage {{NotOK|noch einige Punkte offen}} zu Warnschild.png bin schon dran.  .))
  • Die Syntax wird also mit der Vorlage übernommen, im Weiteren: Die Schriftfarbe.


4. Vorlagen mit Parameter

Parameter = Befehlspunkt, sind variable Befehlspunke, die ausgetauscht werden können. Damit wird ein Teile der Vorlage dynamisch gestalten, z.B. die Farbcodes austauschen. Parameter werden immer durch einen senkrechten Strich (Pipe) abgetrennt.

Werden die Parameter dann geändert, bei den Schriftfarben: die Farbcodes (Standardnamen oder HEX-Codes), verändert die Syntax der Vorlage den Text, hier: Was nach dem zweiten | folgt, erhält die neue Farbe.

  • Parameter werden mit drei geschwungene Klammern {{{ }}} in eine Vorlage eingefügt, die selbst von zwei geschwungen Klammern {{ }}umschlossen ist.
{{{Farbe}}} = Parameter 1 (Variable)
{{{Text}}} = Parameter 2 (Variable)in diesen Parameter kann ein Text eingesetzt werden, der dann bunt wird.
  • Wird die Vorlage genutzt, wird auf der neuen Seite, wo der Vorlage-Link eingebunden worden ist, ein Parameter eingegeben (die Varibale ausgetauscht).
z.B.
Befehl: {{Schriftfarbe|Farbe=Farbcode|Text=Deinen farbigen Text hier eingeben!}}
Befehl: {{Schriftfarbe|Farbe=#0000FF|das wird dann im Farbcode dargestellt.}}, ergibt: das wird dann im Farbcode dargestellt.
Das in der Syntax in 3 Klammern stehende:{{{Farbe}}} wird über Farbe=#0000FF angesprochen.
Das in der Syntax in 3 Klammern stehende:{{{Text}}} wird über Text=Hier etwas schreiben. angesprochen.
Die senkrechten | sind hier die Trenner zwischen den verschiedenen Parametern.

5. Vorlage-Link

Innerhalb der Vorlage steht dann der Vorlage-Link mit 2 geschwungenen Klammern.

  • Vorlage-Link: Der Name der Vorlage generiert sich aus dem Seitennamen und ist ein Link. Er wird von der Vorlageseite kopiert und in die gewünschte Seite eingesetzt.
Für das Beispiel von oben:{{Schriftfarbe}}
oder z.B. {{Seitenlayout:Gesundheitspiraten}}
dies ist der Seitenname im Wiki ohne den ersten Teil, der nur ein Bestandteil der Wikiadresse oder Url des Wikis ist: wiki.piratenpartei.de/,
also komplett: wiki.piratenpartei.de/Seitenlayout:Gesundheitspiraten
Ob ein Unterstrich geschrieben wird, hängt ab, ob er in der Vorlage geschrieben wurde.
  • Vorlage-Link kann auch bedeuten, dass innerhalb der Vorlage der Vorlagename mit 2 geschwungenen Klammern steht, dahinter die Parameter (Variablen) jeder mit | abgetrennt, jeweils in drei geschwungenen Klammern.
Befehl: {{Farbe|Textfarbe=Farbcode|Text=Deinen farbigen Text hier eingeben!}}
Begründung: Du mußt bei der Ausführung die Parameter, die in der Syntax stehen, auch in der Form, wie sie dort stehen, ansprechen oder ausführen.
Wenn in der Syntax die Parameter 1 und 2 stehen ! Hierbei ist die Parametereingabe unwichtig, da in der Ausführung die Parameter auf Grund der Eingabe richtig stehen. Parameter 1 = Farbcode, Parameter 2 = Text. Nur vertauschen geht dann nicht.
Bei der Bezeichnung der Parameter Farbe und Text, ist die Reihenfolge egal, weil sie direkt und speziel angesprochen werden.
Wenn ich statt Parameter (((Farbe))) den Parameter (((1))) verwende und statt Parameter (((Text))) - (((2))) nehme werden die Parameter automatisch über die Schreibweise in der Reihenfolge 1, 2 angesprochen.
1.((Vorlagename| 1 | 2 )) durch dieses Befehlsschema wird automatisch aufgerufen oder nacheinander 1, -- 2,
2.((Vorlagename| Farbe | Text )) hier wird über Text= und Farbe= aufgerufen.


Help-content.svg

6. Vorlageschleife entfernen

So, und wenn Du nun eine Vorlageschleife erstellt hast,

  • dann löschst du alles wieder außer dem Text/Graphik, was als Vorlage erscheinene soll.
  • Was bedeutet, dass nur Schritt 1. stehen bleibt (= Seitenname) und wir hier ab Schritt 2. weitermachen:

<onlyinclude>

  • kommt über Deinen Text/Graphik (= Deine Vorlage).
  • Du kopierst Folgendes und setzt es darunter:
</onlyinclude><noinclude>__NOTOC__

----

=== Benutzung ===
{{Vorlage snippet}}

=== Erklärung ===
Der obrige Vorlagenlink fügt Text und Bild ''(erkläre hier evtl. Deine Absichten)''an der Einfügestelle ein.

=== Ersteller ===
Diese Vorlage wurde von ''(hier: Deine Signatur)'' erstellt.

=== Bezüge ===<br/>
Diese Vorlage verwendet keine Vorlagen als Vorgabe.<br/><nowiki/>
<nowiki>Diese Vorlage verwendet ''(evtl. Link der Datei und CC)'', als Vorlage.

=== Benutzer ===
{{Vorlage:Vorlagennutzer}}

''Kategorie nicht vergessen, z.B.''

[[Kategorie:Kreatives|''''Name der Vorlage'''']]

</noinclude>

7. Bezüge

Crystal Clear action bookmark.svg Als Bezüge hier: Farbpaletten, für die Parameter die entsprechenden HEX-Codes:

Piratige Farben
Farbnamen
Internationale Farbcodes
Farben-Umrechner


Bei Fragen an IT/Wiki-Team oder Steuerrad oder Paten wenden.

Erstellt von -- Wika 01:04, 18. Nov. 2012 (CET)


Wiki-VorlageComputer und TechnikWiki