Ajuda:Sintaxe da linha do tempo

Fonte: Wikinotícias

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]] .


<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í:

Mija%C3%ADl GorbachovKonstantin ChernenkoYuri AndropovLeoniz BrezhnevNikita JruschovI%C3%B3sif StalinLenin

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>
HadeanArchaeanPaleoproterozoicMesoproterozoic

Proterozoic

PrecambrianPhanerozoic

CambrianOrdovicianSilurianDevonianCarboniferousPermianTriassicJurassicCretaceousTertiaryPaleozoicMesozoicCenozoicPhanerozoic

PaleoceneEoceneOligoceneMiocene

PleistoceenPaleogeneNeogeneTertiary

Cenozoic


Estrutura[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

  • ~ (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[editar | editar código-fonte]

Os atributos opcionais se marcam assim : (O).

AlignBars[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]
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[editar | editar código-fonte]
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[editar | editar código-fonte]
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[editar | editar código-fonte]
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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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: (x1-a1,x2-a2,x3-a3, etc..) where
  • xn is the horizontal displacement in absolute measurements from the left side of the text
  • an 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í:

Pacto Tripartito

TimeAxis[editar | editar código-fonte]

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[editar | editar código-fonte]

Longitudes[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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[editar | editar código-fonte]

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í:

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

Queda así:

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

Queda así:

es.wikipedia.org/..

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[editar | editar código-fonte]

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[editar | editar código-fonte]

En inglés: