Plantilla:Línea de tiempo gráfica
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
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á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á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ámetro | Función |
|---|---|
| width | Ancho de la línea de tiempo |
Leyenda
| Parámetro | Función |
|---|---|
| width | Ancho de la línea de tiempo |
Notas
| 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.
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.
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.