Ayuda: Sintaxis de EasyTimeline

La función EasyTimeline genera una imagen incrustada a partir de un wikitexto. La imagen puede ser un diagrama unidimensional (horizontal o vertical) o bidimensional. El nombre "EasyTimeline" hace referencia a la posibilidad de aplicar la función con una escala de tiempo horizontal o vertical, posiblemente con otro parámetro en la otra dirección, pero también existen otras posibilidades.

Véase también Wikipedia:Timeline , mw:Extension:EasyTimeline, mw:Extension:EasyTimeline/syntax, Activación de EasyTimeline en otras instalaciones de MediaWiki

Introducción

Se pueden generar líneas de tiempo gráficas proporcionando un script entre etiquetas especiales:

Guión <línea de tiempo></línea de tiempo>

Luego se invocará EasyTimeline para renderizar una imagen PNG y (opcionalmente) un mapa en el que se pueda hacer clic.

Descargo de responsabilidad : aunque EasyTimeline está diseñado para facilitar su uso, una línea de tiempo gráfica complicada no es una tarea trivial. Una línea de tiempo simple puede llevar media hora para componerse (o incluso menos, si se toma un ejemplo adecuado como base). Las líneas de tiempo grandes pueden llevar unas horas para componerlas y ajustarlas. Sin embargo, agregar o corregir una línea de tiempo, sin importar lo compleja que sea, debería ser una tarea relativamente sencilla, incluso para los colaboradores que no tengan un conocimiento experto de la sintaxis descrita aquí.

No dudes en pedirle consejo al autor de EasyTimeline.

Comandos disponibles

Los comandos de script definen:

Diseño general: tamaño de imagen, área de trazado, colores, colores de fondo, barras de alineación
Interpretación y presentación de fechas y periodos: DateFormat, Period, ScaleMajor, ScaleMinor, TimeAxis
Eventos, periodos y textos descriptivos: PlotData, TextData
Cómo ordenar, dividir y nombrar grupos de eventos y períodos: BarData, Legend, LineData
Abreviaturas para fragmentos de código de script que aparecen varias veces: Definir

Los siguientes comandos son obligatorios: ImageSize, PlotArea, Period y TimeAxis. Se requiere al menos uno de los siguientes comandos: PlotData y/o TextData. Cualquiera de ellos o ambos pueden aparecer varias veces. Todos los demás comandos son opcionales.

Mayúsculas y minúsculas : los comandos y sus atributos se pueden especificar en mayúsculas y minúsculas o en combinación. Intente utilizar siempre las mayúsculas y minúsculas para facilitar la lectura, por ejemplo, utilice una combinación de mayúsculas y minúsculas para todos los atributos y todos los comandos.

Reglas generales de sintaxis

Un script puede contener comandos y comentarios. Cada comando va seguido de uno o más atributos.

Comandos

Los comandos deben comenzar en la primera posición de una línea. Algunos comandos pueden ir seguidos de varias líneas de datos y/o opciones. Estas líneas adicionales deben comenzar con al menos un espacio o estar completamente vacías (esto último es útil para agrupar visualmente las líneas de datos relacionadas).

Los comandos tienen una de las siguientes formas, dependiendo del tipo de comando:

Comentarios

Se pueden especificar comentarios de una o varias líneas:

El texto que siga al signo almohadilla # se considerará un comentario.
El texto entre #> y <# también se considerará un comentario. Los comentarios pueden abarcar varias líneas cuando se etiquetan de esta manera.

Ejemplos:

Dateformat = dd/mm/aaaa # Formato de fecha europeoPeríodo = desde: 01/09/1939 hasta: 02/09/1945 #> este gráfico mostrará la duración completa de la Segunda Guerra Mundial <#

Atributos

Cuando se pueden especificar varios atributos para un comando determinado, se indican como pares "nombre:valor". Cuando se pueden especificar varios valores para un atributo, deben estar entre paréntesis.

Ejemplos:

AlignBars = justificarColor SB = valor:rgb(0.8,0,0.7) leyenda:Sea_Battles

Parámetros vs elementos de datos

La mayoría de los comandos solo aceptan atributos que se especifican en la misma línea.

Bloques de datos: algunos comandos, como BarData, PlotData, TextData y Colors, esperan un bloque de datos que conste de una o más líneas de datos . Las líneas de datos deben comenzar con uno o más espacios. Un bloque de datos se considera completo cuando se encuentra una línea que comienza con un espacio que no sea un espacio (excepción: las líneas vacías se ignoran, se pueden usar para agrupar líneas de datos relacionadas dentro de un bloque).

Los atributos de un bloque de datos se pueden dividir conceptualmente en parámetros y elementos de datos . Los bloques de datos pueden contener parámetros y elementos de datos entremezclados.

Elementos de datos: en las líneas de datos, los atributos text , from , till y at siempre se aplican solo a la línea en la que aparecen.

Parámetros: en las líneas de datos, los atributos como el color y el tamaño de fuente tienen diferentes implicaciones según el contexto. Si estos parámetros aparecen en una línea sin elementos de datos, establecen nuevos valores predeterminados para las líneas de datos que siguen. Si aparecen en una línea mezclada con elementos de datos, se aplican solo a esa línea, anulando así un valor predeterminado que se había establecido previamente.

