Ajuda:Sintaxe da linha do tempo

As linhas de tempo permitem criar (garças ao programa EasyTimeline) gráficos de linhas de tempos a partir de uma linguagem de marcação especial.

No texto do gráfico se podem pôr links ao estilo wiki, como por exemplo: [[página]] e [http://www.cia.gov] .

Convém pôr cada linha de tempos numa Predefinição separada, para facilitar sua edição, e para não atrapalhar o resto do artigo ao editar. Além disso, dessa forma se pode reutilizar a linha de tempo comodamente em outros artigos relacionados.

Devido à mudança para UTF-8, deixaram de funcionar todas as linhas de tempos que utilizam acentos, assim como outros carateres não ASCII. Espera-se que seja logo resolvido com a atualização do software. Por enquanto devem usar-se links do estilo de [[I%C3%B3sifStalin]] em lugar de [[IósifStalin]] .

Exemplos

<timeline>
#Todas as longitudes se medem em pixels
ImageSize  = width:160 height:550 #Tamaño de la imagen: ancho, alto 
PlotArea   = width:50 height:530 left:50 bottom:10 #Tamanho do gráfico  dentro da imagem: largura, altura, margem esquerda, margem direita
DateFormat = yyyy #Formato de datas= y-ano, m-mês, d-dia.
Period     = from:1919 till:1991 #Período de tempo representado: desde, até
TimeAxis   = orientation:vertical #Orientação do eixo de tempos: horizontal ou vertical
ScaleMajor = unit:year increment:5 start:1920 #Escala

#Se perceber que se chocam duas frases,  deve-se movê-las
#manualmente  através da variável $dx

Define $dx = 25 # shift text to right side of bar

PlotData=
#barra, color, ancho, ?, alineamiento, tamaño de fuente (XS,S,M,L,XL)
  bar:Líderes color:red width:25 mark:(line,white) align:left fontsize:M
  
 #desde     hasta desplazamiento($dx, píxeles) texto y enlace
 from:start till:1922 shift:($dx,15)  text:Vladímir~Ilich~[[Lenin]]
 from:1922  till:1953 shift:($dx,5)   text:Iósif~[[I%C3%B3sif Stalin|Stalin]]
 from:1953  till:1964 shift:($dx,5)   text:Nikita~[[Nikita Jruschov|Jruschov]]
 from:1964  till:1982 shift:($dx,5)   text:Leonid~[[Leoniz Brezhnev|Brezhnev]]
 from:1982  till:1984 shift:($dx,-12) text:Yuri~[[Yuri Andropov|Andropov]]
 from:1984  till:1985 shift:($dx,4)   text:Konstantin~[[Konstantin_Chernenko|Chernenko]] fontsize:XS
 from:1985  till:end  shift:($dx,10)  text:Mijaíl~[[Mija%C3%ADl Gorbachov|Gorbachov]]
</timeline>

Que queda así:

A seguir vêm três linhas de tempo horizontais

<timeline>
ImageSize  = width:800 height:100
...
  from: start  till: -3800  text:[[Hadean]]
</timeline>
----
<timeline>
ImageSize  = width:800 height:120
...
  from: -360   till:  -325  text:[[Mississippian|Missis-~sippian]] shift:(0,0.5)
</timeline>
-----
<timeline>
ImageSize = width:800 height:120
...
  from:start  till:-55    text:[[Paleocene]]
</timeline>

---

---

Referência

Estrutura

Com código mínimo:

<timeline>
ImageSize  = width:160 height:64
PlotArea   = width:50 height:530 left:50 bottom:10
Period     = from:1919 till:1991
TimeAxis   = orientation:vertical
</timeline>

Comandos disponíveis

• Modelagem: ImageSize, PlotArea, Colors, BackgroundColors, AlignBars
• Interpretação e apresentação de datas e períodos de tempo: DateFormat, Period, ScaleMajor, ScaleMinor, TimeAxis
• Eventos, períodos e textos descritivos: PlotData, TextData
• Ordenar, dividir e nomear grupos de eventos e períodos: BarData, Legend, DrawLines
• Abreviaturas para trechos de código que se repetem: Define

Segundo o manual, são obrigatórios: ImageSize, PlotArea y Period. Além disso, devem estar presentes PlotData ou TextData. Todo o resto é opcional.

Os comandos podem escrever-se em maiúsculas ou em minúsculas, ou misturando maiúsculas e minúsculas que funcionam igualmente.

Sintaxe

Os comentários põem-se assim:

# Isto é um comentário. Qualquer coisa que ponha aqui não afetará o gráfico.

Também é possível haver várias de comentário se colocarmos os símbolos de > e <:

#> Isto é um comentário em várias linhas, 
    para quando queres explicar algo que não  cabe
só numa linha, ou que fica mais bonito em várias linhas, ou quando queres
tirar um bocado de código porque algo não funciona  e não
sabes muito bem o que é.
<#

A estrutura dos comandos é:

Comando [nombre]= atributo1:valor1 atributo2:valor2 atributo3:valor3 ...

Um exemplo:

ImageSize = width:160 height:64

Se podem pôr em várias linhas, deixando ao menos um espaço antes de cada trecho depois do primeiro:

ImageSize  =
 width:160
 height:64

Outro exemplo:

PlotData =
  fontsize:XS width:20
  bar:Japón from:start till:19/02/1945 color:JT
  bar:Japón from:19/02/1945 till:14/03/1945 color:AI

Blocos de dados

Alguns comandos (BarData, PlotData, TextData, Colors...) exigem um bloco de dados, que nada mais é do que uma série de linhas com dados. Cada linha deve começar com ao menos um espaço em branco, já que o bloco se acaba quando aparece uma linha cuja primeira letra não é um espaço em branco (a não ser que seja uma linha em branco).

Um exemplo:

# Este exemplo desenha dois grupos de barras, um em vermelho e outro em azul
# mas uma barra de cada grupo (marcando guerras) estará em verde. 
PlotData =
  color:red fontsize:S                               # cor y tamanho da fonte por padrão
  bar:URRS from:1919 till:1922 text:Lenin            # barra vermelha
  bar:URRS from:1922 till:1953 text:Stalin           # barra vermelha
  bar:URRS from:1939 till:1945 text:2ªGM color:green # barra verde
  bar:URRS from:1953 till:1964 text:Krushchev        # barra vermelha

  color:blue                                         # troca cor por padrão 
  bar:EEUU from:1913 till:1921 text:Wilson             # barra azul
  bar:EEUU from:1917 till:1918 text:1ªGM color:green    # barra verde
  bar:EEUU from:1921 till:1923 text:Harding            # barra azul
  bar:EEUU from:1923 till:1929 text:Coolidge           # barra azul

Caracteres especiais

• ~ (til) no texto (text) significa: mudança de linha.
• ^ (acento circunflexo) no texto (text) significa: tabulador.
• _ (sublinhado) no texto (text) significa: espaço.
• $ (sinal de dólar) indica uma constante de utilizador.

Referência de comandos

Os atributos opcionais se marcam assim : (O).

AlignBars

early (por defecto)

A primeira barra se pinta colada ao eixo, a última deixa um pouco de espaço em branco até o final do gráfico

late

O contrário de early.

justify

A primeira e a última barra se juntam às extremidades, não deixando espaço vazio em nenhum dos dois lados.

BackgroundColors

canvas (O)

Cor de fundo de toda a imagem.

bars (O)

Cor de fundo para todas as barras.

As cores devem definir-se primeiro utilizando: Colors.

Exemplos:

BackgroundColors = bars:darkgrey
BackgroundColors = canvas:lightgrey bars:darkgrey
BackgroundColors = canvas:lightgrey

BarData

Comando opcional, indicado para linhas de tempos muito complexas. Serve para mostrar ou ocultar as barras, ou ordená-las de outra forma diferente.

bar

nome da barra (nao admite espaços em branco, usar "_" quando necessário), utilizado para outros comandos (como PlotData). Será também a etiqueta mostrada para a barra, a menos que se especifique text.

text (O)

texto a mostrar na etiqueta para a barra (ver text input)

link (O)

link (URL). A etiqueta será então um link azul.

Aviso: Se deve usar "text" ou "link", mas nunca ambos.

Exemplo:

BarData =
  bar:Asia
  # Em PlotData podemos especificar que a barra é "Filipinas", mas que o texto mostrado é  "Ilhas Filipinas"
  bar:Filipinas       text:"Ilhas Filipinas"  
  # A etiqueta China aparecerá como um link para o  artigo sobre  a China
  bar:China    text:[[China]]        

Cores

Serve para definir cores.

id

Nome que queremos dar a cor, e que será usado nos outros comandos.

value

Color. Se pode especificar de várias formas:

Constante predefinida (são em 32, todas em inglês

• red, blue...).
• rgb (vermelho, verde, azul): Descrevemos a cor por meio de seus componentes RGB (vermelho, verde e azul), expresados por números entre 0 e 1.
• hsv (hue, saturação, valor): o mismo, mas com valores HSV.
• gray (valor): Tons de cinza entre 0 (negro) e 1 (branco).

legend (O)

Texto que aparecerá na legenda para esta cor.

Exemplo:

Colors =
  id:guerra     value:red   legend:Periodo bélico
  id:paz        value:blue  legend:Tempo de paz
  id:tregua     value:rgb(0.6,0,0.6)
  id:cinzaclaro  value:gray(0.9)
  id:cinzaescuro value:gray(0.1)

---

DateFormat

Formato em que se especificam as datas.

dd/mm/yyyy

Dia/Mês/Ano (só para datas posteriores a 01/01/1800).

mm/dd/yyyy

Mês/Dia/Ano (só para data posteriores a 01/01/1800)

yyyy

Ano (deve ser especificado somente com quatro dígitos, a não ser que se coloque menos "y").

Exemplo:

DateFormat = dd/mm/yyy

nos permitiría usar datas como 28/02/372

Define

Serve para definir abreviaturas ("text constants") para trechos de código que são usados várias vezes. Os nomes das abreviaturas devem começar com um "$".

Exemplo:

Define $estrecho        = width:10
Define $ancho           = width:30
Define $barrapordefecto = $ancho fontsize:S

CONTINUAR A TRADUÇÃO PARA O PORTUGUÊS NAS LINHAS ABAIXO

DrawLines

Pinta líneas a lo largo de la gráfica, para poder separar distintas épocas, o lo que se nos ocurra.

at

Fecha en la que la línea se pintará, en el formato que pusimos con DateFormat.

color

Color de la línea (debe definirse con Colors, como siempre).

Ejemplo:

DrawLines=
  at:start      color:rojo
  at:end        color:rojo
  at:07/12/1941 color:verde

ImageSize

Tamaño de la imagen final, en unidades absolutas (por defecto, píxeles).

width

ancho, como máximo 1600 pixeles.

height

alto, como máximo 1200 pixeles.

Ejemplo:

ImageSize = width:800 height:600

Legend

Leyenda o título de la línea de tiempos.

orientation (O)

Orientación del texto: horizontal (hor), vertical (ver) (que es el valor por defecto). No podemos tener "orientation = 'horizontal'" y "position = 'right'" a la vez.

position (O)

posición respecto a la zona de la gráfica. Puede ser top (encima), bottom (debajo, por defecto), o right (a la derecha).

columns (O)

Número de columnas: 1, 2, 3 o 4.

Para perfeccionistas:

columnwidth (O)

distancia entre columnas. La distancia puede se absoluta (píxeles) o relativa (porcentaje del gráfico). Este valor se ignora si hemos puesto "columns = 1".

left (O)

margen izquierdo, puede ser una distancia absoluta o relativa.

top (O)

margen superior, puede ser una distancia absoluta o relativa.

Ejemplos:

Legend = orientation:vertical position:bottom columns:3 columnwidth:140
Legend = orientation:horizontal position:bottom
Legend = left:100 top:120 columns:3

Period

Periodo de tiempo que cubre la línea de tiempos. Los dos parámetros son obligatorios, y deben cumplir el formato especificado por DateFormat.

from

Fecha inicial, que será el valor que tome "start" en comandos como PlotData y TextData.

till

Fecha final, que será el valor de "end".

Ejemplo:

Period = from:01/09/1939 till:02/09/1945

PlotArea

Zona en la que irá realmente la gráfica. Todo puede estar en unidades absolutas (píxeles) o relativas (porcentaje).

width

ancho.

height

alto.

left

margen izquierdo.

bottom

margen inferior.

Ejemplos:

PlotArea = width:640 height:420 left:160 bottom:120
PlotArea = width:80% height:70% left:20% bottom:20%

PlotData

Define las barras (cada una de las cuales simboliza un periodo de tiempo), y pone un texto junto a ellas.

Para textos que no están relacionados con ningún período o fecha, o que requieren un formato especial, usa mejor TextData.

Los atributos text, at, from y till se aplican sólo a la barra en cuya línea aparecen. Los demás, si aparecen aparte, serán los valores por defecto en el resto del bloque de comandos, o hasta que se den otros.

Atributos de posición

at

Fecha en la que se pone el texto. Según el valor de align, el texto empezará, terminará o estará centrado en esa fecha. Se le puede dar también los valores start o end. Incompatible con from o till.

from

Fecha en la que empieza una barra. Se permite start. Se utiliza combinado con till.

till

Fecha en la que acaba una barra. Se permite end. Usar combinado con from.

shift

Desplazamiento del texto en unidades absolutas (píxeles), para poder moverlo y que no "choque" con otras cosas.

Ejemplo:

PlotData=
  bar:Japan from:start      till:19/02/1945 color:JT
  bar:Japan from:19/02/1945 till:14/03/1945 color:AI
  bar:Japan from:02/09/1945 till:end        color:AO

  at:07/12/1941 shift:(0,-15) text:"<-- WW2 reaches Asia"

Atributos de las barras

bar

Nombre de la barra que se describe en esa línea. Las barras se dibujan en el orden en el que aparecen en los bloques de PlotData, a menos que se haya usado BarData.

color

Color de la barra, que debe haberse definido con Colors.

width

Anchura de la barra en unidades absolutas o relativas.

Ejemplo:

BarData=
  bar:EEUU text:Estados Unidos
  bar:BM text:Batallas_marinas

Colors=
  id:EEUU value:blue legend:Estados_Unidos
  id:BM value:rgb(0.8,0,0.7) legend:Batallas_marinas

PlotData=
  #Ancho por defecto de las barras
  width=0.3 
  #Esta barra va a tener un texto:
  bar:BM     from:07/08/1942 till:09/02/1943 text:Guadalcanal color:BM 
  #EEUU aparecerá antes que BM, aunque aquí vaya después, obligado por BarData:
  bar:EEUU   from:start      till:end color:EEUU 
  #Midway no se dibujará, porque no viene en BarData:    
  bar:Midway from:start      till:end color:EEUU
  #Esto no es una barra, es una línea de texto para un hecho puntual
  bar:EEUU   at:07/12/1941   text:7/12 Pearl Harbour

Atributos de texto

text

El propio texto a mostrar en la barra. Puede incluir enlaces. Véase Texto.

textcolor (O)

Color del texto, que debe definirse antes con Colors. Por defecto, es negro.

fontsize (O)

Tamaño de la fuente. Puede valer (de menor a mayor) XS, S, M, L, o XL ; o venir en puntos (entre 6 y 30). Véase Fuentes de letra.

align (O)

Alineamiento del texto: center (centrado, por defecto), left (a izquierda) o right (a la derecha).

link (O)

Enlace, se pintará en azul. No es compatible con enlaces en el atributo text.

Sólo se mostrará un enlace por línea de texto (así que, si pones cambios de línea "~", ya podrás poner más)

Ejemplo:

PlotData=
   bar:EEUU at:07/12/1941 align:left textcolor:black fontsize:XS text:7/12 [[Pearl Harbour]]

Nos da lo mismo que:

PlotData=
   bar:EEUU at:07/12/1941 align:left textcolor:black fontsize:XS text:"7/12 Pearl Harbour" link:http://es.wikipedia.org/wiki/Pearl_Harbour

Atributo marca

mark

(tipo, color) : marca (línea) que se va a poner en la barra.

Por ahora, el único tipo de marca posible es una línea. El color, como siempre, debe definirse antes con Colors, o será negro.

Ejemplo:

PlotData=
  bar:prueba width:15 color:red
  from:1900 till:2000
  at:1990 mark:(line,white)

Queda así

ScaleMajor

Indica la "escala mayor", es decir, las rayas "grandes" del eje de tiempos, que llevan la fecha escrita.

gridcolor (O)

Color de las líneas de la rejilla. Si no se pone, no hay rejilla. Defínelo primero con Colors.

unit (O)

Unidad de tiempo de la escala: day (día), month (mes) o year (año). Si se ha puesto DateFormat yyyy, sólo pueden ser años.

increment (O)

Tiempo entre raya y raya. Por defecto, vale 1.

start (O)

Cuándo empiezan las rayas. Por defecto, start.

Ejemplos:

ScaleMajor = gridcolor:red start:1940
ScaleMajor = gridcolor:red unit:month increment:3 start:01/09/1939

ScaleMinor

Rayas pequeñas de la escala de tiempos. Funciona igual que ScaleMajor.

Ejemplo:

ScaleMajor = grid:red  unit:year  increment:1 start:01/01/1940
ScaleMinor = grid:blue unit:month increment:3 start:01/10/1939

TextData

Párrafo de texto, que se puede poner en cualquier parte de la gráfica.

text

El texto a mostrar, puede tener enlaces. Véase Texto.

pos

(x,y) : Coordenadas de la esquina superior izquierda del párrafo, en unidades absolutas o relativas.

link (O)

Enlace web (URL) de #mapas clicables, que se mostrará en azul. Es incompatible con enlaces en text.

textcolor (O)

Color del texto, que debe definirse antes con Colors, o será negro.

fontsize (O)

Tamaño de la fuente de letra. Puede valer XS, S, M, L o XL; o ser en puntos (entre 6 y 30). Véase Fuentes de letra.

tabs (O)

Defines position and alignment for tab character: ^ (caret). Specify multiple tab settings as tabs: (x¹-a¹,x²-a²,x³-a³, etc..) where

• xⁿ is the horizontal displacement in absolute measurements from the left side of the text
• aⁿ is the alignment for the text segment (specify center, left or right)

lineheight (O)

Interlineado en píxeles, como máximo 40.

Ejemplo:

TextData =
  pos:(20,67) textcolor:black fontsize:S
  tabs:(10-right,14-left,50-left,90-left,230-left)
  text:^1^1940^27/9^Alemania, Italia y Japón firman el [[Pacto Tripartito]]
  text:^10^1944^1-22/7^En Bretton Woods 44 países fundan
  text:^^^^^el FMI y el Banco Mundial

Se verá así:

TimeAxis

Eje de tiempos.

format (O)

Formato con el que se presentan las fechas en el eje. Por ahora, sólo puede ser yyyy, que es el valor por defecto. Así que este atributo, hoy por hoy, es inútil.

orientation (O)

Puede ser horizontal (hor, por defecto) o vertical (ver).

Ejemplo:

TimeAxis = orientation:horizontal format:yyyy

Valores posibles

Longitudes

Las unidades absolutas se miden siempre en píxeles. Se escriben simplemente poniendo el número.

Ejemplo:

PlotArea = width:800 height:600 left:50 bottom:50

Las unidades relativas se miden siempre en porcentajes del ancho o alto de la imagen. Se escriben poniendo un número y el símbolo "%".

Ejemplo:

PlotArea = width:80% height:80% left:10% bottom:5%

Texto

El texto no puede ser Unicode, lo que hace que algunos caracteres se pinten mal. Véase Fuentes de letra.

Los espacios sólo se pueden poner si se pone el texto entre comillas ("texto"). También se puede poner el texto sin comillas, y poner "_" donde se quieran los espacios, o colocar el texto al final de la línea.

Ejemplos (todos dan el mismo resultado):

BarData =
  text:Bajo_dominio_japonés_desde_1914 bar:Marshalls
BarData =
  text:"Bajo dominio japonés desde 1914" bar:Marshalls
BarData =
  bar:Marshalls text:Bajo dominio japonés desde 1914

En párrafos creados con TextData, hay dos caracteres especiales:

~ (tilde) señala un cambio de línea.

^ (caret) indica un tabulador.

Ejemplo:

TextData =
  .. text:Generado por Wikinotícias~Version 1.1 - 2 de enero de 2004

# quedará así:
#
#  Generado por Wikinotícias
#  Version 1.1 - 2 de enero de 2004

TextData =
  tabs:(4-right,12-right,14-left,34-left)
  text:^1^1940^27/9^Berlin Ger,It,Jap firman el Pacto Tripartito
  text:^10^1944^1-22/7^En Bretton Woods 44 países fundan el
  text:^^^^^FMI y el Banco Mundial

# quedará así:
#
#      1    27/9 Berlin Ger,It,Jap firman el Pacto Tripartito
#     10  1-22/7 En Bretton Woods 44 países fundan el
#                                    FMI y el Banco Mundial

Mapas clicables

En Wikinotícias, las líneas de tiempo pueden aparecer en dos formatos: PNG y SVG. En ambos podemos usar enlaces, que serán barras o textos en azul

Los enlaces pueden aparecer en los comandos BarData, PlotData o TextData, ya sea en el atributo link, o como parte de text.

Enlaces en texto

Son los enlaces que aparecen como parte de un texto (text). Se hacen igual que en cualquier otra parte de Wikinotícias: [[artículo]], pudiendo ponerse incluso enlaces a otras Wikinotíciass, indicando su prefijo. También se puede especificar una URL: [http://www.microsoft.com|monopolio]

Ejemplos

  text:1642 [[Rembrandt]] pinta un cuadro

Queda así:

  text:1642 [[Rembrandt|Rembrandt van Rijn]] pinta un cuadro

Queda así:

  text:1642 [http://es.wikipedia.org/wiki/Rembrandt|Rembrandt van Rijn] pinta un cuadro

Queda así:

Ahora, uno a la Wikinotícias en inglés:

  text:1642 [[en:Rembrandt|Rembrandt van Rijn]] pinta un cuadro

Queda así:

Los dos últimos enlaces van a distintas Wikinotíciass. Además, el texto que aparece al pasar el ratón sobre el enlace cambia.

Fuentes de letra

El tamaño de la letra se especifica con el atributo fontsize, con valores (de menor a mayor): XS, S, M, L, XL. (Parece que aún hay algún problema con la Ñ, y algunos otros caracteres):

Enlaces relacionados

En inglés:

• Manual oficial de EasyTimeline
• Manual de EasyTimeline en Meta
• Todas las líneas de tiempos de esta wikipedia