Ayuda: sintaxis de EasyTimeline

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

Consulte también Wikipedia: Timeline , mw:Extension:EasyTimeline, mw:Extension:EasyTimeline/syntax, activación de EasyTimeline en otras instalaciones de MediaWiki

Introducción

Se pueden producir 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 representar una imagen PNG y (opcionalmente) un mapa en el que se puede hacer clic.

Descargo de responsabilidad : aunque EasyTimeline está diseñado para ser fácil de usar, una línea de tiempo gráfica complicada no es un asunto trivial. Una línea de tiempo simple puede tardar media hora en redactarse (o incluso menos, si se toma como base un ejemplo adecuado). Los cronogramas grandes pueden tardar algunas horas en componerse y ajustarse. Sin embargo, agregar o corregir una línea de tiempo, sin importar cuán compleja sea, debería ser un asunto relativamente sencillo, incluso para los contribuyentes que no tienen conocimientos expertos de la sintaxis descrita aquí.

No dude en pedirle consejo al autor de EasyTimeline.

Comandos disponibles

Los comandos del 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 de 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 o ambos pueden ocurrir varias veces. Todos los demás comandos son opcionales.

Caso : los comandos y sus atributos se pueden especificar en minúsculas, mayúsculas o mixtas. Intente ser coherente al aplicar mayúsculas y minúsculas, ya que esto mejorará la legibilidad; por ejemplo, utilice mayúsculas y minúsculas para todos los comandos y minúsculas para todos los atributos.

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/u opciones. Estas líneas adicionales deben comenzar con al menos un espacio o estar completamente vacías (esto último es útil para agrupar visualmente líneas de datos relacionadas).

Los comandos tienen una de las siguientes formas, según el tipo de comando:

Comentarios

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

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

Ejemplos:

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

Atributos

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

Ejemplos:

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

Parámetros frente a elementos de datos

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

Bloques de datos: algunos comandos, como BarData, PlotData, TextData, Colors esperan un bloque de datos que consta 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 sin un espacio (excepción: las líneas vacías se ignoran; pueden usarse 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 texto , desde , hasta y en siempre se aplican solo a la línea en la que aparecen.

Parámetros: en las líneas de datos, atributos como el color y el tamaño de fuente tienen diferentes implicaciones según el contexto. Si estos parámetros ocurren 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 establecido previamente.

Ejemplo:

# En este ejemplo se dibujan dos conjuntos de barras, en rojo y azul respectivamente,# pero en cada conjunto una barra (que marca los períodos de guerra) se dibujará 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 multilínea no finaliza el comando PlotData, incluso cuando la línea anterior no comienza 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
^ (intercalación) 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 comando

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án cuando corresponda).

Alinear barras

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 algo de 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 ('pegado' al eje), dejando espacio entre la última barra y el lado derecho/inferior del gráfico.
tarde: Opuesto desde el principio : la última barra se colocará lo más hacia el lado derecho/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 ninguno de los lados del gráfico. Cuando solo hay 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 usando Colores.

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

Ejemplos:

Colores de fondo = barras:gris oscuroBackgroundColors = lienzo:gris claro barras:gris oscuroColores de fondo = 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 orden de aparición en el comando PlotData.

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

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