Ejemplo:

# En este ejemplo se dibujan dos conjuntos de barras, en rojo y azul respectivamente,# pero en cada conjunto se dibujará una barra (que marca los períodos de guerra) en verde.Datos de trama = color:rojo tamaño de fuente:S # establecer valores predeterminados barra:URSS desde:1919 hasta:1922 texto:Lenin # barra roja barra:URSS desde:1922 hasta:1953 texto:Stalin # barra roja barra:URSS desde:1939 hasta:1945 texto:Segunda Guerra Mundial color:verde # barra verde barra:URSS desde:1953 hasta:1964 texto:Krushchev # barra roja   color:azul # cambiar el color predeterminado barra:EE.UU. desde:1913 hasta:1921 texto:Wilson # barra azul barra:EE.UU. desde:1917 hasta:1918 texto:Primera Guerra Mundial color:verde # barra verde barra:EE.UU. desde:1921 hasta:1923 texto:Harding # barra azul#> este comentario de varias líneas no finaliza el comando PlotData, incluso cuando la línea anterior no comience con un espacio<# barra:EE.UU. desde:1923 hasta:1929 texto:Coolidge # barra azulTextData = # ahora PlotData se considera completo pestañas:...etc.

Caracteres especiales

# , #> , <# (hash, hash+"mayor que", "menor que"+hash): ver Comentarios
~ (tilde) en textos significa: salto de línea
^ (caret) en textos significa: tabulación
_ (guión bajo) en textos significa: espacio
$ (signo de dólar) precede a cualquier constante definida por el usuario

Referencia de comandos

Para cada comando se enumeran los atributos válidos. Algunos comandos y/o atributos son opcionales (O).

Para algunos comandos, ciertos atributos son mutuamente excluyentes (se explicará cuando corresponda).

Barras de alineación

Las barras siempre se dibujarán a distancias iguales. Este comando especifica si las barras deben estar lo más separadas posible o si se debe reservar un espacio en blanco entre el lado izquierdo/superior del gráfico y la primera barra o entre la última barra y el lado derecho/inferior del gráfico.

temprano (predeterminado): La primera barra se colocará en la posición más a la izquierda/superior del gráfico ('pegada' al eje), dejando espacio entre la última barra y el lado derecho/inferior del gráfico.
tarde: Opuesto a lo anterior : la última barra se colocará lo más a la derecha/inferior del gráfico como sea posible, dejando espacio entre la línea del eje (lado izquierdo/superior del gráfico) y la primera barra.
justificar: La primera y la última barra se colocarán lo más separadas posible, sin dejar espacios vacíos a ambos lados del gráfico. Cuando solo haya una barra, la justificación se interpretará como "centrada".

Ejemplos:

Colores de fondo

Este comando permite especificar colores de fondo para varias partes del gráfico. Cualquier ID de color especificado debe definirse primero mediante Colores.

lienzo (O): Especifique un color de fondo para toda la imagen.
barras (O): Especifique un color de fondo para todas las barras.

Ejemplos:

BackgroundColors = barras:gris oscuroBackgroundColors = lienzo:gris claro barras:gris oscuroBackgroundColors = lienzo:gris claro

Datos de barra

Este es un comando opcional que, si está presente, determina qué barras se dibujarán en el gráfico y en qué orden. Si se omite, las barras se dibujarán en el orden en que aparecen en el comando PlotData.

Para líneas de tiempo complejas con muchas barras, se recomienda utilizar este comando:

Facilitará el reordenamiento de los datos mostrados.
Los nombres de barras especificados en PlotData se pueden validar con esta lista, evitando así errores de tipeo.

bar: define el identificador de la barra. Otros comandos (especialmente PlotData) esperarán este identificador como referencia. Esta también será la etiqueta que se mostrará a lo largo del eje, a menos que haya un texto de atributo presente. El identificador de la barra no debe contener espacios: utilice guiones bajos en su lugar, estos se convertirán en espacios, como en los títulos de los artículos.
texto (O): Cuando se especifica, esto especifica el texto que se presentará a lo largo del eje, en lugar del identificador de la barra. Consulte también las reglas para la entrada de texto. El texto puede incluir un enlace incrustado (consulte la Nota 1 ).
enlace (O): Especifique un enlace web (consulte la Nota 1 ) (URL). La etiqueta a lo largo del eje se mostrará como un enlace azul en el que se puede hacer clic.

Notas

Utilice el enlace de atributo o un enlace incrustado en el texto del atributo , no ambos.

Ejemplos:

Datos de barra = bar:Japón bar:US text:"Estados Unidos" # hace referencia en PlotData a la barra "EE.UU." pero muestra "Estados Unidos" barra:China texto:[[China]] # La etiqueta China se mostrará como un enlace azul en el que se puede hacer clic y que lleva al artículo de Wikipedia en inglés sobre China.

Las siguientes líneas producen la misma salida (solo cambia la referencia en PlotData):

barra:US texto:[[Estados_Unidos]]barra:US texto:"Estados Unidos" enlace:http://www.wikipedia.org/wiki/Help:EasyTimeline_syntax/United_Statesbarra:Estados_Unidos enlace:http://www.wikipedia.org/wiki/Help:EasyTimeline_syntax/United_States

