La Enciclopedia Libre Universal en Español dispone de una lista de distribución pública, enciclo@listas.us.es
Usuario:Willy/Timeline
Las líneas de tiempo permiten crear gráficas de cronologías a partir de un lenguaje de marcado especial. En base a los comandos y parámetros indicados, la aplicación generará una imagen svg y a partir de ella un fichero png sobre el que se impresionarán los textos que contengan enlaces wikis.
Te recomendamos encarecidamente que incluyas tus cronologías en una página independiente (subpágina del artículo principal por ejemplo) para que el código de la gráfica no interfiera con la edición del resto del artículo y pueda además insertarse la gráfica en diversos artículos sin necesidad de repetir en código en todos ellos.
El lenguaje de marcado tiene la siguiente sintaxis:
<timeline> [etiqueta de inicio] #Comentarios [Líneas que empiezan por # son comentarios aclaratorios del código] Comando = atributo1:valor [la llamada a un comando no admite sangría al inicio del párrafo] atributo2:valor [sus atributos pueden sangrarse para facilitar la intrepretación del código] ... #> Comentarios largos [#> Indica comienzo de un comentario] pueden escribirse en varias lineas <# [<# Indica final de un comentario] </timeline> [etiqueta de cierre]
Los comandos obligatorios son los que definen:
- el tamaño de la imagen y del área que dentro de ella ocupará el gráfico
- el eje de tiempo: orientación y límites (fecha incial y fecha final)
Índice |
Paso 1. Definir el tamaño
ImageSize = width:ANCHO height:ALTO
No obstante, pueden especificarse tamaños mayores para la correcta visualización y legibilidad de los textos. Los valores deben especificarse en pixeles, aunque existe la posibilidad de que sea el programa el que calcule el ancho (gráficas de barras verticales) o el alto (graficas de barras horizontales) lo que resulta de utilidad si es posible que con el tiempo se vaya completando la gráfica añadiendo más información.
El área de dibujo propiamente dicho (Comando PlotArea obligatorio) se limita especificando los cuatro maŕgenes respecto del dibujo prefiamente definido, ya sea en términos absolutos (pixeles)
- PlotArea = right:DERECHO left:IZQUIERDO top:SUPERIOR bottom:INFERIOR
o relativos (porcentaje de ImageSize)
- PlotArea = right:DERECHO% left:IZQUIERDO% top:SUPERIOR% bottom:INFERIOR%
Observaciones.
- El tamaño mínimo del área de la gráfica es de 20×20. Si se produce este error incrementa el tamaño del dibujo o reduce los márgenes.
- El programa admite establecer las dimensiones de PlotArea en términos absolutos (pixeles) sólo por razones de compatibilidad con versiones anteriores. No debe utilizarse los atributos width y height en PlotArea.
Paso 2. Definir la escala de tiempo
Definida el área de trabajo, debe establecerse las características de la escala de tiempo que se va a utlizar que son esencialmente tres:
DateFormat (opcional). Indica cómo se expresarán todas las fechas. Se puede adoptar cualquiera de los formatos siguientes.
|
|
|
|
|
|
Period (obligatorio). Establece los límites temporales de la escala de tiempo. Las fechas deben indicarse con el formato previamente establecido.
- Period = from:FECHAINICIO till:FECHAFIN
TimeAxis (obligatorio). Establece la orientación del eje de tiempo y en consecuencia de las cronologías del diagrama que se dibujarán paralelas al mismo. Al menos deberá declararse explícitamente el atributo orientation
- TimeAxis =
- format:yyyy
- orientation:hor/ver
- order:reverse
Observaciones.
- Sólo se admite el formato yyyy que es el valor por defecto. En consecuencia, en los ejes sólo es posible marcar con leyendas de texto automáticas los años (todos o algunos como se verá más adelante).
- order:reverse permite reflejar el diagrama respecto de su representación convencional, invirtiendo la escala.
2. Horizontal reflejado: barras horizontales con el origen a la derecha: "TimeAxis: orientation:hor order:reverse"
3. Vertical normal: barras verticales con el origen abajo: "TimeAxis: orientation:ver"
4. Vertical reflejado: barras verticales con el origen arriba: "TimeAxis: orientation:ver order:reverse"
Paso 3. Dividir y visualizar la escala de tiempo
- ScaleMajor. Permite ejecutar la división principal de la escala de tiempos tanto gráfica como textualmente.
- - Añade marcas en el eje de tiempos.
- - Traza líneas correspondientes a esas fechas lo largo del diagrama (si se indica gridcolor o grid).
- - Añade al eje los valores de algunas líneas bajo el eje o a su izquierda según sea la orientación del diagrama horizontal o vertical.
|
|
Observaciones.
- Si se omite la escala principal no se marcará ningún valor en el eje de tiempo.
- Si se define el atrubito text tan sólo se mostrará el texto indicado, omitiendo los valores de las marcas.
- Sólo pueden señalarse años sobre la escala principal (con la distancia que se haya elegido), independientemente de que la resolución sea, por ejemplo, month (meses).
- ScaleMinor. División secundaria de la escala con los mismos atributos que ScaleMajor.
- - Añade marcas en el eje de tiempos, de menor tamaño que las principales.
- - Traza líneas correspondientes a las fechas indicadas a lo largo del diagrama (si se indica gridcolor o grid).
Ejemplo.
|
<timeline> ImageSize = width:800 height:70 PlotArea = right:20 top:20 left:20 bottom:20 DateFormat = dd/mm/yyyy Period = from:01/01/1800 till:01/01/1802 TimeAxis = orientation:horizontal ScaleMajor = grid:red unit:month increment:1 start:01/01/1800 ScaleMinor = grid:blue unit:day increment:7 start:01/01/1801 </timeline> | |
|
|
Referencias
En inglés:
