Ver el código de «Plantilla:Imagen múltiple/doc»

{{subpágina de documentación}}
{{plantilla con Lua|módulo=Imagen múltiple}}

=== Uso ===
Esta plantilla genera una tabla con varias imágenes, dispuestas horizontal o verticalmente. Además permite la posibilidad de incluir un título para la tabla y un pie de foto para toda la tabla o para cada imagen.

Para su inclusión en un artículo, copia y pega el siguiente código, rellenando los campos tras el signo "=" con los valores correspondientes:

<pre style="overflow:auto">
{{Imagen múltiple
   <!-- PARÁMETROS DE LA TABLA -->
 | posición_tabla   = <!-- right (predefinido), left, center, none --> 
 | dirección        = <!-- horizontal (predefinido), vertical -->
 | color de fondo      = <!-- fondo de la caja -->

   <!-- TÍTULO -->
 | título           =  
 | posición_título  = <!-- center (predefinido), left, right -->    
 | fondo_de_título  = 

   <!-- PIE DE PÁGINA -->
 | texto            = 
 | posición         = <!-- left (predefinido), right, center -->           
 | fondo_de_texto   = 

   <!-- IMÁGENES -->
 | ancho            = <!-- PARÁMETRO OPCIONAL: ancho de la imagen en píxeles (un entero, omita el sufijo "px"); anula "ancho[n]" de abajo -->
 | foto1  =  | ancho1 =  | texto1 =  | alineación_texto1 = 
 | foto2  =  | ancho2 =  | texto2 =  | alineación_texto2 = 
 | foto3  =  | ancho3 =  | texto3 =  | alineación_texto3 = 
 | foto4  =  | ancho4 =  | texto4 =  | alineación_texto4 = 
 | foto5  =  | ancho5 =  | texto5 =  | alineación_texto5 =
  <!-- y así sucesivamente, hasta un máximo de 10 imágenes (foto10) -->
}}
</pre>

* '''posición_tabla''' : Situación de la tabla en la página. Puede tomar los valores left/right/center para alinear la tabla a la izquierda/derecha/centro. Por defecto, centrada.
* '''dirección''' : Orientación de las imágenes; puede ser horizontal o vertical. Por defecto, horizontal. 
* '''ancho_total''' :  anchura de la tabla. Tiene prioridad sobre ancho1, ancho2, ancho3, ancho4 y ancho5; si se quiere que cada imagen tenga su propio tamaño, déjese este valor en blanco.
* '''color de fondo''' : Permite definir [[Anexo:Colores|el color de fondo]] del cuadro en el que aparecen las imágenes.

* '''título''' : Cabecera de la tabla. (opcional)
* '''posición_título''' : posición del título en la cabecera de la tabla. Puede ser left/right/center. Por defecto, center.
* '''fondo_de_título''' : color del fondo.

* '''foto[n]''' : Imagen
* '''ancho[n]''' : anchura de cada imagen. No es necesario si se especificó el parámetro '''ancho''' y se desea que todas las imágenes tengan la misma anchura 
* '''texto[n]''' : texto que aparece bajo cada una de las imágenes. (opcional)
* '''alineación_texto[n]''' : alineación del texto bajo cada imagen. Puede tomar los valores left/right/center; por defecto, "left".

* '''texto''' : pie de imagen, alineado a la izquierda según convención de manual de estilo.
* '''posición''' : Posición del texto, puede ser "arriba" o "abajo" de las imágenes. Por defecto, abajo.
* '''fondo_de_texto''' : color del fondo del pie.

* '''link''' : para especificar la página a la que la foto[n] está vinculada (es decir, la página a la que se accede cuando se hace clic en la imagen). Si se establece como vacía (por ejemplo: <code>|alt1 = … |link1 = … |texto1 = …</code>), el enlace está desactivado (incluso a la página estándar de descripción de la imagen de Wikipedia).
* '''alt''' : una descripción alt para la foto[n].
* '''perrow''' : permite crear un cuadro de múltiples filas de imágenes, similar a {{ep|montaje fotográfico}}.