Bandera

Este comando permite definir colores y asociarlos a una identificación (etiqueta de identificación). Otros comandos harán referencia a colores con la identificación especificada aquí. Este comando espera una o más definiciones de color, cada una en una línea separada con sangría.

identificación: Otros comandos utilizarán esta identificación para especificar colores de texto, barra o fondo.
valor: Definición de color real. Los valores de color se pueden especificar de la siguiente manera:

constante de color predefinida, para la cual se reconocen 32 nombres de colores predefinidos (consulte la página de colores de Ploticus donde se definen todas estas constantes). rgb (rojo, verde, azul): especifica 3 números entre 0 (mínimo) y 1 (máximo) gris (valor): especifica un número entre 0 (negro) y 1 (blanco)

leyenda (O): Especifica el texto que debe aparecer en la leyenda para este color. Si se omite este atributo, no aparecerá ninguna entrada en la leyenda. Consulte Introducción de texto para conocer las reglas.

Ejemplo:

Colores = id:war valor:rojo leyenda:Período de guerra id:paz valor:azul leyenda:Tiempo de paz id:tratado valor:rgb(0.6,0,0.6) id:gris claro valor:gris(0.9) id:darkgrey valor:gris(0.1)

Formato de fecha

Este comando define cómo deben interpretarse las fechas especificadas en otros comandos.

Los formatos de fecha válidos son:

dd/mm/aaaa: Las fechas se interpretan como día/mes/año.; Nota : este formato solo está permitido para fechas que comiencen a partir del 01/01/1800
mm/dd/aaaa: Las fechas se interpretan como mes/día/año.; Nota : este formato solo está permitido para fechas que comiencen a partir del 01/01/1800
aaaa: Esto trata con números enteros de -9999 a +9999

Ejemplo:

Formato de fecha = mm/dd/aaaa

Definir

Este comando permite definir constantes de texto, es decir, abreviaturas de fragmentos de código de script que aparecen varias veces. Las constantes de texto siempre deben comenzar con un $ (signo de dólar).

Ejemplo:

Definir $broad = ancho:30Definir $narrow = ancho:10Definir $bardefaults = $broad fontsize:S

Tamaño de la imagen (obligatorio)

Este comando define el tamaño total de la imagen final. Especifique los valores en medidas absolutas.

ancho: Ancho de la imagen final: máximo 1600 píxeles, mínimo 25
altura: Altura de la imagen final: máxima 1200 píxeles, mínima 25

Para lograr la máxima flexibilidad, puede dejar que el script calcule la altura o el ancho de la imagen, en función de la cantidad de barras y la cantidad de píxeles que se agregarán por barra. Especifique altura:automática (para el eje de tiempo horizontal) o anchura:automática (para el eje de tiempo vertical).

Esto es especialmente útil cuando es probable que la cantidad de barras en una línea de tiempo cambie con el tiempo una y otra vez. O para garantizar distancias iguales entre barras en imágenes con muchas barras estrechas donde las diferencias en la cantidad de espacio en blanco se notarían pronto (consulte para un ejemplo real Template:Vocal and instrumental pitch ranges ). O para asegurarse de que varias líneas de tiempo relacionadas siempre usen la misma distancia entre barras, sin importar cuántas barras contenga cada una (consulte para un ejemplo real List of papas (graphical) ). En resumen, es una buena idea la mayor parte del tiempo.

incremento de barra: Cantidad en píxeles que debe agregarse al tamaño de la imagen para cada barra especificada (obligatorio y solo permitido en combinación con width:auto o height:auto).

Ejemplos:

Tamaño de la imagen = ancho:800 alto:600Tamaño de la imagen = ancho:800 alto:automático incremento de barra:30

Leyenda

Solo se mostrará una leyenda cuando esté presente este comando. Existen varias formas de definir la apariencia y la posición de la leyenda. Algunos atributos son mutuamente excluyentes (consulte a continuación).

orientación (O): Especifique hor[izontal] o ver[tical] (predeterminado).; Restricción : orientación = 'horizontal' y posición = 'derecha' son mutuamente excluyentes
posición (O): Define la ubicación de la leyenda en relación con el área del gráfico. Especifique la posición superior, inferior (predeterminada) o derecha.; Restricción : orientación = 'horizontal' y posición = 'derecha' son mutuamente excluyentes
columnas (O): Especifique 1, 2, 3 o 4. Cuando se omite este atributo, el número de columnas se determina de la siguiente manera:

Orientación horizontal : Las columnas de atributos no se aplican aquí. Todas las entradas estarán en la misma línea.
Orientación vertical :
- Posición derecha : Todas las entradas estarán en una columna.
- Posición superior o inferior : El número de columnas depende del número de entradas a mostrar:
  1-5 entradas: 1 columna, 6-10 entradas: 2 columnas, 11 o más entradas: 3 columnas.

Consejo: puede considerar omitir los siguientes parámetros al principio y solo agregarlos cuando las configuraciones predeterminadas no sean satisfactorias.

