Plantilla:Línea de tiempo gráfica/doc

Función de la plantilla

Esta plantilla provee los recursos para insertar líneas de tiempo en los artículos en una forma intuitiva, flexible y amigable con el usuario. Está diseñada para ser colocada dentro de una tabla (aunque se le puede añadir un margen) y requerir el mínimo número de variables,

Uso

¿Dónde utilizarla?

Si se trata de líneas de tiempo relativamente cortas, pueden ser insertadas directamente dentro del artículo, si embargo las líneas de tiempo largas y complejas pueden interferir con el código de la página y hacer dificil la edición. En estos casos, es posible que usted quisiera alojar la línea de tiempo en otra página (u otro espacio de nombres), e incluirla en el código de la página en la que está trabajando como si de una plantilla se tratara.

Empezando

Se puede incluir el "interruptor" |help=on en la plantilla para produrir algunas guías rápidas.
Cuando usted está empezando a editar esta plantilla, podría resultarle útil utilizar el código {{Línea de tiempo gráfica|help=on}} para generar una plantilla limpia y lista para usar - o escribir {{subst:Línea de tiempo gráfica/blank}} para hacer uso de la página de pruebas, guardar la página, y editar el código resultante. Afortunadamente, los nombres de los parámetros son bastante autoexplicativos.

¿Qué significan los números?

Los valores numéricos, por defecto se interpretan como unidades em, esto es, la altura y anchura de la letra M mayúscula.

La excepción a esta regla son los parametros left y right de la barra, los cuales están dados en coordenadas fraccionarias. Esto significa que el código |bar1-left=0 |bar1-right=0.5 |bar2-left=0.666 |bar3-left=0.5 |bar3-right=0.666 producirá que la barra bar1 cubra la mitad izquierda del área, la barra bar2 el tercio extremo derecho, y bar3 se encuentre entre los otros dos. Adicionalmente, por razones operativas, las unidades de altura "height" se utilizan siempre para generar espesores de bordes.

Bordes de las barras

Los bordes aparecen únicamente en la parte superior e inferior de cualquier barra. Desafortunadamente, esto no puede ser cambiado - para tener un borde en la parte superior o inferior de una barra, debería crearse una barra separada para sobreponerse al final.

El estilo del borde puede ser elegido utlizando lso estándares CSS solid, dotted, dashed, double, groove, ridge, inset o outset. El ancho (width) está en las mismas unidades que la altura (height), y si no se especifica ninguna 0.1 a 0.2 es un valor utilizable.

Líneas en blanco

Dejar un parámetro en blanco no es lo mismo que no especificarlo - ya que podría sobreescribir el valor por defecto que presenta la plantilla. Asegúrese de eliminar cualquier línea que no vaya a especificar.

Períodos geológicos

Para dibujar un período geológico, se puede usar la sintaxis |period3=Cenozoic, with |period3-left=0.1 como es usual. La plantilla luego calculará el comienzo, final y color correcto para la barra.

Consideraciones

Navegadores

Desafortunadamente, los diferentes navegadores, tienen diferentes maneras de lidiar con las líneas de texto que se rebalsan de su contenedor - algunos estiran al contenedor, mientras que otros envuelven el texto. Esto significa que probablemente valga la pena corroborar su línea del tiempo terminada, al menos en IE y Firefox si va a elaborar una línea de tiempo particularmente compleja.

Colores

Si va a ingresar colores utilizando valores html, del estilo #e0b539, debería considerar que algunos monitores viejos, y muchos proyectores, no pueden desplagar algunos colores. Atenerse a los colores web seguros asegura la máxima compatibilidad; lo cual es a menudo aprecido; p.ej. múltiplos de 33, p. ej. #ff99cc o #03C.

Capacidad

Si encuentra que en barras con alta numeración, las entradas para notas o leyendas no se muestran, puede ser debido a que la plantilla no tiene suficiente código para manejarlas. Dentro del código de la plantilla hay instrucciones para que pueda añadir capacidad para mayor número de barras, notas, o leyendas (no es complicado, simplemente copiar y pegar); sin embargo, si no tiene suficiente confianza para hacerlo por su cuenta, hágaselo saber a J3D3 D.

Edición fácil

Si usted crea una línea de tiempo en una subpágina, use el código con el parámetro | link-to= . Especificando el nombre de la página (p.ej. Plantilla:Mi línea de tiempo gráfica), y aparecerán unos enlaces marcados como "edit" e "history".

Lista de parámetros

La lista puede parecer larga, pero no se sienta intimidado, sólo necesita un par de parámetros, ¡y el resto le brindan infinita flexibilidad!

Reemplace cualquier aparición de # por un número.

Los parámetros to y from son obligatorios, el resto de los parámetros son opcionales.

Parámetros generales