== Ejemplos ==
{{Imagen múltiple
 | posición_tabla = right
 | dirección      = vertical
 | ancho          = 250
 | título   =  La maja
 | texto    = De Goya (1 y 2) y Jules Joseph Lefebvre (3) | fondo_de_texto = #f5f
 | foto1    =  Goya Maja ubrana2.jpg
 | texto1   =  [[La maja vestida|vestida]]… | alineación_texto1 = left
 | foto2    =  Goya Maja naga2.jpg
 | texto2   =  [[La maja desnuda|… desnuda…]] | alineación_texto2 = center
 | foto3    =  Odalisque.jpg
 | texto3   = [[Jules Joseph Lefebvre|…  y de espaldas]]. | alineación_texto3 = right
}}
Este código
<pre style="overflow:auto">
{{Imagen múltiple
|posición_tabla = right
|dirección = vertical
|ancho  = 250
|título = La maja
|texto  = De Goya |fondo_de_texto = #f5f
|foto1  = Goya Maja ubrana2.jpg
|texto1 = [[La maja vestida|vestida]]… |alineación_texto1 = left
|foto2  = Goya Maja naga2.jpg
|texto2 = [[La maja desnuda|… desnuda…]] |alineación_texto2 = center
|foto3  = Odalisque.jpg
|texto3 = [[Jules Joseph Lefebvre|…  y de espaldas]]. |alineación_texto3 = right
}}
</pre>
crea la tabla de la derecha.

Y este otro
<pre style="overflow:auto">
{{Imagen múltiple
|posición_tabla = left
|título = Tres copas de vino español. |posición_título = left |fondo_de_título = gainsboro
|foto1  = White Wine Glas.jpg
|ancho1 = 100
|texto1 = [[Ribeiro]] |alineación_texto1 = center
|foto2  = Copita-of-amontillado.jpg
|ancho2 = 114
|texto2 = [[Montilla-Moriles|Amontillado]] |alineación_texto2 = center
|foto3  = Red Wine Glas.jpg
|ancho3 = 107
|texto3 = [[Vino Rioja|Rioja]] |alineación_texto3 = center
}}
</pre>
dibuja la tabla de abajo.

{{Imagen múltiple
 | posición_tabla = left
 | título         = Tres copas de vino español.| posición_título = left | fondo_de_título = gainsboro
 | foto1    = White Wine Glas.jpg
 | ancho1   = 100
 | texto1   = [[Ribeiro]] | alineación_texto1 = center
 | foto2    = Copita-of-amontillado.jpg
 | ancho2   = 114
 | texto2   = [[Montilla-Moriles|Amontillado]] | alineación_texto2 = center
 | foto3    = Red Wine Glas.jpg
 | ancho3   = 107
 | texto3   = [[Rioja (vino)|Rioja]] | alineación_texto3 = center
}}
{{clear}}
;con ''color de fondo''
{{Imagen múltiple
 | color de fondo = #FFFACD
 | ancho = 160
 | foto1 = Catedral de Santa María (León).JPG
 | alt1 = Rosetón principal.
 | foto2 = Caterdral de León.JPG
 | alt2 = La arquitectura del templo es de estilo gótico.
 | foto3 = Cathedral of León - Tympanum of the St. John's Door (west facade).JPG
 | alt3 = Detalle de la Puerta de San Juan.
 | fondo_de_texto = #FFFFF0
 | posición = center
 | texto = Fachada exterior de la [[Catedral de León (España)|catedral de León]].
}}
<pre style="overflow:auto">
{{Imagen múltiple
 | color de fondo = #FFFACD
 | ancho = 160
 | foto1 = Catedral de Santa María (León).JPG
 | alt1 = Rosetón principal.
 | foto2 = Caterdral de León.JPG
 | alt2 = La arquitectura del templo es de estilo gótico.
 | foto3 = Cathedral of León - Tympanum of the St. John's Door (west facade).JPG
 | alt3 = Detalle de la Puerta de San Juan.
 | fondo_de_texto = #FFFFF0
 | posición = center
 | texto = Fachada exterior de la [[Catedral de León (España)|catedral de León]].
}}
</pre>

{{clear}}
;con enlaces (''link'')
{{Imagen múltiple
 | posición_tabla = left

 | foto1 = Frecklesmule.jpg
 | ancho1 = 143
 | alt1 = Un asno
 | link1 = Asno
 | texto1 = Un asno<br />(骡子 ''luózi'')
 | alineación_texto1 = center

 | foto2 = Donkey 1 arp 750px.jpg
 | ancho2 = 150
 | alt2 = Un burro
 | link2 = 
 | texto2  = Un burro<br />(驴子 ''lǘzi'')
 | alineación_texto2 = center

 | foto3 = Rainbow_trout.png
 | ancho3 = 91
 | alt3 = Un pez
 | texto3  = Un pez<br />({{lang|zh|2=鱼}} ''yú'')
 | alineación_texto3 = center

 | texto = La imagen del asno enlaza a «[[mula]]»; la foto del burro no está vinculada; el dibujo del pez redirige a [[Ayuda:Página de descripción de las imágenes|la página de descripción]].
}}
<pre style="overflow:auto">
{{Imagen múltiple
 | posición_tabla = left

 | foto1 = Frecklesmule.jpg
 | ancho1 = 143
 | alt1 = Un asno
 | link1 = Asno
 | texto1 = Un asno<br />(骡子 ''luózi'')
 | alineación_texto1 = center

 | foto2 = Donkey 1 arp 750px.jpg
 | ancho2 = 150
 | alt2 = Un burro
 | link2 = 
 | texto2  = A donkey<br />(驴子 ''lǘzi'')
 | alineación_texto2 = center

 | foto3 = Rainbow_trout.png
 | ancho3 = 91
 | alt3 = Un pez
 | texto3  = Un pez<br />({{lang|zh|2=鱼}} ''yú'')
 | alineación_texto3 = center

 | texto = La imagen del asno enlaza a «[[mula]]»; la foto del burro no está vinculada; el dibujo del pez redirige a [[Ayuda:Página de descripción de las imágenes|la página de descripción]].
}}
</pre>
;para ajustar las alturas de las fotos
:''Nota'': Lo siguiente es innecesario si todas las imágenes presentes en la plantilla tienen la misma [[relación de aspecto]]; si es así, simplemente coloque el parámetro <code>ancho</code> y aplicará a todas las fotos.
#Decidir sobre un ancho total para todas las imágenes, por ejemplo 350px.
#Examinar cada página de descripción de la imagen en Commons para obtener la resolución completa:
#:[[:Archivo:Brhlík lesní.JPG]] tiene la descripción «Brhlík lesní.JPG (3983 × 2655 píxeles; tamaño de archivo: 6,83 MB; tipo MIME: image/jpeg)»
#:[[:Archivo:Sitta-carolinensis-001.jpg]] se describe como «Sitta-carolinensis-001.jpg ‎(1024 × 1024 píxeles; tamaño de archivo: 256 KB; tipo MIME: image/jpeg)»
#Indicar el ancho y la altura de cada imagen, de la siguiente forma:
#:<code>|ancho1=</code> <code>|ancho2=</code> <code>|alto1=</code> <code>|alto2=</code>
#Colocar el ancho total usando el parámetro <code>|ancho_total=</code>
{{Imagen múltiple
 | posición_tabla = right
 | ancho_total = 320
 | foto1 = Brhlík lesní.JPG
 | ancho1 = 3983 | alto1 = 2655
 | alt1 = Un trepador azul 
 | texto1 = Imagen rectangular de un [[Sitta europaea|trepador azul]], con una altura original de 2655 píxeles.

 | foto2 = Sitta-carolinensis-001.jpg
 | ancho2 =1024 | alto2 = 1024
 | alt2 = Un trepador pechiblanco
 | texto2 = Imagen cuadrada de un [[Sitta carolinensis|trepador pechiblanco]], con una altura original de 1024 píxeles.

 | texto = Ambas imágenes han sido ajustadas a la misma altura, y un ancho total de 320px.
}}
<pre style="overflow:auto">
{{Imagen múltiple
 | posición_tabla = right
 | ancho_total = 350
 | foto1 = Brhlík lesní.JPG
 | ancho1 = 3983 | alto1 = 2655
 | alt1 = Un trepador azul 
 | texto1 = Imagen rectangular de un [[Sitta europaea|trepador azul]], con una altura original de 2655 píxeles.

 | foto2 = Sitta-carolinensis-001.jpg
 | ancho2 =1024 | alto2 = 1024
 | alt2 = Un trepador pechiblanco
 | texto2 = Imagen cuadrada de un [[Sitta carolinensis|trepador pechiblanco]], con una altura original de 1024 píxeles.

 | texto = Ambas imágenes han sido ajustadas a la misma altura, y a un ancho total de 350px.
}}
</pre>
{{--}}
;estilo mosaico
Para crear un mosaico de imágenes, use <code>|perrow=</code>. En dicho parámetro se puede colocar un dígito o una lista de números delimitados por <code>/</code>. Esta función también se puede combinar con <code>|ancho_total=</code> para múltiples filas de imágenes con la misma anchura total.
{{imagen múltiple|perrow = 2|ancho_total=350
| foto1 = Las Meninas, by Diego Velázquez, from Prado in Google Earth.jpg  |ancho1=26065|alto1=30000
| foto2 = Cristo crucificado.jpg|ancho2=2046|alto2=3051
| foto3 = Velazquez-las hilanderas.jpg  |ancho3=2911|alto3=2008
| foto4 = Velázquez - Sor Jerónima de la Fuente (Museo del Prado, 1620).jpg |ancho4=2035|alto4=3051
| texto = '''Obras de [[Diego Velázquez|Velázquez]].''' En sentido horario desde arriba a la izquierda: ''[[Las meninas]]'', ''[[Cristo crucificado (Velázquez)|Cristo crucificado]]'', ''[[La venerable madre Jerónima de la Fuente]]'', y ''[[La fábula de Aracne|Las hilanderas]]''.
}}
<pre style="overflow:auto">
{{imagen múltiple|perrow = 2|ancho_total=350
| foto1 = Las Meninas, by Diego Velázquez, from Prado in Google Earth.jpg  |ancho1=26065|alto1=30000
| foto2 = Cristo crucificado.jpg|ancho2=2046|alto2=3051
| foto3 = Velazquez-las hilanderas.jpg  |ancho3=2911|alto3=2008
| foto4 = Velázquez - Sor Jerónima de la Fuente (Museo del Prado, 1620).jpg |ancho4=2035|alto4=3051
| texto = '''Obras de [[Diego Velázquez|Velázquez]].''' En sentido horario desde arriba a la izquierda: ''[[Las meninas]]'', ''[[Cristo crucificado (Velázquez)|Cristo crucificado]]'', ''[[La venerable madre Jerónima de la Fuente]]'', y ''[[La fábula de Aracne|Las hilanderas]]''.
}}
</pre>
=== Parámetros ===
{{TemplateData header}}
<templatedata>
{
	"description": "Esta plantilla crea un cuadro con dos a diez imágenes dispuestas vertical u horizontalmente con leyendas para todo el cuadro y cada imagen.",
	"format": "{{_\n| _________________ = _\n}}\n",
	"params": {
		"posición_tabla": {
			"type": "string",
			"label": "Posición de tabla",
			"default": "right",
			"description": "Situación de la tabla en la página. Puede tomar los valores left/right/center para alinear la tabla a la izquierda/derecha/centro. Por defecto, centrada.",
			"example": "left/right/center/none",
			"suggested": true,
			"suggestedvalues": [
				"left",
				"center",
				"right",
				"none"
			]
		},
		"dirección": {
			"default": "horizontal",
			"type": "string",
			"label": "Dirección ",
			"description": "Orientación de las imágenes; puede ser horizontal o vertical. Por defecto, horizontal.",
			"example": "horizontal/vertical",
			"suggested": true,
			"suggestedvalues": [
				"horizontal",
				"vertical"
			]
		},
		"ancho_total": {
			"type": "number",
			"label": "Ancho total",
			"description": "anchura de la tabla. Tiene prioridad sobre ancho1, ancho2, ancho3, ancho4 y ancho5; si se quiere que cada imagen tenga su propio tamaño, déjese este valor en blanco.",
			"example": "400",
			"suggested": true
		},
		"perrow": {
			"type": "string",
			"label": "Cantidad de filas",
			"description": "permite crear un cuadro de múltiples filas de imágenes, similar a {{ep|montaje fotográfico}}.",
			"example": "1 / 2 / 1"
		},
		"borde": {
			"example": "infobox",
			"label": "Alineación dentro de ficha"
		},
		"texto": {
			"type": "content",
			"description": "subtítulo debajo de la tabla",
			"label": "Pie de imagen"
		},
		"foto_espaciada": {
			"default": "5",
			"example": "20",
			"label": "Espacio entre imágenes"
		},
		"posición": {
			"default": "left",
			"type": "string",
			"label": "Alineación de pie de imagen",
			"example": "left/right/center",
			"description": "posición del subtítulo debajo de la tabla",
			"suggestedvalues": [
				"left",
				"center",
				"right"
			]
		},
		"alineación_texto": {
			"default": "left",
			"type": "string",
			"label": "Alineación del texto",
			"example": "left/right/center",
			"suggested": true,
			"suggestedvalues": [
				"left",
				"center",
				"right"
			]
		},
		"color de fondo": {
			"type": "string",
			"label": "Color de fondo",
			"description": "Permite definir [[Anexo:Colores|el color de fondo]] del cuadro en el que aparecen las imágenes.",
			"example": "#EEFFGG o red"
		},
		"título": {
			"label": "Título",
			"description": "Cabecera de la tabla. (opcional)"
		},
		"foto1": {
			"description": "foto1 es el nombre de la primera imagen. De manera similar para la Imagen 2, etc. Solo el nombre del archivo; sin prefijo Archivo: o Imagen:.",
			"type": "wiki-file-name",
			"example": "example.jpg",
			"suggested": true,
			"required": true,
			"label": "Imagen 1"
		},
		"ancho1": {
			"description": "ancho 1 es el ancho de la primera imagen. Del mismo modo para Ancho 2, etc.",
			"type": "number",
			"label": "Ancho 1"
		},
		"texto1": {
			"type": "content",
			"description": "texto1 es el título de la primera imagen. De manera similar para el texto2, etc.",
			"suggested": true,
			"label": "Texto 1"
		},
		"foto2": {
			"example": "example.jpg",
			"suggested": true,
			"label": "Imagen 2",
			"type": "wiki-file-name"
		},
		"ancho2": {
			"type": "number",
			"label": "Ancho 2"
		},
		"texto2": {
			"type": "content",
			"suggested": true,
			"label": "Texto 2"
		},
		"foto3": {
			"example": "example.jpg",
			"suggested": true,
			"label": "Imagen 3",
			"type": "wiki-file-name"
		},
		"ancho3": {
			"type": "number",
			"label": "Ancho 3"
		},
		"texto3": {
			"type": "content",
			"suggested": true,
			"label": "Texto 3"
		},
		"foto4": {
			"example": "example.jpg",
			"suggested": true,
			"label": "Imagen 4",
			"type": "wiki-file-name"
		},
		"ancho4": {
			"type": "number",
			"label": "Ancho 4"
		},
		"texto4": {
			"type": "content",
			"suggested": true,
			"label": "Texto 4"
		},
		"foto5": {
			"example": "example.jpg",
			"suggested": true,
			"label": "Imagen 5",
			"type": "wiki-file-name"
		},
		"ancho5": {
			"type": "number",
			"label": "Ancho 5"
		},
		"texto5": {
			"type": "content",
			"suggested": true,
			"label": "Texto 5"
		},
		"foto6": {
			"example": "example.jpg",
			"label": "Imagen 6",
			"type": "wiki-file-name"
		},
		"ancho6": {
			"type": "number",
			"label": "Ancho 6"
		},
		"texto6": {
			"type": "content",
			"label": "Texto 6"
		},
		"foto7": {
			"example": "example.jpg",
			"label": "Imagen 7",
			"type": "wiki-file-name"
		},
		"ancho7": {
			"type": "number",
			"label": "Ancho 7"
		},
		"texto7": {
			"type": "content",
			"label": "Texto 7"
		},
		"foto8": {
			"example": "example.jpg",
			"label": "Imagen 8",
			"type": "wiki-file-name"
		},
		"ancho8": {
			"type": "number",
			"label": "Ancho 8"
		},
		"texto8": {
			"type": "content",
			"label": "Texto 8"
		},
		"foto9": {
			"example": "example.jpg",
			"label": "Imagen 9",
			"type": "wiki-file-name"
		},
		"ancho9": {
			"type": "number",
			"label": "Ancho 9"
		},
		"texto9": {
			"type": "content",
			"label": "Texto 9"
		},
		"foto10": {
			"example": "example.jpg",
			"label": "Imagen 10",
			"type": "wiki-file-name"
		},
		"ancho10": {
			"type": "number",
			"label": "Ancho 10"
		},
		"texto10": {
			"type": "content",
			"label": "Texto 10"
		}
	}

}</templatedata>

== Véase también ==
* {{ep|Galería de imágenes}}
* [[Ayuda:Imágenes]]

<includeonly>
[[Categoría:Wikipedia:Plantillas de imágenes]]
</includeonly>