ancho de columna (O): Define la distancia entre columnas. Puedes especificar una distancia absoluta o relativa (como porcentaje del ancho de la página).; restricción : este parámetro se ignora cuando se define o implica columnas = 1.
izquierda (O): Define la distancia entre el lado izquierdo de la leyenda y el lado izquierdo de la página. Puede especificar una distancia absoluta o relativa (como porcentaje del ancho de la página).
arriba (O): Define la distancia entre la parte superior de la leyenda y la parte inferior de la página. Puede especificar una distancia absoluta o relativa (como porcentaje de la altura de la página).

Ejemplos:

Leyenda = orientación:vertical posición:inferior columnas:3 ancho de columna:140Leyenda = orientación:posición horizontal:abajoLeyenda = izquierda:100 arriba:120 columnas:3

Datos de línea

Algunas líneas de tiempo se extienden a lo largo de varios períodos claramente diferenciados. Una línea que delimite estos períodos puede servir como ayuda visual.

en: Dibuja una línea perpendicular al eje del tiempo (por defecto, con la longitud máxima, ver también a continuación).
Especifique la fecha o el año en que se debe dibujar la línea, de acuerdo con el DateFormat especificado.
color: Especifique el color en el que debe dibujarse la línea.; Nota : El ID de color especificado debe definirse primero con el comando Colores.
capa: Especifique delante o detrás (predeterminado). Define si la línea debe aparecer delante o detrás de todas las barras del segmento de tiempo.
ancho: Especifique un valor entre 0,1 (muy fino) y 10 (muy grueso)

Solo en casos excepcionales pueden necesitarse los siguientes atributos adicionales para lograr una flexibilidad total:

Opciones de posicionamiento avanzadas

Puedes dibujar líneas en cualquier dirección. Las siguientes opciones están disponibles:

Perpendicular al eje del tiempo con puntos de inicio y fin arbitrarios: at : fecha frompos : posición tillpos : posición
Paralelo al eje del tiempo con puntos de inicio y fin arbitrarios desde : fecha hasta : fecha enpos : posición
En cualquier dirección con puntos de inicio y fin arbitrarios: puntos :(x1,y1)(x2,y2)

Los atributos at , from y till esperan una fecha o un año, de acuerdo con el DateFormat especificado.
Los atributos frompos , tillpos y atpos esperan coordenadas (por ejemplo, valores en píxeles).

Ejemplo:

Datos de línea =  capa:frontal # todas las líneas delante de las barras a menos que se indique lo contrario  en:1 color:amarillo # perpendicular al eje del tiempo longitud completa   en:2 color:naranja capa:atrás # perpendicular al eje del tiempo longitud total pero detrás de las rejas    a las:4 desde pos:50 hasta pos:105 color:verde # perpendicular al eje del tiempo, con puntos de inicio y fin especificados     desde:5 hasta:8 en pos:50 color:rojo # paralelo al eje del tiempo     puntos: ( 100 , 20 )( 170 , 105 ) color:azul ancho:3 # de una posición absoluta arbitraria a otra, extra grueso

Nótese que en el ejemplo anterior esas "posiciones absolutas" se representan en el contexto de ImageSize = width:200 height:120 y PlotArea = left:20 right:10 top:10 bottom:20 .

Periodo (obligatorio)

Define el período de tiempo que se mostrará en el gráfico. Ambos parámetros son obligatorios. Especifique las fechas de acuerdo con el formato de fecha especificado.

de: La línea de tiempo comienza aquí. El valor especificado se puede utilizar como punto de inicio en comandos como PlotData y TextData.
hasta: El tiempo termina aquí. El valor especificado puede ser referenciado como fin en otros comandos.

Ejemplo:

Periodo = desde: 01/09/1939 hasta: 02/09/1945

Área de la parcela (obligatorio)

ancho: Especifique el valor en medidas absolutas o relativas. ( no lo use más , vea a continuación)
altura: Especifique el valor en medidas absolutas o relativas. ( no lo use más , vea a continuación)
izquierda: Margen entre el lado izquierdo de la imagen y el lado izquierdo del área de trazado. Especifique el valor en medidas absolutas o relativas.
arriba: Margen entre la parte superior de la imagen y la parte superior del área de trazado. Especifique el valor en medidas absolutas o relativas.
bien: Margen entre el lado derecho de la imagen y el lado derecho del área de trazado. Especifique el valor en medidas absolutas o relativas.
abajo: Margen entre la parte inferior de la imagen y la parte inferior del área de trazado. Especifique el valor en medidas absolutas o relativas.

atributos de ancho/alto

Estos atributos se conservan únicamente por compatibilidad con versiones anteriores. Antes, un área de trazado solo se podía definir por su ancho y altura totales y por los márgenes izquierdo e inferior . Ahora puede especificar los cuatro márgenes y se recomienda hacerlo, y no utilizar más los atributos de ancho y altura . La ventaja es una mayor flexibilidad: cuando cambia el tamaño general de la imagen, no necesita ajustar también la definición del área de trazado. Esto es aún más importante cuando el tamaño de la imagen se calcula automáticamente (consulte ImageSize).

Ejemplo:

# por ejemplo, espacio adicional a la izquierda y debajo del área del gráfico para las etiquetas de los ejes y la leyendaÁrea del terreno = izquierda: 40 abajo: 60 arriba: 10 derecha: 10