bar: define la identificación de la barra. Otros comandos (en particular, PlotData) esperarán esta identificación como referencia. Esta también será la etiqueta que se mostrará a lo largo del eje, a menos que esté presente el texto del atributo . La identificación de la barra no debe contener espacios: use guiones bajos en su lugar, estos se convertirán en espacios, como ocurre con 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 de la identificación de la barra. Consulte también las reglas para la entrada de texto. El texto puede incluir un enlace incrustado (ver 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 un enlace de atributo o un enlace incrustado en el texto del atributo , no ambos.

Ejemplos:

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

Las siguientes líneas producen el mismo resultado (solo la referencia en los cambios de PlotData):

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

Colores

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

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

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

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

Ejemplo:

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

Formato de fecha

Este comando define cómo se deben interpretar 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 sólo está permitido para fechas a partir del 01/01/1800
dd/mm/aaaa: Las fechas se interpretan como mes/día/año.; Nota : este formato sólo está permitido para fechas a partir del 01/01/1800
yyyy: esto trata con números enteros de -9999 a +9999

Ejemplo:

Formato de fecha = mm/dd/aaaa

Definir

Este comando permite la definición de 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 $ (signo de dólar).

Ejemplo:

Definir $amplio = ancho:30Definir $estrecho = ancho:10Defina $bardefaults = $broad fontsize:S

Tamaño de imagen (obligatorio)

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

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

Para obtener la máxima flexibilidad, puede dejar que el script calcule la altura o el ancho de la imagen, en función del número de barras y la cantidad en píxeles que se agregarán por barra. Especifique altura:auto (para eje de tiempo horizontal) o ancho:auto (para 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 pronto se notarían diferencias en la cantidad de espacios en blanco (consulte un ejemplo real Plantilla: rangos de tono vocal e instrumental ). O para asegurarse de que varias líneas de tiempo relacionadas siempre utilicen la misma distancia entre barras, sin importar cuántas barras contenga cada una (consulte para ver un ejemplo real Lista de papas (gráfica) ). En resumen, es una buena idea la mayor parte del tiempo.

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

Ejemplos:

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

Leyenda

Sólo se mostrará una leyenda cuando este comando esté presente. Hay varias formas de definir la apariencia y posición de la leyenda. Algunos atributos son mutuamente excluyentes (ver más abajo).

orientación (O): Especifique horizontal[izontal] o vertical[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 arriba, abajo (predeterminado) 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 que se mostrarán:
  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 agregarlos solo cuando la configuración predeterminada no sea satisfactoria.

ancho de columna (O): Define la distancia entre columnas. Puede 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: posición vertical: columnas inferiores: 3 ancho de columna: 140Leyenda = orientación:posición horizontal:abajoLeyenda = izquierda:100 arriba:120 columnas:3

Línea de datos

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

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

Sólo en casos excepcionales es posible que se necesiten 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 de tiempo con puntos de inicio y parada arbitrarios: en : fecha desde pos : posición hasta pos : posición
Paralelo al eje de tiempo con puntos de inicio y parada arbitrarios desde : fecha hasta : fecha en pos : posición
En cualquier dirección con puntos de inicio y parada arbitrarios: puntos :(x1,y1)(x2,y2)

Los atributos en , desde y hasta esperan una fecha o año, de conformidad con el DateFormat especificado.
Atributos de pos , hasta pos , atpos esperan coordenadas (por ejemplo, valores de píxeles)

Ejemplo:

Datos de línea =  capa:frente # todas las líneas delante de las barras a menos que se indique lo contrario  at:1 color:amarillo # perpendicular al eje de tiempo en toda su longitud   at:2 color:orange Layer:back # perpendicular al eje del tiempo en toda su longitud pero tras las rejas    at:4 frompos:50 Untilpos:105 color:green # perpendicular al eje de tiempo, con puntos de inicio y parada especificados     desde:5 hasta:8 atpos: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

Tenga en cuenta que en el ejemplo anterior esas "posiciones absolutas" se trazan 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 fechas de conformidad con el DateFormat especificado.

de: La línea de tiempo comienza aquí. Se puede hacer referencia al valor especificado como inicio en comandos como PlotData y TextData.
hasta: El tiempo termina aquí. Se puede hacer referencia al valor especificado como final en otros comandos.

Ejemplo:

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

PlotArea (obligatorio)

ancho: Especifique el valor en medidas absolutas o relativas. ( ya no lo use , ver más abajo)
altura: Especifique el valor en medidas absolutas o relativas. ( ya no lo use , ver más abajo)
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 sólo se conservan por motivos de compatibilidad con versiones anteriores. Anteriormente, el área de una parcela solo podía definirse por su ancho y alto totales , y 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 alto . 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 Tamaño de imagen).

Ejemplo:

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

Datos de 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 determinado período o fecha/año o que requieren un formato extenso, utilice el comando TextData.

Los atributos texto, en, desde y hasta 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 durante el resto del bloque de comando 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 de texto
Atributo de marcador

Atributos posicionales

en

Especifica en qué fecha/año se debe colocar un texto. Dependiendo del atributo, la alineación del texto comienza, termina o está centrada en esta posición. Utilice el formato de fecha/año como se especifica en DateFormat o especifique el inicio o el final que se refiere al período de tiempo definido por el comando Período.

NB : Este atributo no se puede combinar con atributos de 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 Período.

NB : este atributo debe usarse en combinación con el atributo hasta y no se puede combinar con el atributo en .

hasta

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

NB : este atributo debe usarse en combinación con el atributo de y no puede combinarse con el atributo en .

cambio

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

Textos que se desplazarán para evitar superposiciones.
Colocación de 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 bar:Japón desde:01/09/1939 hasta:27/09/1940 color:verde bar:Japón desde:27/09/1940 hasta:19/02/1945 color:amarillo bar:Japón desde:19/02/1945 hasta:14/03/1945 color:azul barra:Japón desde:09/02/1945 hasta:final color:rojo en: 12/07/1941 turno: (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 que aparecen en cualquier bloque de datos PlotData. La identificación especificada aquí también será el texto presentado a lo largo del eje, al lado de la barra.; Cuando se ha utilizado el comando BarData, las barras se presentarán en el orden especificado allí, además la identificación de la barra especificada aquí se validará con esa lista. Además el texto presentado a lo largo del eje dependerá de la definición en BarData.
bar: Reinicia la visualización de la barra "desde arriba", permitiendo múltiples barras en la misma línea. Sintaxis:barset: nombre
Se pueden agregar líneas en blanco para omitir líneas que no desea agregar con declaraciones comoen: 1234sin más atributos.
color: Especifica el color con el que se debe dibujar la barra.; La identificación del color especificada debe definirse primero con el comando Colores.
ancho: Especifica el ancho de la barra en medidas absolutas o relativas.

Ejemplo:

Datos de barra = barra: texto de EE. UU.: Estados Unidos barra:SB texto:Batallas navalesColores= id:EE.UU. valor:azul leyenda:Estados_Unidos id:SB valor:rgb(0.8,0,0.7) leyenda:Sea_BattlesDatos de trama = ancho: 0,3 # ver nota 1 barra:SB desde:08/07/1942 hasta:02/09/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:final color:EE.UU. # ver nota 4 bar: EE. UU. en: 12/07/1941 texto: 12/7 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 de la barra SB, incluso cuando se especifique después, porque el comando BarData determina la secuencia.
bar Midway será rechazado porque no está declarado con el comando BarData
la última línea no dará como resultado que se trace una barra, simplemente especifica en qué barra se debe colocar el texto

Atributos de texto

texto: Define un texto que debe trazarse en o cerca de una barra. 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 posicionará en el medio del segmento de barra definido. Consulte también Entrada de texto para reglas.; El texto puede incluir enlaces incrustados (consulte las 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. La identificación del color especificada debe definirse primero con el comando Colores. Cuando no se especifique el color se asumirá el negro.
tamaño de fuente (O): Especifique un tamaño en puntos entre 6 y 30, o (preferiblemente) una de las etiquetas XS, S (predeterminada), M, L o XL. Consulte Compatibilidad con fuentes para obtener más detalles.
alinear (O): Especifique centro (predeterminado), izquierda o derecha.
enlace (O): Especifique un enlace web (consulte la Nota 1 ) (URL) para usarlo en mapas en los que se puede hacer clic. El texto se mostrará como un enlace azul en el que se puede hacer clic.

Notas

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

Ejemplo:

Datos de trama = barra: EE. UU. en: 12/07/1941 alineación: izquierda color del texto: negro tamaño de fuente: XS texto: 7/12 [[Pearl Harbour]]

produce el mismo resultado que:

Datos de trama = barra: EE. UU. en: 12/07/1941 alineación: color de texto izquierdo: negro tamaño de fuente: XS texto: "12/7 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. Especificar como marca:(símbolo, color). El único valor de símbolo admitido hasta la fecha es line . La identificación del color especificada debe definirse primero con el comando Colores. Cuando no se especifique el color se asumirá el negro.

Ejemplo:

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

se mostrará como:

EscalaMayor

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

Gráficamente, a través de finas líneas verticales u horizontales en el gráfico.
Textualmente, a través de resguardos en el eje temporal, debajo o a la izquierda del gráfico
Tanto gráfica como textualmente

Nota : la orientación de las líneas y/o la ubicación de los trozos depende de la orientación del TimeAxis.

color de cuadrícula (O): Define el color de las líneas de la cuadrícula. Cuando se omite este atributo, no se dibujarán líneas de cuadrícula.; Nota : La identificación del color especificada 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 de año.
incremento (O): Especifica el número de unidades en las que se incrementa el espaciado de la cuadrícula. El valor predeterminado es 1.
empezar (O): Especifica dónde se debe mostrar la primera línea de cuadrícula y/o el trozo. El valor predeterminado es el inicio del período definido.

Ejemplos:

ScaleMajor = gridcolor:rojo inicio:1940ScaleMajor = color de cuadrícula: unidad roja: incremento de mes: 3 inicio: 09/01/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: unidad roja: incremento de año: 1 inicio: 01/01/1940ScaleMinor = cuadrícula: unidad azul: incremento de mes: 3 inicio: 10/01/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. Consulte también Entrada de texto para conocer las reglas. El texto puede incluir enlaces incrustados (ver Notas 1 y 2 ).

posición

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

enlace (O)

Especifique un enlace web (consulte la Nota 1 ) (URL) para usarlo en mapas en los que se puede hacer clic. La etiqueta a lo largo del eje se mostrará como un enlace azul en el que se puede hacer clic.

color de texto (O)

Define el color del texto. La identificación del color especificada debe definirse primero usando Colores. Cuando no se especifica, el color es negro.

tamaño de fuente (O)

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

pestañas (O)

Define la posición y alineación del carácter de tabulación: ^ (punto de intercalación). Especifique varias configuraciones de pestañas como pestañas: ( 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. Cuando no se especifica, un alto de línea predeterminado se basará en el tamaño de fuente actualmente en uso.

Notas :

Utilice un enlace de atributo o un enlace incrustado en el texto del atributo , no ambos.
En imágenes PNG, solo se mostrará un enlace en el que se puede hacer clic por segmento de texto (el texto con pestañas (^) 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 de tiempo

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

formato (O): Especifique en qué formato se deben presentar las fechas a lo largo del eje de tiempo.; Actualmente solo se admite el formato yyyy (predeterminado). Es posible que sigan más formatos.
orientación (O): Especifique horizontal [izontal] (predeterminado) o vertical [vertical].
orden (o): especificar invertir como la opción para invertir el flujo de tiempo

Ejemplo:

TimeAxis = orientación:formato horizontal:aaaa

Preajustes

Los ajustes preestablecidos son una abreviatura de configuraciones de uso frecuente. Ahorran algunas líneas de código y promueven la estandarización, pero pueden resultar confusos, ya que el guión de la línea de tiempo se vuelve menos autodocumentado.

Por el momento hay dos ajustes preestablecidos disponibles:

Preset = TimeVertical_OneBar_UnitYear , que se expande a

PlotArea = izquierda:45 derecha:10 arriba:10 abajo:10TimeAxis = orientación:formato vertical:aaaaFormato de fecha = aaaa;AlignBars = tempranoEscalaMayor = unidad:añoEscalaMenor = unidad:añoDatos de trama =marca:(línea,blanco) alineación: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: 20PlotArea = izquierda:25 derecha:25 arriba:15 abajo:30TimeAxis = orientación:formato horizontal:aaaaColores =id: valor del lienzo: gris (0,7)id:grid1 valor:gris(0.4)id:grid2 valor:gris(0.2)Colores de fondo = lienzo: lienzoFormato de fecha = aaaa;AlinearBarras = justificarScaleMajor = unidad:año grid:grid1EscalaMenor = unidad:añoLeyenda = orientación:vertical izquierda:35 arriba:130Datos de trama =alinear: ancla izquierda: desde tamaño de fuente: M ancho: 15 mayúsculas: (4,-6) color de texto: negro

Reglas de entrada

Escalas para 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:

PlotArea = ancho:800 alto:600 izquierda:50 abajo: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 medidas horizontales el porcentaje está relacionado con el ancho de la imagen, para medidas verticales con la altura de la imagen.

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

Ejemplo:

PlotArea = ancho:80% alto:80% izquierda:10% abajo:5%

Entrada de texto

La entrada de texto está sujeta a algunas reglas:

1). Sólo 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 con 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:Japanese_mandate_since_1914 bar:MarshallsDatos de barra = texto:"Mandato japonés desde 1914" bar: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:

^ (carácter) significa pestaña

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 en los que se puede hacer clic

Ambos formatos de salida disponibles en MediaWiki, es decir, PNG y SVG, pueden contener enlaces en los que se puede hacer clic. Luego se puede hacer clic en los textos que se muestran en azul y en las barras 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, mediante el atributo text .

Puede especificar un enlace por segmento de texto.

Enlaces incrustados

Los enlaces incrustados son enlaces que son (parte de) texto visualizable, especificado con el atributo text . Su contraparte son 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 del enlace interno es el habitual, el estilo del enlace interwiki no funciona, el estilo del enlace externo es el habitual con corchetes simples, pero aquí con una tubería 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: dar:

El tercero a Meta-Wikipedia funciona correctamente, excepto desde Meta en sí, los otros enlaces funcionan como página principal (página interna, el prefijo se ignora) o, por ejemplo, //en.wikipedia.org/w/Main_Page (da 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 guiones bajos en la URL deben escribirse como %20.

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

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

El signo numérico ( # ) normalmente se interpreta como el inicio del comentario. Cuando un signo numérico es parte de una URL, asegúrese de que el texto esté incluido entre comillas dobles de la siguiente manera:

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

De hecho, puede ser una buena idea poner siempre los textos entre comillas dobles.

Soporte de fuentes

Timeline tiene soporte Unicode algo limitado. Utiliza la fuente FreeSans.ttf, que admite un subconjunto de todos los glifos posibles (admite el alfabeto cirílico, diactrics de Europa del este y kana, por ejemplo, pero carece de kanji). |font=freesanswmfTambién puedes especificar |font=unifontuna fuente diferente, o hacer el renderizado de una manera completamente diferente con |method=svg2png.

Ejemplo:

ImageSize = ancho:180 alto:90 PlotArea = ancho:180 alto:90 izquierda:0 abajo:0 TimeAxis = orientación:vertical #dummy Colores = id:gris valor:gris ( 0.95 ) Colores de fondo = lienzo:gris Período = desde:1 hasta:2 # dummy TextData = pos :( 10 , 90 ) tamaño de fuente:L texto: "维基百科" pos :( 10 , 70 ) tamaño de fuente:L texto: "Zażółć gęślą jaźń" pos :( 10 , 50 ) tamaño de fuente:L texto: "ウィキペディア"

se mostrará como:

Como herencia del uso de fuentes de mapa de bits, sólo están predefinidas cinco etiquetas de fuente. Se renderizará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 Small, S=Small (predeterminado), M=Medium, L=Large, XL=eXtra Large

Esta documentación es originalmente una versión wikificada 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. Como ejemplo:

{{#tag:cronología|Tamaño de la imagen = ancho: 280 alto: 25PlotArea = ancho:280 alto:25 izquierda:0 abajo:0TimeAxis = orientación:vertical # ficticio, requeridoPeriodo = desde:0 hasta:1 # ficticio, requeridoColores = id: valor del lienzo: rgb (1,1,0.85)Colores de fondo = lienzo: lienzoDatos de texto = pos:(10,10) tamaño de fuente:XL texto:"a"}}

se representa como