Icono de documentación de plantilla Documentación de la plantilla[ver] [editar] [historial] [purgar]
Esta es una metaplantilla. Se ha diseñado para servir de base a otras plantillas, no para utilizarse directamente en los artículos.
Esta plantilla utiliza el módulo Ficha. Antes de modificarla, deberías familiarizarte con las funciones de la extensión Scribunto y el lenguaje de programación Lua.

Esta plantilla tiene como objetivo ser una metaplantilla, es decir, una plantilla usada para ser la base de otras plantillas, no para ser usada directamente en el artículo. Véase aquí para más información acerca de las fichas en general.

Uso

Todos los parámetros son opcionales.

Cada fila de la tabla puede ser o una sección, o estar compuesta por un conjunto etiqueta/campo de datos, o por solo un campo de datos. Estos son estados mutuamente exclusivos, por lo tanto si se define una fila para ser tanto una sección como un conjunto etiqueta/campo de datos, este último no será tenido en cuenta.

Nótese que si se quiere insertar una imagen en cualquier lugar que no sea la parte superior de la ficha, o si se quieren insertar otros datos alternativos, usar una fila con un solo campo de datos sería una solución viable.

Parámetros

Notas:

Título y subtítulo

Título de la ficha
Título original de la ficha
Subtítulo de la ficha
(el resto de la ficha)

Se recomienda siempre establecer título a la ficha. También se pueden establecer un segundo título para el título original y diversos subtítulos a la ficha.

Contenido adicional

Todas las imágenes son centradas de manera predeterminada. Estos parámetros admiten el nombre de la imagen sin el complemento de enlace (imagen.jpg) o el enlace completo a la imagen ([[Archivo:imagen.jpg|245px]]). También se admite otros valores como plantillas.

Estilos CSS

Estos parámetros son usados para agregar código CSS en el atributo «style» de los elementos de la plantilla; son los que permiten cambiar la apariencia de estos elementos. Por lo tanto, deberán ser usados con sutileza para mantener un aspecto general estético y atractivo.

Clases CSS

Esta plantilla soporta la adición de información de microformatos. Esto se hace añadiendo el atributo «class» a una determinada celda de datos, indicando que clase de información contiene. Por ejemplo, para marcar una ficha como una vCard, se agrega el siguiente parámetro:

|clase = vcard

Y para cada campo de datos, el parámetro correspondiente:

|clase1 = fn
|clase2 = org
|clase3 = tel

...y así para todos los parámetros «clase» de la plantilla.

Véase microformats.org para más información sobre microformatos en general.

Cabeceras

Véase también Especial:Preferencias y actívese el accesorio «Muestra imágenes en las cabeceras de las fichas versión 2».

Al ser una metaplantilla basada en el diseño de Ficha v2, esta usa cabeceras específicas de acuerdo a la temática de la plantilla. Para usar las cabeceras se pueden usar dos parámetros:

Cabeceras "manuales"

También existe la posibilidad de diseñar cabeceras personalizadas para fichas temáticas sin necesidad de utilizar el parámetro clasetitulo=, modificando ligeramente el código de la plantilla del tipo de ficha que se desee adaptar. Puede utilizarse como icono cualquiera de los tipos de imágenes manejados en wikipedia, aunque para mantener la homegeneidad con las demás fichas, lo deseable es utilizar iconos semitransparentes, localizados en

Ejemplo:

Código: (cabecera de la ficha)

 ((Ficha
 |colorfondotitulo = #44cc88
 |tipocabecera = 
 |estiloetiqueta = background-color:#eee
 |estiloseccion  = background-color:#eee
 |titulo =
 <div class="floatright">
 <div class="thumb"> <div style="height:5px;"><div style="position: absolute; right:0px;">
 [[Image:Picto infobox aircraft.png|x45px|right]]
 </div></div></div>
 <div style="position:relative;right:10px;width:250px;">(({nombre|((PAGENAME))))}</div>
 </div>
 |datos1 = ((#if:(({imagen|))}|(({imagen))}((#if:(({pie|))}|<br /><span style="font-size:smaller">(({pie))}</span>))<hr />))
 
 (...resto de la plantilla)
))

Resultado:

Ficha

Basta con configurar el parámetro colorfondotitulo y elegir la imagen deseada (en el ejemplo, Picto infobox aircraft.png) para personalizar la ficha que se se desee (por ejemplo, Plantilla:Ficha de automóvil).

Notas:

Campos opcionales

Una fila con una etiqueta pero sin un campo de datos no se muestra. Esto facilita la creación de filas opcionales. Para hacer una fila opcional se tiene que incluir un parámetro que predetermine el contenido de esta a una cadena vacía:

|etiqueta5 = Población
|datos5 = (({población|))}

De esta forma si en el artículo no se define el parámetro de población, la fila no se muestra.

Para campos más complejos con contenidos con un formato predefinido que seguirían estando presentes incluso si el parámetro no se estableciera, se puede incluir el contenido en una instrucción #if (en español: «si») para hacer que desaparezca todo cuando el parámetro no se use. Por ejemplo, la instrucción #if en el siguiente ejemplo se lee como:

«si:el parámetro masa ha sido proporcionado|entonces mostrarlo, seguido de kg».
|etiqueta6 = Masa
|datos6 = ((#if:(({masa|))}|(({masa))} [[kg]]))

Para más información sobre el uso de #if, véase este artículo.

También es posible hacer secciones opcionales de manera similar. Si se quiere que una sección aparezca solo si uno o más campos de datos que la acompañan son proporcionados, se podría usar el siguiente modelo como un ejemplo de como hacerlo:

((Ficha
|título    = Ejemplo de una sección opcional
|seccion1  = ((#if:(({elemento1))}(({elemento2))}(({elemento3))}|Sección opcional))
|etiqueta2 = Elemento1
|datos2    = (({elemento1))}
|etiqueta3 = Elemento2
|datos3    = (({elemento2))}
|etiqueta4 = Elemento3
|datos4    = (({elemento3))}
))

seccion1 se mostrará si se definen cualquiera de los parámetros elemento1, elemento2 o elemento3. Si no se define ninguno de éstos parámetros entonces no se mostrará la sección.

La instrucción #if devolverá false (falso) únicamente cuando no haya nada en la condición (lo que sigue después de los dos puntos y finaliza con la primera barra vertical que no pertenezca a un parámetro), por lo tanto la instrucción fallará solo si no se define ningún parámetro.

Parámetros de opciones de comportamiento de la ficha

Título padre
etiqueta1 padre datos1 padre
etiqueta2 padre datos2 padre
título hija
etiqueta hija datos1 hija
((Ficha
|titulo = Título padre
|etiqueta1 = etiqueta1 padre
|datos1 = datos1 padre
|etiqueta2 = etiqueta2 padre
|datos2 = datos2 padre
|datos3 = ((Ficha
           |titulo = título hija
           |integrada = sí
           |etiqueta1 = etiqueta hija
           |datos1 = datos1 hija
          ))  
))

Ejemplos de uso

Caso general
Título de prueba
título original
Subtítulo de prueba
Subtítulo de prueba 2

pie superior


Pie izquierdo

Pie derecho

dato encima imagen
dato encima imagen 2

Pie

Pie2
Sección
Datos
Todos definidos (sección)
Etiqueta y datos (etiqueta) Etiqueta y datos (datos)

Pie inferior
Pie de tabla
((Ficha
|estilo          = width:275px 
|nombre          = Ficha
|titulo          = Título de prueba
|tipocabecera    = humano
|titulo2         = título original
|subtitulo       = Subtítulo de prueba
|subtitulo2      = Subtítulo de prueba 2
|imagensuperior  = example.png
|tamañoimagensuperior = 200px
|piesuperior = pie superior
|imagenizquierda = example.png
|tamañoimagenizquierda = 75px
|pieizquierdo    = Pie izquierdo
|imagenderecha   = example.png
|tamañoimagenderecha = 75px
|piederecho      = Pie derecho
|datosup1        = dato encima imagen
|datosup2        = dato encima imagen 2
|imagen          = example.png
|tamañoimagen    = 150px
|pie             = Pie
|imagen2         = example.png
|tamañoimagen2   = 90px
|pie2            = Pie2

|estiloseccion = background:#ccf;
|estiloetiqueta = background:#ddf;

|seccion1  = Sección
|etiqueta1 = 
|datos1    = 
|seccion2  = 
|etiqueta2 = Etiqueta
|datos2    = 
|seccion3  = 
|etiqueta3 = 
|datos3    = Datos
|seccion4  = Todos definidos (sección)
|etiqueta4 = Todos definidos (etiqueta)
|datos4    = Todos definidos (datos)
|seccion5  = 
|etiqueta5 = Etiqueta y datos (etiqueta)
|datos5    = Etiqueta y datos (datos)

|imageninferior = example.png
|tamañoimageninferior = 110px
|pieinferior   = Pie inferior

|piedetabla       = Pie de tabla
|estilopiedetabla = background:#ddf;
))
))


Cabecera con icono temático
Título de prueba
Etiqueta 1 Datos 1
Etiqueta 2 Datos 2
Etiqueta 3 Datos 3
Sección 4
Etiqueta 5 Datos 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit.
Pie de tabla

Para este otro ejemplo, se usará:


Con listas desplegables
EJEMPLO DESPLEGABLE
Con listas desplegables
  • Elemento H1
  • Elemento H2
  • Elemento H3
Lista Vertical
Ver lista
Elemento V1
Elemento V2
Elemento V3
Lista Vertical Viñetas
Ver lista
Viñetas 1
  • Elemento VV1
  • Elemento VV2
  • Elemento VV3
Viñetas 2
  • Elemento VV1'
  • Elemento VV2'
  • Elemento VV3'
((Ficha
| clase = geography vcard
| estilo = width:275px;
| titulo = EJEMPLO DESPLEGABLE
| subtitulo = Con listas desplegables
| estilotitulo = font-size: 115%; 

| imagen = [[File:Wikipedia - FLISoL 2016.pdf|center|200px]]

| seccion1 = ((Lista horizontal|
*Elemento H1
*Elemento H2
*Elemento H3
))

| estiloetiqueta=width:80px;
| etiqueta2  = Lista Vertical
| datos2 = ((lista desplegable
| Elemento V1
| Elemento V2
| Elemento V3
))

| etiqueta3  = Lista Vertical Viñetas
| datos3 = ((lista desplegable|
((lista de columnas|1|
;Viñetas 1
*Elemento VV1
*Elemento VV2
*Elemento VV3
;Viñetas 2
*Elemento VV1'
*Elemento VV2'
*Elemento VV3'
))
))
))

En este caso, mediante la orden clase = geography vcard se consigue que todas las casillas de la ficha queden separadas por líneas horizontales. Para incluir listas horizontales, se utiliza la plantilla ((Lista horizontal)); para incluir listas verticales sin viñetas se utiliza ((lista desplegable)); y por último, para añadir la listas verticales con viñetas se anidan las plantillas ((lista desplegable)) y ((lista de columnas)) (esta última con valor |1|).


Alineación correcta de las listas incluidas dentro de una casilla de datos

Para obtener una correcta alineación de las marcas circulares negras que estructuran el orden de una lista de datos especificada con asteriscos (*) o también con almohadillas (#) dentro de una casilla de datos, en necesario no olvidar añadir un punto y coma (;) como primer caracter de la entrada de datos correspondiente. El ejemplo siguiente muestra este problema y la forma de solucionarlo:

Código incorrecto (sin ; en |datos4=)
((Ficha
|titulo= Ciencia con [[neutrón|neutrones]]
|imagen= [[File:Quark_structure_neutron.svg|120px]]
|colorfondo= background-color: #cee0f2
|estilotitulo= background-color: #cee0f2
|estiloseccion=background-color: #cee0f2

|seccion1= Fundamentos
|estilodatos2= text-align: left
|datos2= 
* [[Temperatura neutrónica]]
* [[Flujo de neutrones|Flujo]], [[Radiación por neutrones|Radiación]], [[Transporte de neutrones|Transporte]]
* [[Sección transversal de neutrones|Sección transversal]], [[Captura neutrónica|Absorción]], [[Activación por neutrones|Activación]]

|seccion3= [[Dispersión de neutrones]]
|estilodatos4= text-align: left
|datos4=
* [[Difracción de neutrones]]
** [[Dispersión de neutrones en ángulo pequeño]]
** [[Dispersión de neutrones de ángulo pequeño con incidencia rasante|GISANS]]
** [[Reflectometría de neutrones|Reflectometría]]
* [[Dispersión inelástica de neutrones]]
** [[Dispersión de neutrones de triple eje|Espectrómetro de triple eje]]
** [[Dispersión de tiempo de vuelo de neutrones|Espectrómetro de tiempo de vuelo]]
** [[Retrodispersión de neutrones|Espectrómetro de retrodispersión]]
** [[Eco de espín de neutrones|Espectrómetro de eco de espín]]
))
Resultado
Ciencia con neutrones
Fundamentos
Dispersión de neutrones
  • Difracción de neutrones
  • Dispersión inelástica de neutrones
  • Añadiendo el mencionado ; al inicio de las sucesivas entradas |datos= que incluyan listas, se obtiene el resultado correcto:

    Código correcto (con |datos4=;)
    ((Ficha
    |titulo= Ciencia con [[neutrón|neutrones]]
    |imagen= [[File:Quark_structure_neutron.svg|120px]]
    |colorfondo= background-color: #cee0f2
    |estilotitulo= background-color: #cee0f2
    |estiloseccion=background-color: #cee0f2
    
    |seccion1= Fundamentos
    |estilodatos2= text-align: left
    |datos2= 
    * [[Temperatura neutrónica]]
    * [[Flujo de neutrones|Flujo]], [[Radiación por neutrones|Radiación]], [[Transporte de neutrones|Transporte]]
    * [[Sección transversal de neutrones|Sección transversal]], [[Captura neutrónica|Absorción]], [[Activación por neutrones|Activación]]
    
    |seccion3= [[Dispersión de neutrones]]
    |estilodatos4= text-align: left
    |datos4=;
    * [[Difracción de neutrones]]
    ** [[Dispersión de neutrones en ángulo pequeño]]
    ** [[Dispersión de neutrones de ángulo pequeño con incidencia rasante|GISANS]]
    ** [[Reflectometría de neutrones|Reflectometría]]
    * [[Dispersión inelástica de neutrones]]
    ** [[Dispersión de neutrones de triple eje|Espectrómetro de triple eje]]
    ** [[Dispersión de tiempo de vuelo de neutrones|Espectrómetro de tiempo de vuelo]]
    ** [[Retrodispersión de neutrones|Espectrómetro de retrodispersión]]
    ** [[Eco de espín de neutrones|Espectrómetro de eco de espín]]
    ))
    
    Resultado
    Ciencia con neutrones
    Fundamentos
    Dispersión de neutrones


    Sintaxis completa

    (Nota: la plantilla soporta un número ilimitado de filas, pero aquí solo se incluyen 20 ya que fichas más grandes son raras. de la misma forma soporta un número ilimitado de subtítulos, datossup e imágenes (imagen(n)) aunque solo se exponen 2. Para usar más de 20 solo extiende la numeración como se requiera. Los parámetros «clase» también son omitidos ya que no son usados comúnmente.)

    ((Ficha
    |integrada             =  <!-- (si para integrarla en otra ficha) -->
    |wikidata              = <!-- no para que no aparezca el enlace al elemento -->
    |nombre                = <!-- nombre de la ficha sin el espacio de nombres plantilla -->
    |estilo                = 
    |tipocabecera          = 
    |titulo                = 
    |estilotitulo          =
    |titulo2               =
    |estilotitulo2         = 
    |colorfondotitulo      = 
    
    |subtitulo             = 
    |subtitulo2            = 
    |estilosubtitulo       = 
    
    |estiloimagensuperior  = 
    |estilopiesuperior     = 
    
    |imagensuperior        = 
    |tamañoimagensuperior  = 
    |piesuperior           =
     
    |estiloimagen          = 
    |estilopie             = 
    
    |imagen                = 
    |tamañoimagen          = 
    |pie                   = 
    
    |imagen2               = 
    |tamañoimagen2         = 
    |pie2                  = 
    
    |imagenizquierda       = 
    |tamañoimagenizquierda = 
    |pieizquierdo          = 
    
    |imagenderecha         = 
    |tamañoimagenderecha   = 
    |piederecho            = 
    
    |estilodatosup         =
    |datosup               =
    |datosup2              =
    
    |estiloseccion         = 
    |estiloetiqueta        = 
    |estilodatos           = 
    
    |seccion1   = 
    |etiqueta1  = 
    |datos1     = 
    |seccion2   = 
    |etiqueta2  = 
    |datos2     = 
    |seccion3   = 
    |etiqueta3  = 
    |datos3     = 
    |seccion4   = 
    |etiqueta4  = 
    |datos4     = 
    |seccion5   = 
    |etiqueta5  = 
    |datos5     = 
    |seccion6   = 
    |etiqueta6  = 
    |datos6     = 
    |seccion7   = 
    |etiqueta7  = 
    |datos7     = 
    |seccion8   = 
    |etiqueta8  = 
    |datos8     = 
    |seccion9   = 
    |etiqueta9  = 
    |datos9     = 
    |seccion10  = 
    |etiqueta10 = 
    |datos10    = 
    |seccion11  = 
    |etiqueta11 = 
    |datos11    = 
    |seccion12  = 
    |etiqueta12 = 
    |datos12    = 
    |seccion13  = 
    |etiqueta13 = 
    |datos13    = 
    |seccion14  = 
    |etiqueta14 = 
    |datos14    = 
    |seccion15  = 
    |etiqueta15 = 
    |datos15    = 
    |seccion16  = 
    |etiqueta16 = 
    |datos16    = 
    |seccion17  = 
    |etiqueta17 = 
    |datos17    = 
    |seccion18  = 
    |etiqueta18 = 
    |datos18    = 
    |seccion19  = 
    |etiqueta19 = 
    |datos19    = 
    |seccion20  = 
    |etiqueta20 = 
    |datos20    = 
    
    |imageninferior       = 
    |tamañoimageninferior = 
    |pieinferior          = 
    
    |estilopiedetabla     = 
    |piedetabla           =
    |wikidata             = si o no 
    ))

    Véase también


    La plantilla ficha es la matriz para el uso de fichas informativas en la parte inicial del artículo.

    Parámetros de la plantilla[Editar los datos de la plantilla]

    ParámetroDescripciónTipoEstado
    Títulotitulo

    Título de la ficha

    Predeterminado
    Nombre de título
    Cadenaobligatorio
    Título secundariotitulo2

    Título alternativo

    Cadenaopcional
    Tipo de ficha (cabecera)tipocabecera

    Estilo de cabera (humano, web...). El contexto es similar a los subtítulos.

    Desconocidoopcional
    Color de fondocolorfondotitulo colorfondo

    Color de fondo de la ficha

    Wikitexto desequilibradosugerido
    Subtítulosubtitulo

    Subtítulo de la ficha que describe si es un personaje, una ciudad, etcétera.

    Cadenasugerido
    Imagen principalimagen

    Imagen de la ficha.

    Desconocidosugerido
    Tamaño imagen principaltamañoimagen

    Tamaño en píxeles de la ficha.

    Desconocidosugerido
    Pie de imagen principalpie

    Pie de imagen.

    Desconocidosugerido
    Imagen superiorimagensuperior

    Imagen adorno en la parte superior.

    Desconocidoopcional
    Sección 1seccion1

    Sección (si fuera necesario)

    Cadenaopcional
    Etiqueta 1etiqueta1

    Información 1 (lado izquierdo)

    Cadenasugerido
    Datos 1datos1

    Característica de la información 1 (lado derecho)

    Cadenasugerido
    Sección 2seccion2

    Sección (si fuera necesario)

    Cadenaopcional
    Etiqueta 2etiqueta2

    Información 1 (lado izquierdo)

    Cadenaopcional
    Datos 2datos2

    Característica de la información 1 (lado derecho)

    Cadenaopcional
    Sección 3seccion3

    Sección (si fuera necesario)

    Cadenaopcional
    Etiqueta 3etiqueta3

    Información 1 (lado izquierdo)

    Cadenaopcional
    Datos 3datos3

    Característica de la información 1 (lado derecho)

    Cadenaopcional
    Sección 4seccion4

    Sección (si fuera necesario)

    Cadenaopcional
    Etiqueta 4etiqueta4

    Información 1 (lado izquierdo)

    Cadenaopcional
    Datos 4datos4

    Característica de la información 1 (lado derecho)

    Cadenaopcional
    Pie de tabla (ficha)piedetabla

    Pie de ficha

    Cadenaopcional
    Estilo para seccionesestiloseccion

    Estilo para las secciones en esta ficha

    Desconocidoopcional
    Estilo para etiquetasestiloetiqueta

    Estilo para las secciones en esta ficha

    Desconocidoopcional
    Editar wikidata si o nowikidata

    Habilitar o no edición de wikidata

    Desconocidoopcional
    Esta documentación está transcluida desde Plantilla:Ficha/doc.
    Los editores pueden experimentar en la zona de pruebas (crear) y en los casos de prueba (crear) de la plantilla.
    Por favor, añade las categorías en la subpágina de documentación. Subpáginas de esta plantilla.