Datos de la trama

Se utiliza para definir barras (que simbolizan un período de tiempo) y agregar texto junto a estas barras en una posición específica.

Para textos que no estén relacionados con un período o fecha/año determinado o que requieran un formato extenso, utilice el comando TextData.

Los atributos text, at, from y till siempre se aplican solo a la línea en la que aparecen. Todos los demás atributos, cuando no se combinan con uno de estos cuatro, actúan como predeterminados para el resto del bloque de comandos o hasta que se especifique un nuevo valor predeterminado, y pueden anularse para una sola línea. Consulte Parámetros frente a elementos de datos para obtener más información y un ejemplo.

PlotData acepta muchos atributos, algunos de los cuales son mutuamente excluyentes. Estos atributos se pueden agrupar de la siguiente manera:

Atributos posicionales
Atributos relacionados con la barra
Atributos del texto
Atributo de marcador

Atributos posicionales

en

Especifica en qué fecha/año debe colocarse un texto. Según el atributo, el texto comienza, termina o está centrado en esta posición. Utilice el formato de fecha/año como se especifica en DateFormat o especifique el inicio o el fin que se refiere al período de tiempo definido por el comando Period.

NB : Este atributo no se puede combinar con los atributos desde o hasta .

de

Especifica en qué fecha/año debe comenzar una barra. Utilice el formato de fecha/año como se especifica en DateFormat o especifique el inicio que se refiere al período de tiempo definido por el comando Period.

NB : Este atributo debe usarse en combinación con el atributo till y no puede combinarse con el atributo at .

hasta

Especifica en qué fecha/año debe finalizar una barra. Utilice el formato de fecha/año especificado en DateFormat o especifique end , que hace referencia al período de tiempo definido por el comando Period.

NB : Este atributo debe usarse en combinación con el atributo from y no puede combinarse con el atributo at .

cambio

Especifica un desplazamiento horizontal y vertical en medidas absolutas para un texto. Esto permite:

Los textos deben desplazarse para evitar superposiciones
Colocación del texto al lado de una barra, en lugar de encima de ella.

Ejemplos:

Formato de fecha = dd/mm/aaaaPeriodo = desde: 01/01/1939 hasta: 02/09/1945Datos de trama= Ancho: 15 barra:Japón desde:01/09/1939 hasta:27/09/1940 color:verde barra:Japón desde:27/09/1940 hasta:19/02/1945 color:amarillo barra:Japón desde:19/02/1945 hasta:14/03/1945 color:azul barra:Japón desde:02/09/1945 hasta:fin color:rojo a las: 07/12/1941 shift:(0,-2) texto:"<-- Ataque a Pearl Harbor"

Atributos relacionados con la barra

bar: Especifica a qué barra se aplican todos los demás atributos.; Cuando no se ha utilizado el comando BarData, las barras se dibujarán en el orden en el que aparecen en cualquier bloque de datos PlotData. El id especificado aquí también será el texto que se mostrará a lo largo del eje, junto a la barra.; Cuando se ha utilizado el comando BarData, las barras se presentarán en el orden especificado allí y también se validará el ID de barra especificado aquí con respecto a esa lista. Además, el texto presentado a lo largo del eje dependerá de la definición en BarData.
juego de barra: Reinicia la visualización de la barra "desde arriba", lo que permite tener varias barras en la misma línea. Sintaxis:barra:nombre
Se pueden agregar líneas en blanco para omitir líneas que no desea agregar con declaraciones comoa las:1234sin más atributos.
color: Especifica el color con el que debe dibujarse la barra.; El ID de color especificado debe definirse primero con el comando Colores.
ancho: Especifica el ancho de la barra en medidas absolutas o relativas.

Ejemplo:

Datos de barra= barra:US texto:Estados Unidos barra:SB texto:Batallas navalesColores= id:US valor:azul leyenda:Estados_Unidos id:SB valor:rgb(0.8,0,0.7) leyenda:Batallas navalesDatos de trama= ancho:0.3 # ver nota 1 barra:SB desde:07/08/1942 hasta:09/02/1943 texto:Guadalcanal color:SB # ver nota 2 barra:US desde:inicio hasta:fin color:US # ver nota 3 barra:A mitad de camino desde:inicio hasta:fin color:US # ver nota 4 bar:US at:07/12/1941 text:7/12 Pearl Harbor # ver nota 5

Notas:

Esta línea establece un ancho de barra predeterminado para el resto del bloque de datos.
Esta línea especifica una barra que se dibujará y un texto que se colocará en ella al mismo tiempo.
La barra US se dibujará antes que la barra SB, incluso cuando se especifique después de ella, porque el comando BarData determina la secuencia
La barra Midway será rechazada porque no está declarada con el comando BarData
La última línea no generará el trazado de una barra, simplemente especifica en qué barra debe colocarse el texto.

Atributos del texto

