Plantilla:Ficha/doc: Difference between revisions

Latest revision as of 21:17, 14 June 2017

Template:Subpágina de documentación Template:Plantilla con 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:

Los parámetros que incluyan la letra «n» entre paréntesis [o sea (n)], indican que se debe escribir al final del parámetro un número del 1 al infinito. Por ejemplo, el código «|estilosección65 = font-style: italic;» establecería el estilo de fuente de la sección 65 en cursiva.
Si se define una sección, no se debe usar el mismo número de la sección en los campos de etiquetas o datos, si se hace, no se mostrará el contenido de estos campos.

Título y subtítulo

Template: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.

titulo: texto a mostrar como título.
titulo2: segundo título.
colorfondotitulo o colorfondo: establece el color de fondo del título.
subtitulo: subtítulo de la ficha.
subtitulo(n): para poner más subtítulos.

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|240px]]). También se admite otros valores como plantillas.

imagensuperior: imagen que aparecerá en la parte superior de la ficha encima de imagenderecha/imagenizquierda.
imagen, imagen(n): imágenes ubicadas justo encima de los datos principales de la ficha (es decir, secciones, etiquetas y campos de datos) y debajo de imagenderecha/imagenizquierda y datossup.
tamañoimagen, tamañoimagen(n): tamaño de las imágenes (predeterminado: 240px).
imagenizquierda, imagenderecha: imágenes pequeñas ubicadas inmediatamente debajo de los subtítulos, una a la izquierda y otra a la derecha, respectivamente. Si solo se da valor a una de ellas aparecerá centrada.
tamañoimagenizquierda, tamañoimagenderecha: tamaño de las imágenes pequeñas (predeterminado: 100px).
imageninferior: imagen ubicada en la parte inferior de la ficha.
tamañoimageninferior: tamaño de la imagen inferior (predeterminado: 240px).
pie, pie(n), piesuperior, pieizquierdo, piederecho, pieinferior: pies de imagen.
datosup(n): filas de datos que aparecerán encima de imagen y debajo de imagensuperior e imagenderecha/imagenizquierda.
seccion(n): contenido usado como sección.
etiqueta(n): contenido usado como etiqueta.
datos(n): contenido usado como campo de datos.
piedetabla: texto del pie de la tabla. Se usa para notas al pie, véase también, etc.

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.

estilo: se aplica a toda la tabla.
estilotitulo: se aplica al título.
estilotitulo2 se aplica al título complementario
estilosubtitulo: se aplica a los subtítulos.
estilosubtitulo(n): se aplica a cada subtítulo según el número (n) específicado. Tiene precedencia sobre «estilosubtitulo».
estiloimagensuperior: se aplica a la imagen superior.
estilopiesuperior: se aplica al pie de imagen superior.
estiloimagenderecha: se aplica a todas la imagen derecha.
estiloimagenizquierda: se aplica a todas la imagen izquierda.
estilopiederecho: se aplica al pie de imagen derecha.
estilopieizquierdo: se aplica al pie de imagen izquierda.
estilodatosup(n): se aplica al datosup especificado con el número.
estiloimagen: se aplica a todas las imágenes.
estiloimagen(n): se aplica a cada imágenes según el número (n) específicado.
estilopie: se aplica a todos los pies de imagen.
estiloseccion: se aplica a las secciones en general.
estilosección(n): se aplica a la sección especificada con el número. Tiene precedencia sobre «estiloseccion».
estiloetiqueta: se aplica a las etiquetas en general.
estiloetiqueta(n): se aplica a la etiqueta especificada con el número. Tiene precedencia sobre «estiloetiqueta».
estilodatos: se aplica a los campos de datos en general.
estilodatos(n): se aplica al campo de datos especificado con el número. Tiene precedencia sobre «estilodatos».
estiloimageninferior: se aplica a la imagen inferior.
estilopieinferior: se aplica al pie de imagen inferior.
estilopiedetabla: se aplica al pie de tabla.

Clases CSS

