Bearbeiten von Vorlage:Mehrere Bilder/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>

{{Lizenz CC-by-sa-3.0|quelle=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.

== Benutzung ==
=== Kopiervorlage ===
<pre style="width: 25em;">
{{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
}}
</pre>

=== 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. <tt>{center}</tt>).
*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===
{{Mehrere Bilder
 | Fußzeile = Spieler erhalten als Verwarnung eine gelbe Karte und werden mit einer roten Karte des Feldes verwiesen.
 | Breite   = 60
 | Bild1    = Yellow card.svg
 | Bild2    = Red card.svg
}}
<pre style="width: 20em; float:left;">{{Mehrere Bilder
 | Fußzeile = Spieler erhalten…
 | Breite   = 60
 | Bild1    = Yellow card.svg
 | Bild2    = Red card.svg
}}</pre>

<br style="clear: both;">
===Vertikale Ausrichtung===
{{Mehrere Bilder
 | align       = left
 | Richtung    = vertical
 | Kopfzeile   = [[Laudanum]]
 | Breite      = 200
 | Bild1       = Huygens Laudanum1.jpg
 | Untertitel1 = Ein Schluck…
 | Bild2       = Huygens Laudanum2.jpg
 | Untertitel2 = …zeigt Wirkung
}}
<pre style="width: 25em; float:right;">{{Mehrere Bilder
 | align       = left
 | Richtung    = vertical
 | Kopfzeile   = [[Laudanum]]
 | Breite      = 200
 | Bild1       = Huygens Laudanum1.jpg
 | Untertitel1 = Ein Schluck…
 | Bild2       = Huygens Laudanum2.jpg
 | Untertitel2 = …zeigt Wirkung
}}</pre>

<br style="clear: both;">
===Beispiel mit Hintergrundfarbe===
{{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
}}
<pre style="width: 44em; float:left;">
{{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
}}
</pre>
<br style="clear: both;">

== 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<pre
><div class="thumb tleft">&#10;<div class="thumb tnone">&#10;<div class="thumb tright">&#10;<div class="thumbinner">&#10;<div class="thumbimage">&#10;<div class="thumbcaption"></pre
>eingebettet. Diese Bausteine sind dieselben, die von der Wikimedia-Software auch für gerahmte Bilder und Miniaturbilder ''(framed, thumbnail images)'' verwendet werden: darum sieht <tt><nowiki>{{Mehrere Bilder|...}}</nowiki></tt> genauso aus wie diese. <br /> Die zu diesen ''Classes'' gehörenden ''Style''-Attribute sind in den CSS-Files des jeweiligen [http://www.mediawiki.org/wiki/Help:Skins Skins] definiert, d.h. das Aussehen von <tt><nowiki>{{Mehrere Bilder|...}}</nowiki></tt> wird ebenso wie das der ''Thumbnails'' ggf. von dem unter [[Spezial:Einstellungen|Benutzereinstellungen]] eingestellten ''Skin'' beeinflusst.

* Die Vorlage benutzt die [http://www.mediawiki.org/wiki/Help:Extension:ParserFunctions Parser-Funktionen]<pre
>#if #ifeq #switch #expr</pre
>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.<br
/>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 <code><nowiki>{{#expr: (<Höhe Soll> * <Breite Ist> / <Höhe Ist>) round 0}}</nowiki></code> durch den Wiki-Parser ausrechnen zu lassen.

<!-- Kategorie für Hauptseite steht _hier_, damit sie geändert werden kann, während die Hauptseite gesperrt ist -->
<includeonly>[[Kategorie:Vorlage:Formatierungshilfe|{{PAGENAME}}]]</includeonly>