texto: Define un texto que se debe trazar sobre una barra o cerca de ella. La posición del ancla se puede definir explícitamente con el atributo " at" o implícitamente con los atributos " from" y " till".; En este último caso, el texto se colocará en el centro del segmento de barra definido. Véase también Introducción de texto para las reglas; El texto puede incluir enlaces incrustados (ver Notas 1 y 2 ) para su uso en mapas en los que se puede hacer clic.
color de texto (O): Define el color del texto. El ID de color especificado debe definirse primero con el comando Colores. Si no se especifica, se asumirá el color negro.
tamaño de fuente (O): Especifique un tamaño de fuente entre 6 y 30, o (preferiblemente) una de las etiquetas XS, S (predeterminado), M, L o XL. Consulte Compatibilidad de fuentes para obtener más detalles.
alinear (O): Especifique el centro (predeterminado), izquierda o derecha.
enlace (O): Especifique un enlace web (consulte la Nota 1 ) (URL) para utilizar en mapas interactivos. El texto se mostrará como un enlace azul interactivo.

Notas

Utilice un enlace de atributo o un enlace incrustado en el texto del atributo, no ambos.
En las imágenes PNG solo se mostrará un enlace en el que se pueda hacer clic por segmento de texto (el texto con saltos de línea (~) constituye varios segmentos).

Ejemplo:

Datos de trama= bar:EE.UU. en:07/12/1941 alinear:izquierda color de texto:negro tamaño de fuente:XS texto:7/12 [[Pearl Harbour]]

produce el mismo resultado que:

Datos de trama= bar:US at:07/12/1941 align:left textcolor:black fontsize:XS text:7/12 Pearl Harbor enlace:http://www.wikipedia.org/wiki/Help:EasyTimeline_syntax/Pearl_Harbour

Atributo de marcador

marca: Coloca un marcador en una barra en la posición especificada. Especifique como marca:(símbolo, color). El único valor para símbolo admitido hasta la fecha es línea . El id de color especificado debe definirse primero con el comando Colores. Cuando no se especifica, se asumirá el color negro.

Ejemplo:

Datos de trama= barra:prueba ancho:15 color:rojo Desde:1900 hasta:2000 en:1990 marca:(línea,blanco)

se mostrará como:

Escala mayor

Este comando divide la línea de tiempo en períodos más pequeños, ya sea

Gráficamente, a través de líneas delgadas verticales u horizontales en el gráfico
Textualmente, a través de stubs en el eje del tiempo, debajo o a la izquierda del gráfico
Tanto gráficamente como textualmente

Nota : la orientación de las líneas y/o la ubicación de los stubs dependen de la orientación del eje de tiempo.

color de cuadrícula (O): Define el color de las líneas de la cuadrícula. Si se omite este atributo, no se dibujarán líneas de cuadrícula.; Nota : El ID de color especificado debe definirse primero con el comando Colores.
unidad (O): Especifica la unidad en la que se incrementa el espaciado de la cuadrícula. Especifique día, mes o año (predeterminado).; Nota : Cuando se especifica DateFormat yyyy, solo se permite la unidad año.
incremento (O): Especifica la cantidad de unidades en las que se incrementa el espaciado de la cuadrícula. El valor predeterminado es 1.
empezar (O): Especifica dónde debe mostrarse la primera línea de la cuadrícula o el primer fragmento. El valor predeterminado es el inicio del período definido.

Ejemplos:

Escala mayor = color de cuadrícula:rojo inicio:1940ScaleMajor = gridcolor:red unidad:mes incremento:3 inicio:01/09/1939

Escala menor

Este comando define una subdivisión adicional de la escala de tiempo. Consulte ScaleMajor para conocer la sintaxis.

Ejemplo:

ScaleMajor = cuadrícula:rojo unidad:año incremento:1 inicio:01/01/1940ScaleMinor = cuadrícula:azul unidad:mes incremento:3 inicio:01/10/1939

Datos de texto

Se utiliza para definir un bloque de texto que se puede colocar en cualquier lugar del gráfico.

texto

El texto real. Véase también Introducción de texto para conocer las reglas. El texto puede incluir enlaces incrustados (véanse las Notas 1 y 2 ).

posición

Define la esquina superior izquierda del bloque de texto en medidas absolutas o relativas. Se define como pos:(x,y) .

enlace (O)

Especifique un enlace web (consulte la Nota 1 ) (URL) para utilizar en mapas interactivos. La etiqueta a lo largo del eje se mostrará como un enlace azul interactivo.

color de texto (O)

Define el color del texto. El identificador de color especificado debe definirse primero mediante Colores. Cuando no se especifica, el color es negro.

tamaño de fuente (O)

Especifique un tamaño de punto entre 6 y 30, o (preferiblemente) una de las etiquetas XS , S (predeterminado), M , L o XL (consulte Compatibilidad de fuentes para obtener más detalles).

pestañas (O)

Define la posición y alineación del carácter de tabulación: ^ (símbolo de intercalación). Especifique varias configuraciones de tabulación como tabulaciones: ( x ¹ -a ¹ ,x ² -a ² ,x ³ -a ³ , etc.) donde

x ⁿ es el desplazamiento horizontal en medidas absolutas desde el lado izquierdo del texto
a ⁿ es la alineación del segmento de texto (especifique centro , izquierda o derecha )

altura de línea (O): Define el espaciado entre líneas consecutivas en medidas absolutas. Especifique un valor de hasta 40 píxeles o 0,4 pulgadas. Si no se especifica, la altura de línea predeterminada se basará en el tamaño de fuente que se esté utilizando actualmente.

