Ver el código de «Plantilla:Listaref/doc»

{{Subpágina de documentación}}

=== Uso ===
<pre>{{listaref|2|ancho=600px|refs=|grupo=|estilolista=}}</pre>

Donde «2» corresponde al número de columnas y «xxx» es el ancho mínimo en [[píxel|píxeles]] de cada columna.

=== Parámetros ===
Todos los parámetros son opcionales.

* '''1''': número de columnas. El número de columnas solo se aplica si la anchura del navegador lo permite. Es decir, si <code>n=2</code> y <code>ancho=600px</code>, la plantilla generará dos columnas cuando la anchura de la ventana del navegador sea superior a 1200 píxeles, y solo una única columna cuando la anchura sea inferior. '''No se recomienda más de 2 columnas'''. Las listas con números superiores suelen ser más largas y entrecortar varias veces una misma referencia.
* '''ancho''': ancho de las columnas.
* '''refs''': dentro de las referencias se coloca:

<pre>
{{listaref|grupo="nombre del grupo"|refs=
<ref name="nombre1">contenido1</ref>
<ref name="nombre2">contenido2</ref>
}}</pre>

Así, estas referencias pueden ser invocadas en el artículo como:

<pre><ref group="nombre_del_grupo" name="nombre1" /><ref group="nombre_del_grupo" name="nombre2" /></pre>

* '''estilolista''': permite especificar el estilo de las viñetas de las referencias. Haz clic en [mostrar] en el cuadro que se muestra a continuación para ver una tabla con las viñetas disponibles y su compatibilidad con los distintos navegadores.

{{Lista desplegable
|título=Tipos de estilos de lista
|título_estilo=width: 60%; margin: 0.5em; background:#DDE; text-align: center;
|1={{Listaref/doc/estilolista}}}}

=== Referencias por grupo ===
El sistema de notas al pie permite la separación de las referencias en grupos. Los grupos permiten tener separadas las notas de las referencias, entre otros usos.

El formato general para una etiqueta de referencia de grupo es:

: <code><nowiki><ref group="nombre del grupo"></ref></nowiki></code>

y para la plantilla de lista de referencias:

: {{ep|listaref|2=grupo="nombre del grupo"}}

:Donde <nombre del grupo> es el identificador del grupo, como por ejemplo «nota», «n.» o cualquier otro nombre.

=== Ejemplo sencillo de referencias por grupo ===
El código siguiente muestra un ejemplo sencillo de cómo deben colocarse en el código de un texto las llamadas a la orden <code><nowiki><ref group=nota></nowiki></code> para que funcionen correctamente:
{|class="wikitable mw-collapsible" width=80%
!Código:
!Resultado:
|-
|width=50%|
<pre>
==Ejemplo sencillo de cómo colocar notas==
La primera nota la voy a introducir aquí.<ref group=nota>Esta es la primera nota, en efecto.</ref> Luego sigo escribiendo, y un poco más adelante, coloco la segunda llamada.<ref group=nota>Esta es la segunda nota, no falla.</ref>

Ahora, en vez de notas, voy a llamarlas aclaraciones.<ref group=aclar.>Esta es la primera aclaración, en efecto.</ref> Y por si no queda claro, se introduce otra aclaración más.<ref group=aclar.>Esta es la segunda aclaración, inexorablemente.</ref>

Por último, pongo una tercera nota.<ref group=nota>Esta es la tercera nota, la última.</ref>

Al final del artículo, debe ponerse la llamada a las anotaciones que se hayan hecho. 

== Notas ==
{{listaref|group=nota}}

== Aclaraciones ==
{{listaref|group=aclar.}}
</pre>
|width=50% style="font-size:99%;line-height:99%;" valign="top"|
<br />
<br />
<span style="line-height:-1%;font-family:Linux Libertine;font-size:160%;">Ejemplo sencillo de cómo colocar notas</span> [<small><span style="color:blue;"> editar código · editar </span></small>]
----
La primera nota la voy a introducir aquí.<sup><span style="color:blue;">nota 1</span></sup> Luego sigo escribiendo, y un poco más adelante, coloco la segunda llamada.<sup><span style="color:blue;">nota 2</span></sup>

Ahora, en vez de notas, voy a llamarlas aclaraciones.<sup><span style="color:blue;">aclar. 1</span></sup> Y por si no queda claro, se introduce otra aclaración más.<sup><span style="color:blue;">aclar. 2</span></sup>

Por último, pongo una tercera nota.<sup><span style="color:blue;">nota 3</span></sup>

Al final del artículo, debe ponerse la llamada a las anotaciones que se hayan hecho.
<br />
<br />
<br />
<br />
<br />
<br />
<span style="line-height:-1%;font-family:Linux Libertine;font-size:160%;">Notas</span> [<small><span style="color:blue;"> editar código · editar </span></small>]
----
:1. <span style="color:blue;">↑</span> Esta es la primera nota, en efecto.
:2. <span style="color:blue;">↑</span> Esta es la segunda nota, no falla.
:3. <span style="color:blue;">↑</span> Esta es la tercera nota, la última.
<br />
<span style="line-height:-1%;font-family:Linux Libertine;font-size:160%;">Aclaraciones</span> [<small><span style="color:blue;"> editar código · editar </span></small>]
----
:1. <span style="color:blue;">↑</span> Esta es la primera aclaración, en efecto.
:2. <span style="color:blue;">↑</span> Esta es la segunda aclaración, inexorablemente.
<br />
<br />
|-
|colspan=2|('''''NOTA:''' en una página normal, los enlaces de color azul funcionarían normalmente; en este caso, solo sirven como una imagen del resultado que se debe obtener)''
('''''NOTA:''' si la página contiene también referencias ''normales'', el comando {{ep|listaref}} debe '''COLOCARSE POR DELANTE''' de <nowiki>{{listaref|group=nota}}</nowiki> )''
|}