clase: este parámetro es insertado en el atributo «class» de la tabla, y afecta a toda la ficha.
clasetitulo: este parámetro es insertado en el atributo «class» del título.
clasetitulo2: este parámetro es insertado en el atributo «class» de titulo2.
clasesubtitulo(n): este parámetro es insertado en el atributo «class» del subtítulo que se especifique con el número.
claseimagensuperior: este parámetro es insertado en el atributo «class» de la imagen superior.
claseimagenderecha: este parámetro es insertado en el atributo «class» de la imagen derecha.
claseimagenizquierda: este parámetro es insertado en el atributo «class» de la imagen izquierda.
claseimageninferior: este parámetro es insertado en el atributo «class» de la imagen inferior.
claseimagen: este parámetro es insertado en el atributo «class» de las imágenes.
claseimagen(n): este parámetro es insertado en el atributo «class» de las imágenes que se especifique con el número.
clasedatosup(n): este parámetro es insertado en el atributo «class» de datosup que se especifique con el número.
clase(n): este parámetro es insertado únicamente en el atributo «class» del campo de datos que se especifique con el número. Si no hay datos no tiene efecto.
clasefila(n): este parámetro es insertado en el atributo «class» de tanto la etiqueta como el campo de datos que correspondan al número especificado (es decir, toda la fila). Si no se inserta una etiqueta, equivale a usar el parámetro «clase(n)» con el mismo número. Este parámetro no tiene efecto en secciones.
clasesubtitulo: este parámetro es insertado en el atributo «class» de los subtítulos.
clasepiedetabla: este parámetro es insertado en el atributo «class» del pie de tabla.

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

Template:VT

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:

tipocabecera: establece el tipo de cabecera. Este parámetro es un alias del parámetro «clasetitulo», y, si bien su objetivo es otro, tienen el mismo efecto en el resultado final de la ficha (salvo que se use el parámetro «media», que hace que «tipocabecera» sea ignorado). Sin embargo, para establecer clases que no sean del tipo «cabecera», se debe usar siempre «clasetitulo».
media: si este parámetro se establece en «sí» entonces se establece al título la clase «media» en vez de la clase «cabecera». Esto permite títulos más compactos.

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 Template:Commonscat.

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: Template: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:

El tamaño de los iconos es x45px. Para que la plantilla funcione correctamente, algunos iconos necesitan que se declare necesariamente su altura (con la citada notación x45px).


También es imprescindible NO ALTERAR la secuencia de los comandos <div>...</div>. Si se desordenan o agrupan, lo más probable es que el código deje de funcionar correctamente.

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

integrada: Si se da el valor sí se omitirá todo el envoltorio externo de la ficha generándose únicamente las filas y su contenido. Esto está pensado para integrar esa ficha en otra añadiéndola como valor en uno de sus parámetros por ejemplo:

Template:Ficha

{{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
          }}  
}}

wikidata: Si se da el valor no se omitirá el enlace al elemento correspondiente de Wikidata o de no existir éste no aparecerá el texto de ayuda para su creación. Esto está pensado por ejemplo para fichas cuyo objetivo son páginas fuera del espacio enciclopédico que de ninguna manera deben ser enlazadas a Wikidata.
nombre: Si se da valor a este parámetro aparecerá en la parte inferior unos enlaces a la página especificada dentro del espacio plantillas y su espacio adicional (discusión y código fuente para editar). Lo normal es que se dé el nombre de la ficha.

Ejemplos de uso

Template:Ficha

{{Ficha
|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;
}}
}}



Template:Ficha
Para este ejemplo se usará:

clasetitulo = comunicación
colorfondotitulo = #ff0000
estilo = width:20em; background-color:#e0ffff
estiloetiqueta = width:33%;

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           = 
}}

Véase también

Template:Ep
Template:Ep
Template:Ep para dividir en columnas
Template:Ep para añadir una sucesión o serie