Notas :

Utilice el enlace de atributo o un enlace incrustado en el texto del atributo , no ambos.
En las imágenes PNG solo se mostrará un enlace en el que se pueda hacer clic por segmento de texto (el texto con tabulaciones (^) constituye varios segmentos).

Ejemplo:

Datos de texto = pos:(20,67) color de texto:negro tamaño de fuente:S pestañas: (10-derecha, 14-izquierda, 50-izquierda, 90-izquierda, 230-izquierda) texto:Alemania, Italia y Japón firman el [[Pacto Tripartito]] texto: ^ 10 ^ 1944 ^ 1-22/7 ^ Bretton Woods 44 naciones establecen texto: ^^^^^ FMI y Banco Mundial

se mostrará como:

Eje temporal

Define la orientación del eje de tiempo y la representación textual de los fragmentos a lo largo de ese eje.

formato (O): Especifique en qué formato deben presentarse las fechas a lo largo del eje del tiempo.; Actualmente, solo se admite el formato aaaa (predeterminado). Es posible que se incorporen más formatos.
orientación (O): Especifique hor[izontal] (predeterminado) o ver[tical].
orden (O): Especifique revertir como la opción para invertir el flujo de tiempo

Ejemplo:

TimeAxis = orientación:horizontal formato:aaaa

Ajustes preestablecidos

Los ajustes preestablecidos son una forma abreviada de definir configuraciones que se usan con frecuencia. Ahorran algunas líneas de código y promueven la estandarización, pero pueden resultar confusos, ya que el script de la línea de tiempo se vuelve menos autodocumentado.

En este momento hay dos ajustes preestablecidos disponibles:

Preset = TimeVertical_OneBar_UnitYear , que se expande a

Área del terreno = izquierda: 45 derecha: 10 arriba: 10 abajo: 10TimeAxis = orientación:vertical formato:aaaaFormatoDeFecha = aaaa;AlignBars = tempranoEscalaMayor = unidad:añoScaleMinor = unidad:añoDatos de trama =marca:(línea,blanco) alinear:izquierda tamaño de fuente:S ancho:20 desplazamiento:(20,0)

Preset = TimeHorizontal_AutoPlaceBars_UnitYear , que se expande a

Tamaño de imagen = altura: incremento de barra automática: 20Área del terreno = izquierda: 25 derecha: 25 arriba: 15 abajo: 30TimeAxis = orientación:horizontal formato:aaaaColores =id:canvas valor:gris(0.7)id:grid1 valor:gris(0.4)id:grid2 valor:gris(0.2)BackgroundColors = lienzo:lienzoFormatoDeFecha = aaaa;AlignBars = justificarScaleMajor = unidad:año cuadrícula:cuadrícula1ScaleMinor = unidad:añoLeyenda = orientación:vertical izquierda:35 arriba:130Datos de trama =alinear:izquierda ancla:desde tamaño de fuente:M ancho:15 desplazamiento:(4,-6) color de texto:negro

Reglas de entrada

Escalas de tamaño y posición

Se pueden utilizar medidas absolutas para especificar tamaños, posiciones y cambios de posición, medidos en píxeles.

Ejemplo:

Área del terreno = ancho:800 alto:600 izquierda:50 inferior:50

Se pueden utilizar medidas relativas para especificar tamaños y posiciones. Especifique un número entre 0 y 100, seguido inmediatamente por un signo % (porcentaje). Para las mediciones horizontales, el porcentaje está relacionado con el ancho de la imagen, y para las mediciones verticales, con la altura de la imagen.

La primera coordenada es horizontal de izquierda a derecha, la segunda es verticalmente hacia arriba.

Ejemplo:

Área del terreno = ancho:80% alto:80% izquierda:10% inferior:5%

Entrada de texto

La entrada de texto está sujeta a algunas reglas:

1) Solo se permite un subconjunto de Unicode para la representación de fuentes, pero Unicode en los enlaces debería funcionar para todos los caracteres. Consulte también Compatibilidad de fuentes.

2). Cuando el texto deba contener espacios, especifíquelos utilizando guiones bajos o coloque el texto entre comillas dobles.

Excepción: cuando el atributo de texto es el último atributo de una línea, se permiten espacios (no surgirá confusión donde termina el texto y comienza el siguiente atributo, es decir, para ser precisos, cuando no aparecen dos puntos en el texto).

Ejemplo: (los siguientes son todos equivalentes)

Datos de barra = texto:Mandato japonés desde 1914 barra:MarshallsDatos de barra = texto:"Mandato japonés desde 1914" barra:MarshallsDatos de barra = barra:Marshalls texto:Mandato japonés desde 1914

3) En las líneas de datos que siguen al comando TextData, un carácter tiene un significado especial:

^ (signo de intercalación) significa tabulación

Ejemplo que muestra pestañas:

Datos de texto = pestañas: (4-derecha, 12-derecha, 14-izquierda, 34-izquierda) texto: ^ 1 ^ 1940 ^ 27/9 ^ Berlín Alemania, Italia y Japón firman el Pacto Tripartito texto: ^ 10 ^ 1944 ^ 1-22/7 ^ Bretton Woods 44 naciones establecen texto: ^^^^^ FMI y Banco Mundial# se mostrará como: # # 1 27/9 Berlín Alemania, Italia y Japón firman el Pacto Tripartito # 10 1-22/7 Bretton Woods 44 naciones establecen # FMI y Banco Mundial