=== Detalles técnicos ===
==== Separación en columnas según el navegador en uso ====
{| class="wikitable" style="float:right; margin:0 0 1em 1em; text-align:center; font-size:90%;"
|+ Soporte de navegador web para esquemas de columnas múltiples CSS3
! Internet<br>Explorer !! Firefox !! Safari !! Chrome !! Opera !! Edge
|-
| {{no|6}} || {{sí|3}} || {{sí|3}} || {{sí|8}} || {{no|10}} || {{sí}}
|-
| {{no|7}} || {{sí|4}} || {{sí|4}} || {{sí|9}} || {{no|11}} ||
|-
| {{no|8}} || {{sí|5}} || {{sí|5}} || {{sí|10}} || {{sí|11.1}} ||
|-
| {{no|9}} || || || {{sí|11}} || {{sí|12}} ||
|-
| {{sí|10}} ||   || || {{sí|12}} || ||
|-
| {{sí|11}} || || || || ||
|}
Las columnas múltiples se generan usando [[Cascading Style Sheets|CSS3]], aún en fase de desarrollo; por ello solo los [[Navegador web|navegadores web]] que soportan esta función mostrarán columnas múltiples.<ref>{{cita web|fechaacceso=31 de marzo de 2009|título=CSS3 Multi-Column Thriller|url=http://www.stuffandnonsense.co.uk/archives/css3_multi-column_thriller.html}}</ref><ref>{{cita web|url=http://www.w3.org/TR/css3-multicol/|título=CSS3 module: Multi-column layout|editorial=[[World Wide Web Consortium|W3C]]|fechaacceso=31 de marzo de 2009}}</ref>

Los siguientes navegadores '''soportan''' columnas CSS3:

* Navegadores basados en [[Gecko (motor de renderizado)|Gecko]], como [[Mozilla Firefox]]
* Navegadores basados en [[WebKit]], como [[Safari (navegador)|Safari]] y [[Google Chrome]]
* [[Opera (navegador)|Opera]] a partir de la versión 11.10
* [[Internet Explorer 10]] y [[Internet Explorer 10|11]]
* [[Microsoft Edge]]

Los siguientes navegadores '''no soportan''' columnas CSS3:

* Navegadores basados en [[Trident]], incluyendo Internet Explorer hasta la versión 9 (año 2011)<ref>{{Cita web |url=http://msdn.microsoft.com/en-us/library/cc351024(VS.85).aspx#multicolumn |title=CSS Compatibility and Internet Explorer: Multi-column Layout |work=Microsoft Developer Network |publisher=Microsoft |accessdate=16 de marzo de 2011}}</ref>
* [[Opera (navegador)|Opera]] hasta la versión 11

=== Véase también ===
* [[Wikipedia:Referencias]]

===Referencias===
{{listaref}}
<includeonly>
[[Categoría:Plantillas]]
[[Categoría:Plantillas de listas]]
[[Categoría:Plantillas al pie]]

<templatedata>
{
	"params": {
		"1": {
			"description": "Número de columnas. El número de columnas solo se aplica si la anchura del navegador lo permite. No se recomienda más de 2 columnas.",
			"example": "2",
			"type": "number",
			"default": "2"
		},
		"ancho": {
			"aliases": [
				"colwidth"
			],
			"description": "Ancho de las columnas.",
			"example": "600px",
			"type": "number"
		},
		"estilolista": {
			"aliases": [
				"liststyle"
			],
			"description": "Permite especificar el estilo de las viñetas de las referencias. Ver la documentación para todas las posibilidades.",
			"example": "none, disc, circle, square, decimal, lower-roman...",
			"type": "string"
		},
		"grupo": {
			"aliases": [
				"group"
			],
			"description": "Permite la separación de las referencias en grupos. Hay que incluir las comillas.",
			"example": "\"nota\"",
			"type": "string"
		},
		"refs": {
			"description": "Dentro de las referencias se coloca: <ref name=\"nombre1\">contenido1</ref>; <ref name=\"nombre2\">contenido2</ref>...",
			"type": "unbalanced-wikitext"
		}
	},
	"paramOrder": [
		"1",
		"ancho",
		"refs",
		"grupo",
		"estilolista"
	],
	"format": "inline",
	"description": "Esta plantilla se utiliza para poder visualizar las referencias colocadas en el artículo."
}
</templatedata>
</includeonly><noinclude>[[Categoría:Plantillas de documentación]]</noinclude>