Vorlage:Mehrere Bilder/Doku

Aus MosaPedia

(Unterschied zwischen Versionen)

Version vom 01:09, 4. Jan. 2011

Diese Seite ist die Dokumentations-Unterseite der Vorlage:Mehrere Bilder.

Dieser Text steht unter der Lizenz Creative Commons Attribution-ShareAlike 3.0 Unported
Lizenzbestimmungen unter http://creativecommons.org/licenses/by-sa/3.0/legalcode
Kurzfassung in deutscher Sprache http://creativecommons.org/licenses/by-sa/3.0/deed.de

Der Text enthält (ggf. modifizierte) Beiträge aus folgenden Quellen:
http://de.wikipedia.org/wiki/Vorlage:Mehrere_Bilder/Doku (Stand 3. März 2010, abgerufen 02.01.2011)

Diese Vorlage dient zum Anzeigen von zwei bis fünf Bildern in einem Kasten, wobei die Bilder nebeneinander oder übereinander platziert werden können. Die Verwendung der Vorlage bietet sich insbesondere bei inhaltlich zusammengehörenden Bildern an.

Die Benutzung der Vorlage gestaltet sich sehr einfach, die technischen Details (deren Kenntnis zur Benutzung nicht erforderlich ist) sind um einiges komplizierter.

Inhaltsverzeichnis

1 Benutzung
- 1.1 Kopiervorlage
- 1.2 Parameter
2 Beispiele
3 Technische Details

Benutzung

Kopiervorlage

{{Mehrere Bilder
 | align       = left/right/{center}
 | Richtung    = {horizontal}/vertical
 | Breite      = 
 | Bild1       = 
 | Breite1     = 
 | Untertitel1 = 
 | Bild2       = 
 | Breite2     = 
 | Untertitel2 = 
 | Bild3       = 
 | Breite3     = 
 | Untertitel3 = 
 | Bild4       = 
 | Breite4     = 
 | Untertitel4 = 
 | Bild5       = 
 | Breite5     = 
 | Untertitel5 = 
 | Hintergrund = #FARBE
 | Kopfzeile   = 
 | Kopfzeile_align = left/right/{center}
 | Kopfzeile_Hintergrund = #FARBE
 | Fußzeile    = 
 | Fußzeile_align = {left}/right/center
 | Fußzeile_Hintergrund = #FARBE
}}

Parameter

Alle von der Vorlage unterstützten Parameter sind oben in der Kopiervorlage aufgeführt.

Alle Parameter bis auf Bild1, Bild2 und die zugehörigen Breiten sind optional.
Die Standardwerte für die Ausrichtung sind oben mit Klammern hervorgehoben (z.B. {center}).
Die Breiten sind als "nackte" Zahlen anzugeben (ohne "px"). Die Breiten der eingebundenen Bilder müssen immer angegeben werden, entweder global oder individuell.
Der Parameter Breite überschreibt die Parameter Breite1, Breite2, Breite3, Breite4 und Breite5. Wenn die Bilder unterschiedliche Breiten haben (sollen), muss der Parameter Breite weggelassen werden.

Beispiele

Horizontale Ausrichtung

Datei:Yellow card.svg

Datei:Red card.svg

Spieler erhalten als Verwarnung eine gelbe Karte und werden mit einer roten Karte des Feldes verwiesen.

{{Mehrere Bilder
 | Fußzeile = Spieler erhalten…
 | Breite   = 60
 | Bild1    = Yellow card.svg
 | Bild2    = Red card.svg
}}

Vertikale Ausrichtung

Laudanum

Ein Schluck…

…zeigt Wirkung

{{Mehrere Bilder
 | align       = left
 | Richtung    = vertical
 | Kopfzeile   = [[Laudanum]]
 | Breite      = 200
 | Bild1       = Huygens Laudanum1.jpg
 | Untertitel1 = Ein Schluck…
 | Bild2       = Huygens Laudanum2.jpg
 | Untertitel2 = …zeigt Wirkung
}}

Beispiel mit Hintergrundfarbe

Anna

Bella

Caramella

Die drei Hauptfiguren aus dem Mädchen-Mosaik

{{Mehrere Bilder
 | Hintergrund = #FFCAD8
 | Bild1=Anna ABC001.jpg      | Breite1=166 | Untertitel1=[[Anna]]
 | Bild2=Bella ABC001.jpg     | Breite2=171 | Untertitel2=[[Bella]]
 | Bild3=Caramella ABC001.jpg | Breite3=150 | Untertitel3=[[Caramella]]
 | Fußzeile       = Die drei Hauptfiguren aus dem [[Mädchen-Mosaik]]
 | Fußzeile_align = center
}}

Technische Details

Herkunft

Der Code der Vorlage ist unmodifiziert von http://de.wikipedia.org/wiki/Vorlage:Mehrere_Bilder übernommen, die Dokumentation wurde überarbeitet und an die MosaPedia angepasst. In der deutschsprachigen Wikipedia wird die Vorlage Mehrere_Bilder derzeit (nur) ca. 200mal eingebunden, sie dürfte damit hinreichend getestet sein. In der englischsprachigen Wikipedia gibt es eine ähnliche Vorlage, die ca. 4500mal verwendet wird.

Interna

Zur Positionierung der Bilder wird HTML-Code erzeugt. Die Einbindung der Einzelbilder wird dabei in entsprechend verschachtelte
```
<div class="thumb tleft">
<div class="thumb tnone">
<div class="thumb tright">
<div class="thumbinner">
<div class="thumbimage">
<div class="thumbcaption">
```
eingebettet. Diese Bausteine sind dieselben, die von der Wikimedia-Software auch für gerahmte Bilder und Miniaturbilder (framed, thumbnail images) verwendet werden: darum sieht {{Mehrere Bilder|...}} genauso aus wie diese.
Die zu diesen Classes gehörenden Style-Attribute sind in den CSS-Files des jeweiligen Skins definiert, d.h. das Aussehen von {{Mehrere Bilder|...}} wird ebenso wie das der Thumbnails ggf. von dem unter Benutzereinstellungen eingestellten Skin beeinflusst.

Die Vorlage benutzt die Parser-Funktionen
```
#if #ifeq #switch #expr
```
d.h. die ParserFunctions-Extension muss auf dem Server installiert sein (unter Spezial:Version#Installierte Erweiterungen kann man sich davon überzeugen, dass das der Fall ist).

Grenzen, Nachteile

Bilder können nur entweder horizontal oder vertikal in einer Reihe angeordnet werden, aber nicht als Matrix.
Die Anzahl der Bilder ist auf fünf beschränkt. (Diese Grenze läßt sich bei Bedarf leicht nach oben verschieben; die Version in der englischen Wikipedia unterstützt bis zu zehn Bilder.)
Die englische Version unterstützt zusätzlich Bild-Links und Alt-Texte. (Nachrüstbar.)
Auch wenn Bilder nicht skaliert werden sollen, müssen immer die Breiten angegeben werden. Die Angabe der Bildhöhe ist nicht möglich.
Gerade bei der horizontalen Anordnung wäre letzteres wünschenswert, um alle Bilder auf eine Höhe zu bringen. In der englischen Version wird in dieser Situation empfohlen, die für die gewünschte Höhe benötigte Breite mit dem Ausdruck {{#expr: (<Höhe Soll> * <Breite Ist> / <Höhe Ist>) round 0}} durch den Wiki-Parser ausrechnen zu lassen.