Hilfe:Vorlagen: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
K (+Hinweis (keine /Dokus anlegen!)) |
(→Dokumentation Auslagern: Doku angepasst und WiMus Hinweis auskommentiert, weil das wird demnächst wohl nichts...) |
||
| (5 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
| Zeile 33: | Zeile 33: | ||
===Parameter: Zusammenhang zwischen Artikel und Vorlage:=== | ===Parameter: Zusammenhang zwischen Artikel und Vorlage:=== | ||
| − | Im Artikel werden die Parameter innerhalb der geschweiften Klammern der Vorlageneinbindung ('''<nowiki>{{...}}</nowiki>''') übergeben und sind jeweils mit einem "|" getrennt (hier am Beispiel eines Artikels der eine Vorlage namens '' | + | Im Artikel werden die Parameter innerhalb der geschweiften Klammern der Vorlageneinbindung ('''<nowiki>{{...}}</nowiki>''') übergeben und sind jeweils mit einem "|" getrennt (hier am Beispiel eines Artikels der eine Vorlage namens ''Textfarbe'' (also [[Vorlage:Textfarbe]]) einbindet): |
| − | ::'''<tt><nowiki>{{ | + | ::'''<tt><nowiki>{{Textfarbe|green|Ich bin grün}}</nowiki></tt>''' |
In der Vorlage ''Text-Farbe'' stehen dann die übergebenen Werte am Ort ihrer Platzhalter zur Verfügung: | In der Vorlage ''Text-Farbe'' stehen dann die übergebenen Werte am Ort ihrer Platzhalter zur Verfügung: | ||
::'''<tt><nowiki>{{{1}}}</nowiki></tt> würde dann beim Aufruf mit "<tt>green</tt>" und <tt>{{{2}}}</tt> mit "<tt>Ich bin grün</tt>" ersetzt werden.''' | ::'''<tt><nowiki>{{{1}}}</nowiki></tt> würde dann beim Aufruf mit "<tt>green</tt>" und <tt>{{{2}}}</tt> mit "<tt>Ich bin grün</tt>" ersetzt werden.''' | ||
| − | Wir gehen mal davon aus, dass Folgendes in der Vorlage '' | + | Wir gehen mal davon aus, dass Folgendes in der Vorlage ''Textfarbe'' steht: |
::<tt>'''<nowiki><span style="color:{{{1}}}">{{{2}}}</span></nowiki>'''</tt> | ::<tt>'''<nowiki><span style="color:{{{1}}}">{{{2}}}</span></nowiki>'''</tt> | ||
Im Artikel würde man es vielleicht so einsetzen: | Im Artikel würde man es vielleicht so einsetzen: | ||
| − | ::<tt>'''Die politische Gesinnung kann auch durch die Farbe ausgedrückt werden: <nowiki>{{ | + | ::<tt>'''Die politische Gesinnung kann auch durch die Farbe ausgedrückt werden: <nowiki>{{Textfarbe|green|Ich bin grün}}</nowiki>'''</tt> |
Was dann als Ergebnis im Artikel etwa so aussehen würde: | Was dann als Ergebnis im Artikel etwa so aussehen würde: | ||
| − | ::'''Die politische Gesinnung kann auch durch die Farbe ausgedrückt werden: {{ | + | ::'''Die politische Gesinnung kann auch durch die Farbe ausgedrückt werden: {{Textfarbe|green|Ich bin rot}}''' |
::<small>…oder so ähnlich :-)</small> | ::<small>…oder so ähnlich :-)</small> | ||
| Zeile 48: | Zeile 48: | ||
Theoretisch bestehen alle übergebenen Parameter aus einem Namen, einem "=" und einem Wert, der Einfachheit halber wurde angenommen, dass unbenannte Parameter Nummern als Namen haben. Also würde es eigentlich so heissen: | Theoretisch bestehen alle übergebenen Parameter aus einem Namen, einem "=" und einem Wert, der Einfachheit halber wurde angenommen, dass unbenannte Parameter Nummern als Namen haben. Also würde es eigentlich so heissen: | ||
| − | ::'''<tt><nowiki>{{ | + | ::'''<tt><nowiki>{{Textfarbe|1=green|2=Ich bin grün}}</nowiki></tt>''' |
Der dritte Parameter würde dann "3=" heissen der Vierte "4=" usw. | Der dritte Parameter würde dann "3=" heissen der Vierte "4=" usw. | ||
| Zeile 54: | Zeile 54: | ||
Sollen mehrere Parameter übergeben werden, ist es oft sinnvoll "sprechende" Namen zu wählen wie zB. "Text=", "Farbe=", "Breite=" usw. (Bsp: [[Vorlage:Systematik Film]]) damit Kamel auch gleich weiss, was es zu bedeuten hat. Im Beispiel der Vorlage ''Text-Farbe'' würde das dann so aussehen: | Sollen mehrere Parameter übergeben werden, ist es oft sinnvoll "sprechende" Namen zu wählen wie zB. "Text=", "Farbe=", "Breite=" usw. (Bsp: [[Vorlage:Systematik Film]]) damit Kamel auch gleich weiss, was es zu bedeuten hat. Im Beispiel der Vorlage ''Text-Farbe'' würde das dann so aussehen: | ||
| − | ::'''<tt><nowiki>{{ | + | ::'''<tt><nowiki>{{Textfarbe|Farbe=green|Text=Ich bin grün}}</nowiki></tt>''' |
Und in der Vorlage selbst stünden dann die Parameter unter den entsprechenden Namen bereit: | Und in der Vorlage selbst stünden dann die Parameter unter den entsprechenden Namen bereit: | ||
::'''<tt><nowiki>{{{Farbe}}}</nowiki></tt> hätte dann den Inhalt "<tt>green</tt>" und der Parameter <tt><nowiki>{{{Text}}}</nowiki></tt> hätte dann "<tt>Ich bin grün</tt>" drin''' | ::'''<tt><nowiki>{{{Farbe}}}</nowiki></tt> hätte dann den Inhalt "<tt>green</tt>" und der Parameter <tt><nowiki>{{{Text}}}</nowiki></tt> hätte dann "<tt>Ich bin grün</tt>" drin''' | ||
| Zeile 64: | Zeile 64: | ||
*Für die Parameter kann in der Vorlage jeweils ein Defaultwert (dt.: Vorgabewert) eingesetzt werden: | *Für die Parameter kann in der Vorlage jeweils ein Defaultwert (dt.: Vorgabewert) eingesetzt werden: | ||
| − | :Nehmen wir mal an, wir erweitern in der Vorlage '' | + | :Nehmen wir mal an, wir erweitern in der Vorlage ''Textfarbe'' den Parameter 1 zu <nowiki>{{{1|gold}}}</nowiki>. Wird nun <nowiki>{{Textfarbe||Ich bin Gold}}</nowiki> Aufgerufen ergibt sich: {{Textfarbe|gold|Ich bin Gold}} |
:*„Leer“ und „nicht verwendet“ ist nicht identisch! Damit das Defaultwert-Dingens tut, muss der Parameter beim Aufruf komplett weggelassen werden, oder in der Vorlage anders abgefangen werden (sowas wie: <nowiki>{{#if:{{{Farbe|}}}|{{{Farbe}}}|gold}}</nowiki>) | :*„Leer“ und „nicht verwendet“ ist nicht identisch! Damit das Defaultwert-Dingens tut, muss der Parameter beim Aufruf komplett weggelassen werden, oder in der Vorlage anders abgefangen werden (sowas wie: <nowiki>{{#if:{{{Farbe|}}}|{{{Farbe}}}|gold}}</nowiki>) | ||
:Der Nutzen von <nowiki>{{{Farbe|}}}</nowiki> liegt darin, dass ein Defaultwert von "" (nichts) angenommen wird und in der Vorlagenverarbeitung auch diesen Wert annimmt. | :Der Nutzen von <nowiki>{{{Farbe|}}}</nowiki> liegt darin, dass ein Defaultwert von "" (nichts) angenommen wird und in der Vorlagenverarbeitung auch diesen Wert annimmt. | ||
*Werte die ein "=" enthalten, müssen mit benanntem Parameter übergeben werden, also nicht | *Werte die ein "=" enthalten, müssen mit benanntem Parameter übergeben werden, also nicht | ||
| − | :<nowiki>{{ | + | :<nowiki>{{Textfarbe|red|http://www.google.com/search?hl=de}}</nowiki> sondern |
| − | :<nowiki>{{ | + | :<nowiki>{{Textfarbe|red|</nowiki>'''2='''<nowiki>http://www.google.com/search?hl=de}}</nowiki> |
:Dies, weil sonst Wiki denkt, dass man einen Parameter mit dem Namen "<nowiki>http://www.google.com/search?hl</nowiki>" mit dem Wert "de" übergeben möchte... | :Dies, weil sonst Wiki denkt, dass man einen Parameter mit dem Namen "<nowiki>http://www.google.com/search?hl</nowiki>" mit dem Wert "de" übergeben möchte... | ||
| Zeile 126: | Zeile 126: | ||
Vorlagen sind '''ALLE ohne Ausnahme''' in einer Kategorie einzufügen!!!! Solltest du anderer Meinung sein, dann lass die Hufe von Vorlagen! | Vorlagen sind '''ALLE ohne Ausnahme''' in einer Kategorie einzufügen!!!! Solltest du anderer Meinung sein, dann lass die Hufe von Vorlagen! | ||
| − | {{sa}}[[:Kategorie: | + | {{sa}}[[:Kategorie:Vorlagen]] |
===Dokumentation=== | ===Dokumentation=== | ||
| Zeile 132: | Zeile 132: | ||
===Dokumentation Auslagern=== | ===Dokumentation Auslagern=== | ||
| − | <center>{{nicht verwenden|text=Bitte vorerst keine Vorlagen-Dokumentationen (/Doku) anlegen!|name=Doku}}</center> | + | <!-- <center>{{nicht verwenden|text=Bitte vorerst keine Vorlagen-Dokumentationen (/Doku) anlegen!|name=Doku}}</center> --> |
Die Doku sollte spätestens dann ausgelagert werden, wenn die Vorlage innerhalb der gleichen Seite mehrmals geladen werden soll, das spart Systemmemory und man kann viiiiel mehr Vorlagen in eine Seite quetschen. | Die Doku sollte spätestens dann ausgelagert werden, wenn die Vorlage innerhalb der gleichen Seite mehrmals geladen werden soll, das spart Systemmemory und man kann viiiiel mehr Vorlagen in eine Seite quetschen. | ||
*Die Doku wird unter <nowiki>[[<Seitenname>/Doku]]</nowiki> abgespeichert. (Bsp: [[Vorlage:Mein Kunstwerk/Doku]]) | *Die Doku wird unter <nowiki>[[<Seitenname>/Doku]]</nowiki> abgespeichert. (Bsp: [[Vorlage:Mein Kunstwerk/Doku]]) | ||
| − | *In die Vorlage wird die Doku mit <nowiki><noinclude>{{<Seitenname>/Doku}}<noinclude></nowiki> eingefügt. | + | *In die '''Vorlage''' wird die Doku, dort wo sie sein sollte, mit <nowiki><noinclude>{{<Seitenname>/Doku}}<noinclude></nowiki> eingefügt. |
| − | *In der Doku sollte Folgendes (ganz zuunterst) enthalten sein: | + | *In der '''Doku''' sollte Folgendes (ganz zuunterst) enthalten sein: <nowiki>{{Doku bearbeiten}}</nowiki> Das gibt dem Kamel, dass die '''Vorlage''' anguckt einen direkten Link zur Doku, um sie anzupassen. |
| − | < | ||
| − | {{Doku bearbeiten}} | ||
| − | </ | ||
| − | |||
| − | Das gibt dem Kamel, dass die Vorlage anguckt einen direkten Link zur Doku, um sie anzupassen. | ||
Und nicht vergessen: | Und nicht vergessen: | ||
Aktuelle Version vom 25. August 2014, 16:44 Uhr
↓ Überblick
|
↓ Bearbeiten
|
↓ Artikel
|
↓ Multimedia
|
↓ Features
|
↓ Pseudo und Anti
|
Wozu braucht Kamel Vorlagen?[<small>bearbeiten</small>]
Um einen gewissen Look and Feel der Kamelo zu gewährleisten, werden einzelne Artikelteile standardisiert. Damit sie auch immer gleich aussehen und um es dem Kamel zu vereinfachen, gibt es Vorlagen. Ein beliebte Vorlage ist Beispielsweise Vorlage:Begriffsklärung
Wie fügt Kamel eine Vorlage ein?[<small>bearbeiten</small>]
Siehe vielleicht: Unser Sortiment unter Kamelopedia:Vorlagen
Hast du eine passende Vorlage gefunden, kannst du sie in deinem Artikel (oder auch sonstwo) verwenden und zwar so:
- Vorlagen werden mit {{Name der Vorlage}} eingesetzt.
- Vorlagen können auch Parameter haben, also Informationen, die man der Vorlage übergibt, um sie weiter anzupassen. Vorlagen mit Parametern werden so verwendet: {{Name der Vorlage|erster Parameter|zweiter Parameter|und|so|weiter}}. Welche Parameter welche Bedeutung haben, sollte aus der Doku zu jeder Vorlage ersichtlich sein, wenn nicht, erschlage das Kamel, dass sie gebaut hat.
- Wo auf einer Seite die Vorlage eingesetzt werden sollte, ist a) unterschiedlich (einige Tipps stehen bei den einzelnen Vorlagen) und b) umstritten bzw. Geschmackssache.
Goldener Kameltipp: Vorschau benutzen! - Ob überhaupt eine Vorlage eingesetzt werden sollte, ist eine wichtige und berechtigte Frage!
Wie baut Kamel eine Vorlage?[<small>bearbeiten</small>]
Zuerst sollte Kamel sich Gedanken darüber machen, ob dies auch Sinn macht. Unbedingt zu vermeiden ist eine Vorlagenflut!
Folgende Überlegungen sollte Kamel sich vorher (also vor dem Speichern) machen:
- Ist es möglich eine bestehende Vorlage zu erweitern?
- Rechtfertigt die zu erwartende Nutzung eine neue Vorlage?
Eine Vorlage wird ähnlich wie eine Artikel gemacht, zB. Vorlage:Mein Kunstwerk würde eine Vorlage ergeben, die später mit {{Mein Kunstwerk}} in eine andere Seite eingefügt werden würde (korrekt "Vorlage:" kann man sich beim Einbinden sparen).
Spezielle Notationen in Vorlagen[<small>bearbeiten</small>]
- <noinclude>xxxxxx</noinclude> Diese Konfiguration bedeutet, dass xxxxxx nicht an die einbindende Seite weitergereicht wird (xxxxxx kann durchaus mit etwas Intelligenterem ersetzt werden.). Werden Vorlagen in andere Seiten eingebunden, wird grundsätzlich alles, was die Vorlage beinhaltet, weitervererbt. Dies ist unter Umständen nicht wünschenswert, da Kommentare und Kategorien, die dem Vorlagenbau dienen nicht weitergereicht werden sollen.
- <includeonly>xxxxxx</includeonly> Diese Konfiguration bedeutet, dass xxxxxx in der Vorlage nicht ausgewertet wird und auch nicht angezeigt wird. Dies kann dienlich sein, um zB. der einbindenden Seite eine Kategorie zu geben, ohne dass die Vorlage selbst in diese Kategorie fällt. Ansonsten dient es der Kosmetik, zB. dem verstecken von Dingen die erst beim Einbinden funktionieren und sonst bei der Betrachtung der Vorlage hässliche Fehler und Falschdarstellungen verursachen.
- <onlyinclude>xxxxxx</onlyinclude> Diese Konfiguration ist eine Kombination der anderen 2 und übergibt nur das xxxxxxx. Es kann mehrmals unverschachtelt in der selben Vorlage benutzt werden.
Parameter[<small>bearbeiten</small>]
Um die Vorlagen flexibel zu machen, hat man den Kamelen Parameter gegeben.
Parameter: Zusammenhang zwischen Artikel und Vorlage:[<small>bearbeiten</small>]
Im Artikel werden die Parameter innerhalb der geschweiften Klammern der Vorlageneinbindung ({{...}}) übergeben und sind jeweils mit einem "|" getrennt (hier am Beispiel eines Artikels der eine Vorlage namens Textfarbe (also Vorlage:Textfarbe) einbindet):
- {{Textfarbe|green|Ich bin grün}}
In der Vorlage Text-Farbe stehen dann die übergebenen Werte am Ort ihrer Platzhalter zur Verfügung:
- {{{1}}} würde dann beim Aufruf mit "green" und {{{2}}} mit "Ich bin grün" ersetzt werden.
Wir gehen mal davon aus, dass Folgendes in der Vorlage Textfarbe steht:
- <span style="color:{{{1}}}">{{{2}}}</span>
Im Artikel würde man es vielleicht so einsetzen:
- Die politische Gesinnung kann auch durch die Farbe ausgedrückt werden: {{Textfarbe|green|Ich bin grün}}
Was dann als Ergebnis im Artikel etwa so aussehen würde:
- Die politische Gesinnung kann auch durch die Farbe ausgedrückt werden: Ich bin rot
- …oder so ähnlich :-)
Parameter: Varianten[<small>bearbeiten</small>]
Theoretisch bestehen alle übergebenen Parameter aus einem Namen, einem "=" und einem Wert, der Einfachheit halber wurde angenommen, dass unbenannte Parameter Nummern als Namen haben. Also würde es eigentlich so heissen:
- {{Textfarbe|1=green|2=Ich bin grün}}
Der dritte Parameter würde dann "3=" heissen der Vierte "4=" usw.
Sollen mehrere Parameter übergeben werden, ist es oft sinnvoll "sprechende" Namen zu wählen wie zB. "Text=", "Farbe=", "Breite=" usw. (Bsp: Vorlage:Systematik Film) damit Kamel auch gleich weiss, was es zu bedeuten hat. Im Beispiel der Vorlage Text-Farbe würde das dann so aussehen:
- {{Textfarbe|Farbe=green|Text=Ich bin grün}}
Und in der Vorlage selbst stünden dann die Parameter unter den entsprechenden Namen bereit:
- {{{Farbe}}} hätte dann den Inhalt "green" und der Parameter {{{Text}}} hätte dann "Ich bin grün" drin
Und so müsste dann der tatsächliche Inhalt der Vorlage Text-Farbe aussehen:
- <span style="color:{{{Farbe}}}">{{{Text}}}</span>
Parameter: Verhalten[<small>bearbeiten</small>]
- Parameter die nicht benutzt werden, werden im Artikel nicht dargestellt und werden als leer ausgegeben. Allerdings werden sie innerhalb der Vorlagenverarbeitung nicht einfach als leer angenommen, sondern die Verarbeitung wird an Huf des Strings "{{{1}}}" ausgeführt: Die Operation {{#sub:{{{1}}}|1|1}} wird, wenn der Parameter 1 nicht angegeben wird, eine "{" ausgeben.
- Für die Parameter kann in der Vorlage jeweils ein Defaultwert (dt.: Vorgabewert) eingesetzt werden:
- Nehmen wir mal an, wir erweitern in der Vorlage Textfarbe den Parameter 1 zu {{{1|gold}}}. Wird nun {{Textfarbe||Ich bin Gold}} Aufgerufen ergibt sich: Ich bin Gold
- „Leer“ und „nicht verwendet“ ist nicht identisch! Damit das Defaultwert-Dingens tut, muss der Parameter beim Aufruf komplett weggelassen werden, oder in der Vorlage anders abgefangen werden (sowas wie: {{#if:{{{Farbe|}}}|{{{Farbe}}}|gold}})
- Der Nutzen von {{{Farbe|}}} liegt darin, dass ein Defaultwert von "" (nichts) angenommen wird und in der Vorlagenverarbeitung auch diesen Wert annimmt.
- Werte die ein "=" enthalten, müssen mit benanntem Parameter übergeben werden, also nicht
- {{Textfarbe|red|http://www.google.com/search?hl=de}} sondern
- {{Textfarbe|red|2=http://www.google.com/search?hl=de}}
- Dies, weil sonst Wiki denkt, dass man einen Parameter mit dem Namen "http://www.google.com/search?hl" mit dem Wert "de" übergeben möchte...
- Weitere Problemzeichen:
- Werden folgende Zeichen in Parameterwerten benötigt, müssen sie vor Wiki "versteckt" werden:
Zeichen Ersatz Ersatz, wenn es für Tabellen benötigt wird | | {{!}} {| {| {{(!}} |} |} {{!)}}
Kategorie[<small>bearbeiten</small>]
Vorlagen sind ALLE ohne Ausnahme in einer Kategorie einzufügen!!!! Solltest du anderer Meinung sein, dann lass die Hufe von Vorlagen!
Siehe auch: Kategorie:Vorlagen
Dokumentation[<small>bearbeiten</small>]
Da Wiki etwas doof ist und den gesamten Inhalt einer Vorlage beim Parsen zuerst mal lädt und erst nachdem das Memory versaut ist die <noinclude>s wegwirft (was aber nix nützt), ist es wichtig darauf zu achten, dass der Text im <noinclude> so sparsam wie möglich ist oder aber ausgelagert wird.
Dokumentation Auslagern[<small>bearbeiten</small>]
Die Doku sollte spätestens dann ausgelagert werden, wenn die Vorlage innerhalb der gleichen Seite mehrmals geladen werden soll, das spart Systemmemory und man kann viiiiel mehr Vorlagen in eine Seite quetschen.
- Die Doku wird unter [[<Seitenname>/Doku]] abgespeichert. (Bsp: Vorlage:Mein Kunstwerk/Doku)
- In die Vorlage wird die Doku, dort wo sie sein sollte, mit <noinclude>{{<Seitenname>/Doku}}<noinclude> eingefügt.
- In der Doku sollte Folgendes (ganz zuunterst) enthalten sein: {{Doku bearbeiten}} Das gibt dem Kamel, dass die Vorlage anguckt einen direkten Link zur Doku, um sie anzupassen.
Und nicht vergessen:
<noinclude>[[Kategorie:Vorlagen Dokumentation|{{PAGENAME}}]]</noinclude>
Siehe auch: Kategorie:Vorlagen Dokumentation
Verwaltung[<small>bearbeiten</small>]
Damit Vorlagen auch anderen Kamelen zugänglich gemacht werden können, sollten diese an 2 Orten eingetragen werden:
- Kamelopedia:Vorlagen
- Hilfe:Edittools.js (Dort sind die Klick-Vorlagen rechts vom Editfeld beim "Bearbeiten", Cache leeren nicht vergessen)
Beides ist leider nicht grade selbsterklärend...
Zu beachten[<small>bearbeiten</small>]
- Es ist eine Unsitte HTML-Tags offen zu lassen (also zB. <div> ohne </div> am Schluss). Dies kann bei Vorlagen zu völlig unerwarteten Effekten bei der Einbindung führen.