Edición de «Plantilla:Navegación/doc»

{{Subpágina de documentación}}
{{plantilla con Lua|Navbox}}
=== Restricciones ===
En [[Wikipedia en español]], el uso de esta plantilla está muy regulado, para evitar redundancias de información en los artículos.

<span style="font-size: larger; font-weight: bolder;">Antes de crear una plantilla de navegación, por favor ten en cuenta los siguientes enlaces:</span>
* [[Wikipedia:Plantillas de navegación]].
* [[Ayuda:Plantillas#Sugerencias|Sugerencias de plantillas]].

=== Uso ===
Esta plantilla se utiliza para agrupar enlaces relacionados, a través de un orden distinto del [[Orden lexicográfico|alfabético]], proporcionado por las [[Ayuda:Categoría|categorías]].

<pre>
{{Navegación
 | nombre =
 | clase listas = hlist
 | estado  = {{{estado|}}}

 | título =
 | arriba =
 | imagen =

 | grupo1 = 
 | lista1 = 

 | grupo2 = 
 | lista2 = 

 ...

 | grupo20 = 
 | lista20 = 

 | abajo =
}}
</pre>

=== Parámetros ===

==== Generales ====
* '''nombre''': el nombre de la plantilla, necesario que funcionen correctamente los enlaces "V • D • E" ("Ver • Discusión • Editar") en las páginas en las que se use la plantilla. Se puede usar <code>nombre = <nowiki>{{subst:PAGENAME}}</nowiki></code>. Si no estamos creando una plantilla, se recomienda usar en su lugar el parámetro <code>navbar = plain</code>, que oculta estos enlaces.
* '''estado''': [autocollapse, collapsed, expanded, plain]
** ''<code>autocollapse</code>'': parámetro por defecto; muestra solo la cabecera de la plantilla en las páginas en las que ya existan dos plantillas desplegadas, según especifica [[MediaWiki:Common.js]] (téngase en cuenta que, a diferencia de Wikipedia en español, en otras wikipedias el uso de plantillas de navegación está muy extendido).
** ''<code>collapsed</code> / <code>expanded</code>'': muestran la plantilla enrollada o desplegada respectivamente.
** ''<code>plain</code>'': la plantilla se muestra desplegada, sin los enlaces "V • D • E" ni el botón de "mostrar/ocultar".
* '''clase listas''': se recomienda utilizar el parámetro <code>clase listas = hlist</code> para listas horizontales.

==== De contenidos ====
* '''título''': el título que se muestra en la cabecera. Puede contener enlaces, y si es necesaria más de una línea se debe usar la plantilla {{ep|--}} para asegurar el correcto centrado del texto. 
* '''arriba''': muestra un texto en una fila completa justo debajo de la cabecera.
* '''abajo''': lo mismo pero al pie de la plantilla.
* '''imagen''': imagen que se muestra a la derecha. Se debe emplear la sintaxis usual, por ejemplo: <code>imagen = <nowiki>[[Archivo:Nombre_del_archivo.ext|50px]]</nowiki></code>.
* '''grupo<sub>n</sub>''': especifica el título de la fila n-ésima, que se muestra en la columna de la izquierda. Se permiten hasta 20 filas. Si se omite una de ellas, el contenido de lista<sub>n</sub> correspondiente ocupa todo el espacio de la fila.
* '''lista<sub>n</sub>''': lista de enlaces para mostrar en la fila n-ésima. Se puede escribir la lista de enlaces como una [[Ayuda:Listas|lista usual]] (escribiendo en cada línea un enlace precedido de un asterisco, siempre y cuando englobemos la lista completa en un bloque <code>&lt;div>...&lt;/div></code>) o usando la plantilla {{ep|Lista horizontal}}.

==== De estilo ====

Se recomienda no variar la apariencia con que se muestran las diferentes partes de la plantilla, en beneficio de la consistencia entre las diferentes páginas de Wikipedia. No obstante, existe la opción de modificar el estilo, usando código [[CSS]], mediante los siguientes parámetros:
* <code>estilo título</code>
* <code>estilo arriba</code>
* <code>estilo abajo</code>
* <code>estilo grupo</code>
* <code>estilo grupo1</code>, ..., <code>estilo grupo20</code>
* <code>estilo lista1</code>, ..., <code>estilo lista20</code>

=== Ejemplo ===
{{ejemplo parámetros|Navegación
| estado = uncollapsed
| título
| arriba
| imagen
| grupo1
| lista1
| grupo2
| lista2
| lista3={{{lista3}}} ''sin <nowiki>{{{grupo3}}}</nowiki>''
| grupo4
| lista4
| abajo
}}

=== Véase también ===
* {{ep|Navegación/subgrupo}}
* {{ep|Navegación con columnas}}
* {{ep|Navegación vertical}}

<includeonly>
[[Categoría:Wikipedia:Plantillas de navegación| ]]
[[Categoría:Wikipedia:Plantillas de categorías|Navegacion]]
</includeonly>