<templatedata>
{
	"description": "La plantilla ficha es la matriz para el uso de fichas informativas en la parte inicial del artículo.",
	"paramOrder": [
		"titulo",
		"titulo2",
		"tipocabecera",
		"colorfondotitulo",
		"subtitulo",
		"imagen",
		"tamañoimagen",
		"pie",
		"imagensuperior",
		"seccion1",
		"etiqueta1",
		"datos1",
		"seccion2",
		"etiqueta2",
		"datos2",
		"seccion3",
		"etiqueta3",
		"datos3",
		"seccion4",
		"etiqueta4",
		"datos4",
		"piedetabla",
		"estiloseccion",
		"estiloetiqueta"
	],
	"params": {
		"titulo": {
			"label": "Título",
			"description": "Título de la ficha",
			"type": "string",
			"required": true,
			"default": "Nombre de título"
		},
		"titulo2": {
			"label": "Título secundario",
			"description": "Título alternativo",
			"type": "string"
		},
		"tipocabecera": {
			"label": "Tipo de ficha (cabecera)",
			"description": "Estilo de cabera (humano, web...). El contexto es similar a los subtítulos."
		},
		"colorfondotitulo": {
			"aliases": [
				"colorfondo"
			],
			"label": "Color de fondo",
			"description": "Color de fondo de la ficha",
			"type": "unbalanced-wikitext",
			"suggested": true
		},
		"subtitulo": {
			"label": "Subtítulo",
			"description": "Subtítulo de la ficha que describe si es un personaje, una ciudad, etcétera.",
			"type": "string",
			"suggested": true
		},
		"imagen": {
			"label": "Imagen principal",
			"description": "Imagen de la ficha.",
			"suggested": true
		},
		"tamañoimagen": {
			"label": "Tamaño imagen principal",
			"description": "Tamaño en píxeles de la ficha.",
			"suggested": true
		},
		"pie": {
			"label": "Pie de imagen principal",
			"description": "Pie de imagen.",
			"suggested": true
		},
		"imagensuperior": {
			"label": "Imagen superior",
			"description": "Imagen adorno en la parte superior."
		},
		"seccion1": {
			"label": "Sección 1",
			"description": "Sección (si fuera necesario)",
			"type": "string"
		},
		"etiqueta1": {
			"label": "Etiqueta 1",
			"description": "Información 1 (lado izquierdo)",
			"suggested": true,
			"type": "string"
		},
		"datos1": {
			"label": "Datos 1",
			"description": "Característica de la información 1 (lado derecho)",
			"suggested": true,
			"type": "string"
		},
		"seccion2": {
			"label": "Sección 2",
			"description": "Sección (si fuera necesario)",
			"type": "string"
		},
		"etiqueta2": {
			"label": "Etiqueta 2",
			"description": "Información 1 (lado izquierdo)",
			"type": "string"
		},
		"datos2": {
			"label": "Datos 2",
			"description": "Característica de la información 1 (lado derecho)",
			"type": "string"
		},
		"seccion3": {
			"label": "Sección 3",
			"description": "Sección (si fuera necesario)",
			"type": "string"
		},
		"etiqueta3": {
			"label": "Etiqueta 3",
			"description": "Información 1 (lado izquierdo)",
			"type": "string"
		},
		"datos3": {
			"label": "Datos 3",
			"description": "Característica de la información 1 (lado derecho)",
			"type": "string"
		},
		"seccion4": {
			"label": "Sección 4",
			"description": "Sección (si fuera necesario)",
			"type": "string"
		},
		"etiqueta4": {
			"label": "Etiqueta 4",
			"description": "Información 1 (lado izquierdo)",
			"type": "string"
		},
		"datos4": {
			"label": "Datos 4",
			"description": "Característica de la información 1 (lado derecho)",
			"type": "string"
		},
		"piedetabla": {
			"label": "Pie de tabla (ficha)",
			"description": "Pie de ficha",
			"type": "string"
		},
		"estiloseccion": {
			"label": "Estilo para secciones",
			"description": "Estilo para las secciones en esta ficha"
		},
		"estiloetiqueta": {
			"label": "Estilo para etiquetas",
			"description": "Estilo para las secciones en esta ficha"
		}
	}
}
</templatedata>

Plantilla:Ficha/doc: Difference between revisions

Latest revision as of 21:17, 14 June 2017

Contents

Uso

Parámetros

Título y subtítulo

Contenido adicional

Estilos CSS

Clases CSS

Cabeceras

Cabeceras "manuales"

Campos opcionales

Parámetros de opciones de comportamiento de la ficha

Ejemplos de uso

Sintaxis completa

Véase también

Navigation menu

Plantilla:Ficha/doc: Difference between revisions

Latest revision as of 21:17, 14 June 2017

Uso

Parámetros

Título y subtítulo

Contenido adicional

Estilos CSS

Clases CSS

Cabeceras

Cabeceras "manuales"

Campos opcionales

Parámetros de opciones de comportamiento de la ficha

Ejemplos de uso

Sintaxis completa

Véase también

Navigation menu

Search