Mapas interactivos

Los dos formatos de salida disponibles en MediaWiki, es decir, PNG y SVG, pueden contener enlaces en los que se puede hacer clic. Los textos que se muestran en azul y las barras se pueden seleccionar para navegar a otra página web.

Los enlaces se pueden especificar con los comandos BarData, PlotData y TextData, ya sea con el atributo link o como enlaces incrustados, a través del atributo text .

Puede especificar un enlace por segmento de texto.

Enlaces incrustados

Los enlaces incrustados son enlaces que forman parte de un texto que se puede visualizar y que se especifican con el atributo text . Su contraparte son los enlaces explícitos (solo URL) que se definen con el atributo link .

Ambos tipos de enlaces se pueden especificar con los comandos BarData, PlotData y TextData y se utilizan para mapas en los que se puede hacer clic.

En los enlaces incrustados, el estilo de enlace interno es el habitual, el estilo de enlace interwiki no funciona, el estilo de enlace externo es el habitual con corchetes simples, pero aquí con una barra vertical en lugar de un espacio.

Ejemplos:

 texto:ejemplo [[Ayuda:Enlace]] enlace interno

se mostrará como:

 texto:[[Ayuda:Enlace|Enlace]]

se mostrará como:

 texto:[http://en.wikipedia.org/wiki/Help:EasyTimeline_syntax/Rembrandt|Rembrandt van Rijn] pinta La ronda de noche

se mostrará como:

Intente utilizar el estilo de enlace interwiki:

 texto:[[Página principal]]

y similar con nl: y m: dan:

El tercero a Meta-Wikipedia funciona correctamente, excepto desde Meta mismo, los otros enlaces funcionan como Página principal (página interna, el prefijo se ignora) o por ejemplo //en.wikipedia.org/w/Main_Page (muestra Archivo no encontrado), dependiendo de la URL de la página de referencia (por ejemplo, diferente para una página de vista previa y una página de diferencias).

Caracteres especiales:

Los espacios en blanco y los guiones bajos en la URL deben escribirse como %20.

El carácter tilde ( ~ ) normalmente se interpreta como un salto de línea. Cuando una tilde es parte de una URL, escríbala tal cual, con dos tildes.
Por ejemplo, enlace a www.site.com/~mysite como:

 texto:[www.site.com/~~mysite|Mi sitio]

El signo de número ( # ) normalmente se interpreta como el comienzo de un comentario. Cuando un signo de número forma parte de una URL, asegúrese de que el texto esté entre comillas dobles, como se indica a continuación:

 texto:"Más en [www.site.com/~~mysite#section2|Mi sitio]"

En realidad, puede ser una buena idea poner siempre los textos entre comillas dobles.

Compatibilidad con fuentes

Timeline tiene un soporte Unicode algo limitado. Utiliza la fuente FreeSans.ttf, que admite un subconjunto de todos los glifos posibles (admite el alfabeto cirílico, los diactricos de Europa del Este y los kana, por ejemplo, pero no admite kanji). También puedes especificar |font=freesanswmfo |font=unifontespecificar una fuente diferente, o hacer la representación de una manera completamente diferente con |method=svg2png.

Ejemplo:

ImageSize = ancho:180 alto:90 PlotArea = ancho:180 alto:90 izquierda:0 inferior:0 TimeAxis = orientación:vertical #dummy Colors = id:gray value:gray ( 0.95 ) Backgroundcolors = canvas:gray Period = from:1 till:2 # dummy TextData = pos :( 10 , 90 ) fontsize:L text: "维基百科" pos :( 10 , 70 ) fontsize:L text: "Zażółć gęślą jaźń" pos :( 10 , 50 ) fontsize:L text: "ウィキペディア"

se mostrará como:

Como legado del uso de fuentes de mapa de bits, solo hay cinco etiquetas de fuente predefinidas. Se mostrarán en tamaños ligeramente diferentes en imágenes PNG y SVG para producir una legibilidad óptima para ambas plataformas. Se recomienda utilizar estas etiquetas en lugar de números siempre que sea posible. Son: XS = extra pequeña, S = pequeña (predeterminada), M = mediana, L = grande, XL = extra grande

Esta documentación es originalmente una versión wikipedificada de la documentación original de EasyTimeline.

Código EasyTimeline con parámetros de plantilla

Para representar los parámetros de la plantilla, debe utilizar {{#tag:la sintaxis. A modo de ejemplo:

{{#tag:línea de tiempo|Tamaño de la imagen = ancho:280 alto:25Área del terreno = ancho:280 alto:25 izquierda:0 abajo:0TimeAxis = orientación:vertical # ficticio, obligatorioPeriodo = desde:0 hasta:1 # ficticio, obligatorioColores = id:canvas valor:rgb(1,1,0.85)BackgroundColors = lienzo:lienzoDatos de texto = pos:(10,10) tamaño de fuente:XL texto:"a"}}

se representa como