Vorlage:Str left/Doku
Aus MosaPedia
| Diese Seite ist die Dokumentations-Unterseite der Vorlage:Str left. |
Diese Vorlage steht unter der folgenden Lizenz und darf unter den Bedingungen dieser Lizenz weiterverbreitet werden (Benutzer:Kobold 08.01.2012):
  
| Diese Vorlage wurde unter der Lizenz „Creative Commons Namensnennung–Weitergabe unter gleichen Bedingungen“ (abgekürzt „cc-by-sa“) in der Version 3.0 veröffentlicht. Rechtsverbindlicher Lizenzvertrag: http://creativecommons.org/licenses/by-sa/3.0/legalcode Kurzfassung in deutscher Sprache: http://creativecommons.org/licenses/by-sa/3.0/deed.de |
Die Vorlage str left liefert den Anfang eines Textes (Strings) bis zu einer vorgegebenen Länge.
Inhaltsverzeichnis |
Benutzung
{{str left|Text|Anzahl}}
Die Vorlage gibt die ersten Anzahl Zeichen von Text zurück (jedoch nicht mehr als 500 Zeichen).
Bei nicht angegebener Anzahl wird ein Zeichen, bei ungültiger Anzahl wird nichts (ein Leerstring) zurückgegeben.
Grenzen
Die folgenden Limitierungen sind von der zugrundeliegenden Parser-Funktion {{padleft: }} [1] geerbt:
- Die Funktion liefert maximal 500 Zeichen (auch wenn eine größere Länge angegeben wird).
- Leerzeichen am Anfang und am Ende von Text werden "stillschweigend" entfernt.
- Vorsicht ist bei Wiki-Formatierung ( [[...]], {|...|} usw.), HTML-Entities und -tags (z.B. , <div>...</div>) sowie Parser-Tags wie <nowiki> geboten: Diese aus mehreren Zeichen bestehenden Elemente werden von der Vorlage:str left ggf. in ihre Einzelteile zerlegt (Beispiele siehe unten).
Die hier vorliegende Vorlage unterscheidet sich geringfügig von den gleichnamigen Vorlagen in der Wikipedia de en:
- sie arbeitet sinnvoll, wenn der übergebene Text kürzer als die angeforderte Anzahl von Zeichen ist (der Text wird nicht vervielfältigt, um auf die vorgegebene Länge zu kommen).
- Leerzeichen werden auch vom Ende des Ergebnisses entfernt.
Damit kann hier im Unterschied zur WP-Version das Ergebnis kürzer als die geforderte Anzahl Zeichen sein.
Beispiele (1) Anwendung
Einfacher Text
"{{str left|Anna, Bella und Caramella|5}}"
"{{str left|Anna, Bella und Caramella|10}}"
"{{str left|Anna, Bella und Caramella|20}}"
"{{str left|Anna, Bella und Caramella|23}}"
"{{str left|Anna, Bella und Caramella|25}}"
"{{str left|Anna, Bella und Caramella |25}}"
"{{str left| Anna, Bella und Caramella|25}}"
"{{str left| Anna, Bella und Caramella |27}}"
"{{str left| Anna, Bella und Caramella |100}}"
| "Anna," "Anna, Bell" "Anna, Bella und Cara" "Anna, Bella und Caramel" "Anna, Bella und Caramella" "Anna, Bella und Caramella" "Anna, Bella und Caramella" "Anna, Bella und Caramella" "Anna, Bella und Caramella" | "Anna," |
Kleine, leere, ungültige Anzahl
"{{str left|Anna, Bella und Caramella|1}}"
"{{str left|Anna, Bella und Caramella|0}}"
"{{str left|Anna, Bella und Caramella|}}"
"{{str left|Anna, Bella und Caramella }}"
"{{str left|Anna, Bella und Caramella}}"
"{{str left|Anna, Bella und Caramella|nix}}"
| "A" "" "" "A" "A" "" | "A" |
Wikitext
{{str left|[[Anna]], [[Bella]] und [[Caramella]]|5}}
{{str left|[[Anna]], [[Bella]] und [[Caramella]]|10}}
{{str left|[[Anna]], [[Bella]] und [[Caramella]]|20}}
{{str left|[[Anna]], [[Bella]] und [[Caramella]]|30}}
{{str left|[[Anna]], [[Bella]] und [[Caramella]]|40}}
| [[Ann [[Anna]], [[Anna]], [[Bella]] [[Anna]], [[Bella]] und [[Cara [[Anna]], [[Bella]] und [[Caramella]] |
{{str left|flotter [[Bild:Hapfff.png]] Käfer|5}}
{{str left|flotter [[Bild:Hapfff.png]] Käfer|10}}
{{str left|flotter [[Bild:Hapfff.png]] Käfer|20}}
{{str left|flotter [[Bild:Hapfff.png]] Käfer|30}}
| flott flotter [[ flotter [[Bild:Hapff flotter [[Bild:Hapfff.png]] Kä | flott |
Vorlageneinbindung
Siehe auch Vorlage:Artikelvorschau
{{str left| {{:Bär}} |10}}
{{str left| {{:Bär}} |20}}
{{str left| {{:Bär}} |48}}
| [[Bild:Bae [[Bild:Baerchen.jpg| [[Bild:Baerchen.jpg|right|frame|[[Bärchen Lars]] | [[Bild:Bae |
{{str left| {{:Bär}} |100}}
| [[Bild:Baerchen.jpg|right|frame|[[Bärchen Lars]]]] Im Mosaik tauchen verschiedene '''Bären''' auf. |
Im Mosaik tauchen verschiedene Bären auf. |
Beispiele (2) Probleme
HTML-Entities
wie z.B.♥= ♥,
—= —, werden als mehrere Zeichen gezählt und durch die Vorlage:str left ggf. in ihre Bestandteile "zerlegt":
{{str left|Anna♥Bella—Caramella|5}}
{{str left|Anna♥Bella—Caramella|10}}
{{str left|Anna♥Bella—Caramella|12}}
{{str left|Anna♥Bella—Caramella|20}}
{{str left|Anna♥Bella—Caramella|30}}
{{str left|Anna♥Bella—Caramella|33}}
| Anna& Anna&heart Anna♥ Anna♥Bella&md Anna♥Bella—Carame Anna♥Bella—Caramella | Anna& |
HTML-Tags
Da der übergebene Text ein "=" enthält, müssen die Vorlagen-Parameter mit Nummern (1=, 2=) angegeben werden.
{{str left|1=Anna <span style="color:red">Bella</span> Caramella|2=5}}
{{str left|1=Anna <span style="color:red">Bella</span> Caramella|2=25}}
{{str left|1=Anna <span style="color:red">Bella</span> Caramella|2=40}}
{{str left|1=Anna <span style="color:red">Bella</span> Caramella|2=50}}
| Anna Anna <span style="color:r Anna <span style="color:red">Bella</span Anna <span style="color:red">Bella</span> Caramell | Anna |
Parser-Tags
Parser-Tags wie <nowiki>, <pre> usw. werden intern durch 43 "kryptische" Zeichen repräsentiert
{{str left|Ein <nowiki>[[Bär]]</nowiki> im Käfig|4}}
{{str left|Ein <nowiki>[[Bär]]</nowiki> im Käfig|5}}
{{str left|Ein <nowiki>[[Bär]]</nowiki> im Käfig|10}}
{{str left|Ein <nowiki>[[Bär]]</nowiki> im Käfig|45}}
{{str left|Ein <nowiki>[[Bär]]</nowiki> im Käfig|46}}
{{str left|Ein <nowiki>[[Bär]]</nowiki> im Käfig|47}}
{{str left|Ein <nowiki>[[Bär]]</nowiki> im Käfig|56}}
| Ein Ein Ein UNIQ6 Ein UNIQ63456bc36543413d-nowiki-00000028-QIN Ein UNIQ63456bc36543413d-nowiki-00000029-QINU Ein [[Bär]] Ein [[Bär]] im Käfig | Ein |