Parámetros de la linea de tiempo
Parámetro	Función	¿Requerido?
from	La fecha de comienzo de la línea de tiempo. Puede tomar un valor negativo.	Sí
to	La fecha final (más alta) de la línea de tiempo. Puede tomar un valor negativo.	Sí
width	ancho de la línea de tiempo	No
title	Qué es lo que se muestra en la barra de título	No
title-colour	Color de fondo de la barra de título	No
instance-id	Sufijo para las identificaciones que se generan, para evitar colisiones con otra línea de tiempo.	No

Períodos geológicos

Parámetros de período
Parámetro	Función
period#	Especifica el nombre de un período; la plantilla lo representa automáticamente cuando se especifa una fecha de comienzo y final, y la colorea correctamente.

Barras

Parámetros de la barra
Parámetro	Función
width	Ancho de la línea de tiempo

Leyenda

Parámetros de la leyenda
Parámetro	Función
width	Ancho de la línea de tiempo

Notas

Nota sobre parámetros
Parámetro	Función
width	Ancho de la línea de tiempo

Un ejemplo de uso

El código de la izquierda produce la línea de tiempo que se ve a la derecha, la cual es deliberadamente fea para demostrar las limitaciones de la plantilla.

Línea de tiempo de ejemplo

-550 —

–

-540 —

–

-530 —

–

-520 —

–

-510 —

–

-500 —

←

Comienzo del cámbrico

Cámbrico medio

Fanerozoico

Precámbrico

Infracámbrico

Explosión cámbrica

Una línea de tiempo de eventos aproximadamente a escala
al comienzo del período geológico cámbrico.
La escala de tiempo se encuentra en millones de años antes del tiempo actual.

{{Línea de tiempo gráfica

|title=Línea de tiempo de ejemplo
|align=right

|plot-colour=#bbeebb

|from=-550
|to=-500
|scale-increment=10

|width=10
|height=250
|height-unit=px

|legend1=[[Fanerozoico]]

|bar1-from=-542
|bar1-left=0
|bar1-right=0.1

|legend2=[[Precámbrico]]

|bar2-to=-542
|bar2-left=0
|bar2-right=0.2


|legend3=[[Infracámbrico]]
|legend3-colour=#e0aacc

|bar3-to=-534
|bar3-left=0.1
|bar3-right=0.2
|bar3-colour=#e0aacc

|<!-- If this was bar 4 it would be overlapped by the Botomian bar -->
|bar14-from=-530
|bar14-to=-520
|bar14-left=0.95
|bar14-right=1.05
|bar14-colour=red
|legend14= Explosión cámbrica

|<!--Epochs & stages-->
|bar5-text=[[Ediacarano]]
|bar5-to=-540
|bar5-left=0.2
|bar5-border-width=1
|bar5-colour=#cc9999

|bar6-text=[[Daldiniano]]
|bar6-from=-542
|bar6-to=-534
|bar6-left=0.2
|bar6-border-width=0.1
|bar6-colour=#99cc99

|bar7-text=[[Tommotiano]]
|bar7-from=-534
|bar7-to=-530
|bar7-left=0.1
|bar7-colour=#99cc99
|bar7-border-width=0.1

|bar8-from=-530.1
|bar8-to=-529.9
|bar8-left=0.2
|bar8-colour=black

|bar9-text=[[Atdabaniano]]
|bar9-from=-530
|bar9-to=-524
|bar9-left=0.1
|bar9-right=0.95
|bar9-colour=#99cc99

|bar10-text=[[Botomiano]]
|bar10-from=-524
|bar10-to=-518
|bar10-left=0.1
|bar10-colour=#99cc99
|bar10-border-width=0.1

|bar11-text=[[Toyoniano]]
|bar11-from=-518
|bar11-to=-513
|bar11-left=0.1
|bar11-border-width=0.1
|bar11-colour=#99cc99


|note1=Comienzo del cámbrico
|note1-at=-542
|note1-colour=green

|note2=[[Cámbrico medio]]
|note2-nudge-left=8.5
|note2-nudge-down=0
|note2-at=-507
|note2-remove-arrow=yes

|caption= Una línea de tiempo de eventos aproximadamente a escala<br>al comienzo del período geológico [[cámbrico]].
<br>La escala de tiempo se encuentra en millones de años antes del tiempo actual.
}}

Notas en el ejemplo

Se debe utilizar {{!}} donde deba aparecer un | (por ejemplo en el pie de imagen)
Si no se especifica cuando una barra debe comenzar o terminar, continuará ahasta el borde del área de dibujo.
Las líneas de texto no deben ser demasiado largas para la barra.
La forma en que el desbordamiento de texto se representa en diferentes navegadores es también diferente. Se extiende por fuera de la barra hacia la derecha en Firefox, pero se pliega para encajar dentro del área en IE.