Ajuda:Crear una línia de temps

Les línies de temps permeten crear gràfiques de línies de temps a partir d'un llenguatge de marcat especial.

Informació original a Wikimedia:

En el text de la gràfica es poden posar a més enllaços a l'estil wiki, [[enllaç]], [http://www.cia.gov], com sempre.

En Meta demanen que s'enllaci qualsevol línia de temps des d'aquesta pàgina, per comprovar si falla en cas de fer un canvi en el programari.

A la pràctica, convé posar cada línia de temps en una plantilla a part, per facilitar la seva edició, i que no destorbi en editar la resta de l'article. A més, així es pot reutilitzar còmodament en altres articles relacionats.

Exemples

Totes las longituds es mesuren en píxeles

ImageSize = width:160 height:550 #Grandaria de la imatgen: ancho, alto PlotArea = width:50 height:530 left:50 bottom:10 #Mida de la gràfica en sí dintre de la imatge: ample, alt, marge esquerra, marge dret DateFormat = yyyy #Format de dates= y-xifra de l'any, m-xifra del mes, d-xifra del dia. Period = from:1919 till:1991 #Període de temps representat: des de, fins a TimeAxis = orientation:vertical #Orientació de l'eix de temps: horitzontal o vertical ScaleMajor = unit:year increment:5 start:1920 #Escala

No es dóna compte quan xoquen dues frases, així que s'han
de moure a má amb la variable $dx

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

PlotData=

barra, color, ample, ?, alineament, mida de la font (XS,S,M,L,XL)

bar:Líders color:red width:25 mark:(line,white) align:left fontsize:M

des de fins a desplaçament($dx, píxeles) texte i enllaç

from:start till:1922 shift:($dx,15)  text:Vladímir~Ilich~Lenin
from:1922  till:1953 shift:($dx,5)   text:Iósif~Stalin
from:1953  till:1964 shift:($dx,5)   text:Nikita~Jruschov
from:1964  till:1982 shift:($dx,5)   text:Leonid~Brezhnev
from:1982  till:1984 shift:($dx,-12) text:Yuri~Andropov
from:1984  till:1985 shift:($dx,4)   text:Konstantin~Chernenko fontsize:XS
from:1985  till:end  shift:($dx,10)  text:Mijaíl~Gorbachov

</timeline> </source> Que queda així: <timeline>

Totes las longituds es mesuren en píxels

ImageSize = width:160 height:550 #Grandaria de la imatgen: ancho, alto PlotArea = width:50 height:530 left:50 bottom:10 #Mida de la gràfica en sí dintre de la imatge: ample, alt, marge esquerra, marge dret DateFormat = yyyy #Format de dates= y-xifra de l'any, m-xifra del mes, d-xifra del dia. Period = from:1919 till:1991 #Període de temps representat: des de, fins a TimeAxis = orientation:vertical #Orientació de l'eix de temps: horitzontal o vertical ScaleMajor = unit:year increment:5 start:1920 #Escala

No es dóna compte quan xoquen dues frases, així que s'han
de moure a má amb la variable $dx

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

PlotData=

barra, color, ample, ?, alineament, mida de la font (XS,S,M,L,XL)

bar:Líders color:red width:25 mark:(line,white) align:left fontsize:M

des de fins a desplaçament($dx, píxeles) texte i enllaç

from:start till:1922 shift:($dx,15)  text:Vladímir~Ilich~Lenin
from:1922  till:1953 shift:($dx,5)   text:Iósif~Stalin
from:1953  till:1964 shift:($dx,5)   text:Nikita~Jruschov
from:1964  till:1982 shift:($dx,5)   text:Leonid~Brezhnev
from:1982  till:1984 shift:($dx,-12) text:Yuri~Andropov
from:1984  till:1985 shift:($dx,4)   text:Konstantin~Chernenko fontsize:XS
from:1985  till:end  shift:($dx,10)  text:Mijaíl~Gorbachov

</timeline>

Un exemple amb tres línies de temps horitzontals

<source lang="php"> <timeline> ImageSize = width:800 height:100 ...

 from: start  till: -3800  text:Hadean

</timeline>

<timeline> ImageSize = width:800 height:120 ... from: -360 till: -325 text:Missis-~sippian shift:(0,0.5) </timeline>

<timeline> ImageSize = width:800 height:120 ... from: -1.6 till: 0 text:Qua~ter~nary fontsize:6 align:left shift:(-7,5) </timeline> </source> <timeline> ImageSize = width:800 height:120 PlotArea = left:65 right:15 bottom:20 top:5 AlignBars = justify

Colors =

 id:neogene   value:rgb(1,0.902,0.1)
 id:paleogene value:rgb(1,0.7019,0)
 id:cretaceous   value:rgb(0.5,0.764,0.1098)
 id:jurassic      value:rgb(0.302,0.706,0.5) 
 id:triassic    value:rgb(0.403,0.765,0.716) 
 id:permian   value:rgb(0.941,0.251,0.157) 
 id:carboniferous     value:rgb(0.6,0.741,0.855)
 id:devonian  value:rgb(0.6,0.6,0.788)
 id:silurian  value:rgb(0.694,0.447,0.714)
 id:ordovician      value:rgb(0.976,0.506,0.651)
 id:cambrian  value:rgb(0.984,0.5,0.373)
 id:neoproterozoic    value:rgb(0.792,0.647,0.583)
 id:mesoproterozoic    value:rgb(0.867,0.761,0.533)
 id:paleoproterozoic    value:rgb(0.702,0.698,0.369)
 id:eoarchean    value:rgb(0.5,0.565,0.565)   
 id:paleoarchean    value:rgb(0.6,0.592,0.569)   
 id:mesoarchean    value:rgb(0.698,0.65,0.6)   
 id:neoarchean    value:rgb(0.796,0.804,0.784)   
 id:ediacaran     value:rgb(0.918,0.847,0.737)   
 id:cryogenian    value:rgb(0.863,0.671,0.667)
 id:tonian        value:rgb(0.796,0.643,0.424)  
 id:stratherian   value:rgb(1,1,0.8)   # light yellow
 id:calymmian     value:rgb(1,1,0.8)   # light yellow
 id:orosirian     value:rgb(1,1,0.8)   # light yellow
 id:rhyacian      value:rgb(1,1,0.8)   # light yellow
 id:siderian     value:rgb(1,1,0.8)   # light yellow
 id:ectasian      value:rgb(1,1,0.8)   # light yellow
 id:stenian      value:rgb(1,1,0.8)   # light yellow
 id:cenozoic   value:rgb(1,1,0)
 id:mesozoic   value:rgb(0.5,0.6784,0.3176)
 id:paleozoic  value:rgb(0.5,0.7098,0.835)
 id:phanerozoic value:rgb(0.7019,0.886,0.819)
 id:proterozoic value:rgb(0.8,0.85,0.568)
 id:archean   value:rgb(0.941,0.0156,0.498)
 id:hadean value:rgb(0.682,0.008,0.494)
 id:precambrian value:rgb(0.968,0.263,0.439)
 id:black  value:black
 id:white  value:white

Period = from:-4567.17 till:0 TimeAxis = orientation:horizontal ScaleMajor = unit:year increment:500 start:-4500 ScaleMinor = unit:year increment:100 start:-4500

Define $markred = text:"*" textcolor:red shift:(0,3) fontsize:10

PlotData=

 align:center textcolor:black fontsize:8 mark:(line,black) width:25 shift:(0,-5)

bar:supereò

 from: start till: -542 text:Precambrià color:precambrian

 bar:eò

 at:      0   align:right  $markred
 at:   -542   align:left   $markred shift:(2,3)
 from: -542   till:    0   text:Fanerozoic  color:phanerozoic   
 from:-2500   till: -542   text:Proterozoic  color:proterozoic   
 from:-3800   till: -2500 text:Arqueà      color:archean   
 from: start  till: -3800  text:Hadeà       color:hadean

 bar:era

 from:  -65.5 till:    0   text:C~z shift:(0,1.5)        color:cenozoic        
 from: -251   till:  -65.5 text:Meso~zoic shift:(0,1.5)  color:mesozoic        
 from: -542   till: -251 text:Paleo~zoic shift:(0,1.5)  color:paleozoic 
 from: -1000  till:  -542  text:Neoprote-~rozoic shift:(0,1.8) color:neoproterozoic   
 from:-1600   till:  -1000  text:Mesoproterozoic color:mesoproterozoic  
 from:-2500   till: -1600  text:Paleoproterozoic color:paleoproterozoic 
 from:-2800   till: -2500 text:Neo-~arqueà shift:(0,1.5)     color:neoarchean       
 from:-3200   till: -2800    text:Meso-~arqueà shift:(0,1.5)   color:mesoarchean      
 from:-3600   till: -3200   text:Paleo-~arqueà shift:(0,1.5) color:paleoarchean     
 from:-3800   till: -3600    text:Eoar-~queà shift:(0,0.5) color:eoarchean fontsize:6       
 from:start   till: -3800  color:white

 bar:període

 fontsize:6
 from:   -23.03 till:    0    color:neogene
 from:  -65.5 till:   -23.03  color:paleogene
 from: -145.5   till:  -65.5  color:cretaceous
 from: -199.6   till: -145.5  color:jurassic
 from: -251   till: -199.6    color:triassic
 from: -299   till: -251      color:permian
 from: -359.2   till: -299    color:carboniferous
 from: -416 till: -359.2      color:devonian
 from: -443.7 till: -416      color:silurian
 from: -488.3   till: -443.7  color:ordovician
 from: -542   till: -488.3    color:cambrian

 from: -630   till:  -542  text:Ed. color:ediacaran
 from: -850   till:  -630    text:Crio-~genià color:cryogenian shift:(0,0.5)
 from: -1000  till:  -850 text:Ton-~ià color:tonian shift:(0,0.5)
 from: -1200  till:  -1000 text:Este-~nià color:mesoproterozoic shift:(0,0.5)
 from: -1400  till:  -1200 text:Ect-~asià color:mesoproterozoic shift:(0,0.5)
 from: -1600  till:  -1400   text:Calim-~mià color:mesoproterozoic shift:(0,0.5)
 from: -1800  till:  -1600 text:Estate-~rià color:paleoproterozoic shift:(0,0.5)
 from: -2050  till:  -1800  text:Orosirià color:paleoproterozoic shift:(0,0.5)
 from: -2300  till:  -2050     text:Riacià color:paleoproterozoic shift:(0,0.5)
 from: -2500  till:  -2300  text:Siderià color:paleoproterozoic shift:(0,0.5)
 from: start  till:  -2500 color:white

</timeline>

<timeline> ImageSize = width:800 height:100 PlotArea = left:65 right:15 bottom:20 top:5 AlignBars = justify

Colors =

 id:quaternary value:rgb(0.976,0.976,0.498)
 id:neogene   value:rgb(1,0.902,0.1)
 id:paleogene value:rgb(1,0.7019,0)
 id:cretaceous   value:rgb(0.5,0.764,0.1098)
 id:jurassic      value:rgb(0.302,0.706,0.5) 
 id:triassic    value:rgb(0.403,0.765,0.716) 
 id:permian   value:rgb(0.941,0.251,0.157) 
 id:carboniferous     value:rgb(0.6,0.741,0.855)
 id:devonian  value:rgb(0.6,0.6,0.788)
 id:silurian  value:rgb(0.694,0.447,0.714)
 id:ordovician      value:rgb(0.976,0.506,0.651)
 id:cambrian  value:rgb(0.984,0.5,0.373)
 id:cenozoic   value:rgb(1,1,0)
 id:mesozoic   value:rgb(0.5,0.6784,0.3176)
 id:paleozoic  value:rgb(0.5,0.7098,0.835)
 id:phanerozoic value:rgb(0.7019,0.886,0.819)
 id:black  value:black
 id:white  value:white
 id:darkgreen value:rgb(0,0.35,0)

Period = from:-542 till:0 TimeAxis = orientation:horizontal ScaleMajor = unit:year increment:100 start:-500 ScaleMinor = unit:year increment:10 start:-540

Define $markred = text:"*" textcolor:red shift:(0,3) fontsize:10 Define $markgreen = text:"*" textcolor:darkgreen shift:(0,3) fontsize:10

PlotData=

 align:center textcolor:black fontsize:8 mark:(line,black) width:25 shift:(0,-5)

 bar:eò
 at:      0   align:right  $markred 
 at:   -542   align:left   $markred shift:(2,3)
 from: -542   till:    0   text:Fanerozoic color:phanerozoic

 bar:era
 at:      0   align:right  $markgreen
 at:    -65.5 align:left   $markgreen shift:(2,3)
 from:  -65.5 till:    0   text:Cenozoic color:cenozoic
 from: -251   till:  -65.5 text:Mesozoic color:mesozoic
 from: -542   till: -251   text:Paleozoic color:paleozoic

bar:període fontsize:8

 from: -23.03    till:  0 text:Neo-~gen shift:(0,0.5) color:neogene
 from: -65.5  till:  -23.03     text:Paleo-~gen shift:(0,0.5) color:paleogene
 from: -145.5   till:  -65.5 text:Cretaci color:cretaceous
 from: -199.6   till: -145.5   text:Juràssic color:jurassic
 from: -251.4   till: -199.6   text:Triàsic    color:triassic
 from: -299   till: -251.4   text:Permià      color:permian
 from: -359.2   till: -299   text:Carbonifer color:carboniferous
 from: -416 till: -359.2   text:Devonià        color:devonian
 from: -443.7 till: -416   text:Sil-~urià shift:(0,0.5) color:silurian
 from: -488.3   till: -443.7 text:Ordovicià color:ordovician
 from: -542   till: -488.3   text:Cambrià   color:cambrian

</timeline>

<timeline> ImageSize = width:800 height:100 PlotArea = left:65 right:15 bottom:20 top:5 AlignBars = justify

Colors =

 id:quaternary value:rgb(0.976,0.976,0.498)
 id:neogene   value:rgb(1,0.902,0.1)
 id:paleogene value:rgb(1,0.7019,0)
 id:cenozoic   value:rgb(1,1,0)
 id:holocene   value:rgb(1,1,0.702)
 id:pleistocene  value:rgb(1,0.922,0.384)
 id:pliocene     value:rgb(1,0.922,0.675)
 id:miocene      value:rgb(1,0.871,0)
 id:oligocene    value:rgb(0.918,0.776,0.447)
 id:eocene       value:rgb(0.918,0.678,0.263)
 id:paleocene    value:rgb(0.92,0.576,0.005)
 id:black  value:black
 id:white  value:white
 id:darkgreen value:rgb(0,0.35,0)

Period = from:-65.5 till:0 TimeAxis = orientation:horizontal ScaleMajor = unit:year increment:10 start:-60 ScaleMinor = unit:year increment:1 start:-65

Define $markgreen = text:"*" textcolor:darkgreen shift:(0,3) fontsize:10

PlotData=

 align:center textcolor:black fontsize:8 mark:(line,black) width:25 shift:(0,-5)

 bar:era
 at:     0  align:right $markgreen 
 at: start  align:left  $markgreen shift:(2,3)
 from:start  till:  0    text:Cenozoic color:cenozoic

 bar:període 
 from: -2.588   till:  0      text:Q color:quaternary
 from: -23.03   till:  -2.588    text:Neogen color:neogene
 from:start  till: -23.03     text:Paleogen color:paleogene

 bar:època
 from: -0.1  till:  0  color:holocene
 from: -1.80  till: -0.1 text:P color:pleistocene
 from: -5.332    till: -1.80  text:Plio-~cè shift:(0,1) color:pliocene fontsize:7
 from:-23.03    till: -5.332 text:Miocè color:miocene
 from:-33.9    till:-23.03    text:Oligocè color:oligocene
 from:-55.8    till:-33.9    text:Eocè     color:eocene
 from:start  till:-55.8 text:Paleocè    color:paleocene

</timeline>

Referència

Estructura

Amb el codi mínim: <source lang="php"> <timeline> ImageSize = width:200 height:40 PlotArea = width:100 height:30 left:50 bottom:10 Period = from:1900 till:1930 TimeAxis = orientation:horizontal PlotData=

 bar:prueba width:20 color:red
 from:1900 till:1920

</timeline> </source>

<timeline> ImageSize = width:200 height:40 PlotArea = width:100 height:30 left:50 bottom:10 Period = from:1900 till:1930 TimeAxis = orientation:horizontal PlotData=

 bar:prueba width:20 color:red  from:1900 till:1920

</timeline>

Ordres disponibles

Maquetació: ImageSize, PlotArea, Colors, BackgroundColors, AlignBars
Interpretació i presentació de dates i períodes de temps: DateFormat, Period, ScaleMajor, ScaleMinor, TimeAxis
Esdeveniments, períodes i texts descriptius: PlotData, TextData
Ordenar, dividir i donar nom a grups d'esdeveniments i a períodes: BarData, Legend, DrawLines
Abreviatures per a trossos de codi que es repeteixen: Define

Segons el manual, són obligatoris: ImageSize, PlotArea i Period. A més, han de ser-hi PlotData o TextData. Totes les altres ordres són opcionals.

Les ordres poden escriure's en majúscules o en minúscules, o barrejant majúscules i minúscules; funcionen igualment.

Sintaxi

Els comentaris (coses que posem per aclarir-nos els éssers humans, i que les màquines ignoren) es posen així:

# Això és un comentari. Qualsevol cosa que posi aquí no afectarà la gràfica.

També es poden fer de diverses línies, però posant signes de > i <:

#>Això és un comentari de diverses línies, per a quan vols explicar
 una cosa que no et cap només en una línia, o et queda més bonic, o vols 
 treure un tros de codi perquè alguna cosa no surt i no saps ben bé per 
 què.
<#

L'estructura de les ordres és és:

Ordre [nombre]= atribut1:valor1 atribut2:valor2 atribut3:valor3...

Un exemple:

ImageSize = width:160 height:64

Es poden posar en diverses línies, deixant almenys un espai abans de cada tros després del primer:

ImageSize = 
 width:160
 height:64

Un altre exemple:

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

Blocs de dades

Algunes ordres (BarData, PlotData, TextData, Colors...) demanen un bloc de dades, que no és més que una sèrie de línies amb dades. Cada línia ha de començar amb almenys un espai, ja què el bloc s'acaba quan apareix una línia la primera lletra del qual no és un espai (llevat que sigui una línia en blanc).

Un exemple:

#Aquest exemple dibuixa dos grups de barres, un en vermell i un altre en blau 
#però una barra de cada grup (marcant guerres) estarà en verd.
PlotData =
  color:red fontsize:S                               # color i mida de font per defecte
  bar:URRS from:1919 till:1922 text:Lenin            # barra vermella
  bar:URRS from:1922 till:1953 text:Stalin           # barra vermella
  bar:URRS from:1939 till:1945 text:2ªGM color:green # barra verda
  bar:URRS from:1953 till:1964 text:Krushchev        # barra vermella

  color:blue                                         # canvi color per defecte
  bar:EEUU from:1913 till:1921 text:Wilson             # barra blava
  bar:EEUU from:1917 till:1918 text:1ªGM color:green   # barra verda
  bar:EEUU from:1921 till:1923 text:Harding            # barra blava
  bar:EEUU from:1923 till:1929 text:Coolidge           # barra blava

Caràcters especials

~ (titlla) en text (text) significa: canvi de línia.
^ (accent diacrític ??) en text (text) significa: tabulador.
_ (subratllada o guió baix) en text (text) significa: espai.
$ (signe del dòlar) indica una constant d'usuari.

Referència d'ordres

Els atributs opcionals es marquen així: (O).

AlignBars

early

late

justify

<timeline> Colors=

 id:ColEscaMayor value:rgb(0,0,1)
 id:ColEscaMenor value:rgb(0.8,0.8,1)
 id:ColFondo value:rgb(1,0,0)
 id:FondoImagren value:rgb(1,1,1)
 id:ColBarra value:rgb(0,1,0)
 id:FondoBarra value:rgb(1,1,1)

ImageSize = width:170 height:170

PlotArea = left: 40 bottom: 40 top: 20 right: 20

DateFormat = x.y

Period = from:0 till:25

TimeAxis = orientation:vertical AlignBars = early

ScaleMajor = gridcolor:ColEscaMayor increment:5 start:0

ScaleMinor = gridcolor:ColEscaMenor increment:1 start:0

BackgroundColors = canvas:FondoImagren bars:FondoBarra

BarData=

 bar: d text: D
 bar: c text: C
 bar: b text: B
 bar: a text: A

PlotData=

 color:ColBarra width:20 align:center

 bar: d from:18 till: 0
 bar: c from:16 till: 0
 bar: b from:15 till: 0
 bar: a from:10 till: 0

PlotData=

 bar: d at: 18 fontsize:S text: 18 shift:(0,5)
 bar: c at: 16 fontsize:S text: 16 shift:(0,5)
 bar: b at: 15 fontsize:S text: 15 shift:(0,5)
 bar: a at: 10 fontsize:S text: 10 shift:(0,5)

</timeline>

<timeline> Colors=

 id:ColEscaMayor value:rgb(0,0,1)
 id:ColEscaMenor value:rgb(0.8,0.8,1)
 id:ColFondo value:rgb(1,0,0)
 id:FondoImagren value:rgb(1,1,1)
 id:ColBarra value:rgb(0,1,0)
 id:FondoBarra value:rgb(1,1,1)

ImageSize = width:170 height:170

PlotArea = left: 40 bottom: 40 top: 20 right: 20

DateFormat = x.y

Period = from:0 till:25

TimeAxis = orientation:vertical AlignBars = late

ScaleMajor = gridcolor:ColEscaMayor increment:5 start:0

ScaleMinor = gridcolor:ColEscaMenor increment:1 start:0

BackgroundColors = canvas:FondoImagren bars:FondoBarra

BarData=

 bar: d text: D
 bar: c text: C
 bar: b text: B
 bar: a text: A

PlotData=

 color:ColBarra width:20 align:center

 bar: d from:18 till: 0
 bar: c from:16 till: 0
 bar: b from:15 till: 0
 bar: a from:10 till: 0

PlotData=

 bar: d at: 18 fontsize:S text: 18 shift:(0,5)
 bar: c at: 16 fontsize:S text: 16 shift:(0,5)
 bar: b at: 15 fontsize:S text: 15 shift:(0,5)
 bar: a at: 10 fontsize:S text: 10 shift:(0,5)

</timeline>

<timeline> Colors=

 id:ColEscaMayor value:rgb(0,0,1)
 id:ColEscaMenor value:rgb(0.8,0.8,1)
 id:ColFondo value:rgb(1,0,0)
 id:FondoImagren value:rgb(1,1,1)
 id:ColBarra value:rgb(0,1,0)
 id:FondoBarra value:rgb(1,1,1)

ImageSize = width:170 height:170

PlotArea = left: 40 bottom: 40 top: 20 right: 20

DateFormat = x.y

Period = from:0 till:25

TimeAxis = orientation:vertical AlignBars = justify

ScaleMajor = gridcolor:ColEscaMayor increment:5 start:0

ScaleMinor = gridcolor:ColEscaMenor increment:1 start:0

BackgroundColors = canvas:FondoImagren bars:FondoBarra

BarData=

 bar: d text: D
 bar: c text: C
 bar: b text: B
 bar: a text: A

PlotData=

 color:ColBarra width:20 align:center

 bar: d from:18 till: 0
 bar: c from:16 till: 0
 bar: b from:15 till: 0
 bar: a from:10 till: 0

PlotData=

 bar: d at: 18 fontsize:S text: 18 shift:(0,5)
 bar: c at: 16 fontsize:S text: 16 shift:(0,5)
 bar: b at: 15 fontsize:S text: 15 shift:(0,5)
 bar: a at: 10 fontsize:S text: 10 shift:(0,5)

</timeline>

<timeline> Colors=

 id:ColEscaMayor value:rgb(0,0,1)
 id:ColEscaMenor value:rgb(0.8,0.8,1)
 id:ColFondo value:rgb(1,0,0)
 id:FondoImagren value:rgb(1,1,1)
 id:ColBarra value:rgb(0,1,0)
 id:FondoBarra value:rgb(1,1,1)

ImageSize = width:170 height:170

PlotArea = left: 40 bottom: 40 top: 20 right: 20

DateFormat = x.y

Period = from:0 till:25

TimeAxis = orientation:horizontal AlignBars = early

ScaleMajor = gridcolor:ColEscaMayor increment:5 start:0

ScaleMinor = gridcolor:ColEscaMenor increment:1 start:0

BackgroundColors = canvas:FondoImagren bars:FondoBarra

BarData=

 bar: d text: D
 bar: c text: C
 bar: b text: B
 bar: a text: A

PlotData=

 color:ColBarra width:20 align:center

 bar: d from:18 till: 0
 bar: c from:16 till: 0
 bar: b from:15 till: 0
 bar: a from:10 till: 0

PlotData=

 bar: d at: 18 fontsize:S text: 18 shift:(8,0)
 bar: c at: 16 fontsize:S text: 16 shift:(8,0)
 bar: b at: 15 fontsize:S text: 15 shift:(8,0)
 bar: a at: 10 fontsize:S text: 10 shift:(8,0)

</timeline>

<timeline> Colors=

 id:ColEscaMayor value:rgb(0,0,1)
 id:ColEscaMenor value:rgb(0.8,0.8,1)
 id:ColFondo value:rgb(1,0,0)
 id:FondoImagren value:rgb(1,1,1)
 id:ColBarra value:rgb(0,1,0)
 id:FondoBarra value:rgb(1,1,1)

ImageSize = width:170 height:170

PlotArea = left: 40 bottom: 40 top: 20 right: 20

DateFormat = x.y

Period = from:0 till:25

TimeAxis = orientation:horizontal AlignBars = late

ScaleMajor = gridcolor:ColEscaMayor increment:5 start:0

ScaleMinor = gridcolor:ColEscaMenor increment:1 start:0

BackgroundColors = canvas:FondoImagren bars:FondoBarra

BarData=

 bar: d text: D
 bar: c text: C
 bar: b text: B
 bar: a text: A

PlotData=

 color:ColBarra width:20 align:center

 bar: d from:18 till: 0
 bar: c from:16 till: 0
 bar: b from:15 till: 0
 bar: a from:10 till: 0

PlotData=

 bar: d at: 18 fontsize:S text: 18 shift:(8,0)
 bar: c at: 16 fontsize:S text: 16 shift:(8,0)
 bar: b at: 15 fontsize:S text: 15 shift:(8,0)
 bar: a at: 10 fontsize:S text: 10 shift:(8,0)

</timeline>

<timeline> Colors=

 id:ColEscaMayor value:rgb(0,0,1)
 id:ColEscaMenor value:rgb(0.8,0.8,1)
 id:ColFondo value:rgb(1,0,0)
 id:FondoImagren value:rgb(1,1,1)
 id:ColBarra value:rgb(0,1,0)
 id:FondoBarra value:rgb(1,1,1)

ImageSize = width:170 height:170

PlotArea = left: 40 bottom: 40 top: 20 right: 20

DateFormat = x.y

Period = from:0 till:25

TimeAxis = orientation:horizontal AlignBars = justify

ScaleMajor = gridcolor:ColEscaMayor increment:5 start:0

ScaleMinor = gridcolor:ColEscaMenor increment:1 start:0

BackgroundColors = canvas:FondoImagren bars:FondoBarra

BarData=

 bar: d text: D
 bar: c text: C
 bar: b text: B
 bar: a text: A

PlotData=

 color:ColBarra width:20 align:center

 bar: d from:18 till: 0
 bar: c from:16 till: 0
 bar: b from:15 till: 0
 bar: a from:10 till: 0

PlotData=

 bar: d at: 18 fontsize:S text: 18 shift:(8,0)
 bar: c at: 16 fontsize:S text: 16 shift:(8,0)
 bar: b at: 15 fontsize:S text: 15 shift:(8,0)
 bar: a at: 10 fontsize:S text: 10 shift:(8,0)

</timeline>

early (per defecte)

La primera barra es pinta pegada a l'eix, l'última deixa una mica d'espai fins al final del gràfic.

late

El contrari d'early.

justify

La primera i l'última barres es peguen en els extrems, no deixant espai buit en cap dels dos costats.

BackgroundColors

canvas (O)

Color de fons de tota la imatge.

bars (O)

Color de fons per a totes les barres.

Els colors s'han de definir primer utilitzant Colors.

Exemples:

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

BarData

Ordre opcional, indicat per a línies de temps molt complexes. Serveix per mostrar o ocultar les barres, o ordenar-les d'una altra forma diferent.

bar

nom de la barra (no admet espais, usar " _ " quan es necessitin), utilitzat per a altres ordres (com PlotData). També serà l'etiqueta mostrada per a la barra, llevat que s'especifiqui text.

text (O)

text a mostrar a l'etiqueta per a la barra (veure text input)

link (O)

enllaç (URL). L'etiqueta serà llavors un enllaç blau.

Avís: S'ha d'usar "text" o "link", però mai ambdós.

Exemple:

BarData =
  bar:Asia
  # En PlotData podrem posar que la barra són "Les Filipines", però el text mostrat serà "Illes Filipines"
  bar:Filipines       text:"Illes Filipines"  
  # La etiqueta Xina es mostrarà com un enllaç blau a l'article sobre Xina
  bar:Xina    text:[[Xina]]

Colors

Black

Blue

Coral

DarkBlue

Green

Lavender

LimeGreen

Magenta

Orange

Pink

PowderBlue

Purple

Red

SkyBlue

Teal

White

Yellow

Red

Serveix per definir colors.

id

Nom que volem donar al color, i que ens demanaran altres ordres.

value

Definició del color. Es pot especificar de diverses formes:

Constant predefinida (n'hi ha 32, totes en anglès) rgb (vermell, verd, blau): Descrivim el color per mitjà dels seus components RGB (vermella, verda i blava), expressades per números entre 0 i 1. hsv (hue, saturació, valor): el mateix, però amb valors HSV. gray (valor): To de gris entre 0 (negre) i 1 (blanc).

legend (O): Text que es mostrarà en la llegenda per a aquest color.

Exemple:

Colors =
  id:guerra     value:red   legend:Periode bèl·lic
  id:pau        value:blue  legend:Temps de pau
  id:treba     value:rgb(0.6,0,0.6)
  id:grisclar  value:gray(0.9)
  id:grisfosc value:gray(0.1)

DateFormat

Format en el qual s'especifiquen les dates.

dd/mm/yyyy

Dia/mes/Any (només per a dates posteriors a 01/01/1800).

mm/dd/yyyy

Mes/dia/Any (només per a dates posteriors a 01/01/1800)

yyyy

Any permet posar des de -9999 fins a +9999

Exemple:

DateFormat = dd/mm/yyyy

Define

Serveix per definir abreviatures ("text constants") per a fragments de codi que s'usin diverses vegades. Els noms de les abreviatures han de començar amb un " $ ".

Exemple:

Define $estret = width:10
Define $ample  = width:30 
Define $barraperdefecte = $ample fontsize:S

DrawLines

Pinta línies al llarg de la gràfica, per poder separar diferents èpoques, o el que se'ns ocorri.

at

Data en la qual la línia es pintarà, en el format que vam posar amb DateFormat.

color

Color de la línia (s'ha de definir amb Colors, com sempre).

Exemple:

DrawLines=
  at:start      color:vermell
  at:end        color:vermell
  at:07/12/1941 color:verd

ImageSize

Mida de la imatge final, en unitats absolutes (per defecte, píxels).

width

ample, com a màxim 1600 píxels.

height

alt, com a màxim 1200 píxels.

Exemple:

ImageSize = width:800 height:600

Legend

Llegenda o títol de la línia de temps.

orientation (O)

Orientació del text: horitzontal (hor), vertical (ver) (que és el valor per defecte). No podem tenir "orientation = 'horitzontal' " i "position = 'right' " alhora.

position (O)

posició respecte a la zona de la gràfica. Pot ser top (a sobre), bottom (sota, per defecte), o right (a la dreta).

columns (O)

Nombre de columnes: 1, 2, 3 o 4.

Per a perfeccionistes:

columnwidth (O)

distància entre columnes. La distància pot ser absoluta (píxels) o relativa (percentatge del gràfic). Aquest valor s'ignora si hem posat "columns =1".

left (O)

marge esquerre, pot ser una distància absoluta o relativa.

top (O)

marge superior, pot ser una distància absoluta o relativa.

Exemples:

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

Period

Període de temps que cobreix la línia de temps. Els dos paràmetres són obligatoris, i han de complir el format especificat per DateFormat.

from

Data inicial, que serà el valor que prengui "start" en ordres com PlotData i TextData.

till

Data final, que serà el valor d'"end".

Exemple:

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

PlotArea

Zona en la qual anirà realment la gràfica. Tot pot estar en unitats absolutes (píxels) o relatives (percentatge).

width: ample.
height: alt.
left: marge esquerre.
bottom: marge inferior.

Exemples:

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

PlotData

Defineix les barres (cada una de les quals simbolitza un període de temps), i posa un text al costat d'elles.

Per a texts que no estan relacionats amb cap període o data, o que requereixen un format especial, usa millor TextData.

Els atributs text, at, from i till s'apliquen només a la barra en la línia de la qual apareixen. Els altres, si apareixen a part, seran els valors per defecte a la resta del bloc d'ordres, o fins que se'n donin d'altres.

Atributs de posició

at

Data en la qual es posa el text. Segons el valor d'align, el text començarà, acabarà o estarà centrat en aquesta data. Se li pot donar també els valors start o end. Incompatible amb from o till.

from

Data en la qual comença una barra. Es permet start. S'utilitza combinat amb till.

till

Data en la qual acaba una barra. Es permet end. Usar combinat amb from.

shift

Desplaçament del text en unitats absolutes (píxels), per poder moure'l i que no "xoqui" amb altres coses.

Exemple:

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"

Atributs de les barres

bar

Nom de la barra que es descriu en aquesta línia. Les barres es dibuixen en l'ordre en el qual apareixen als blocs de PlotData, llevat que s'hagi usat BarData.

color

Color de la barra, que s'ha d'haver definit amb Colors.

width

Amplada de la barra en unitats absolutes o relatives.

Exemple:

BarData=
  bar:EUA text:Estats Units
  bar:BM text:Batalles_marines

Colors=
  id:EUA value:blue legend:Estats_Units
  id:BM value:rgb(0.8,0,0.7) legend:Batalles_marines

PlotData=
  #Amplada per defecto de les barres
  width=0.3 
  #Aquesta barra tindrà un text
  bar:BM     from:07/08/1942 till:09/02/1943 text:Guadalcanal color:BM 
  #EUA apareixerà abans que BM, encara que aquí vagi després, obligat per BarData:
  bar:EUA   from:start      till:end color:EUA 
  #Midway no es dibuixarà, perquè no ve en BarData:   
  bar:Midway from:start      till:end color:EUA
  #Això no és una barra, és una línia de text per a un fet puntual
  bar:EUA   at:07/12/1941   text:7/12 Pearl Harbour

Atributs de text

text

El propi text a mostrar a la barra. Pot incloure enllaços. Vegi's text.

textcolor (O)

Color del text, que s'ha de definir abans amb Colors. Per defecte, és negre.

fontsize (O)

Mida de la font. Pot valer (de menor a major) XS, S, M, L, o XL ; o venir en punts (entre 6 i 30). Vegi's Fonts de lletra.

align (O)

Alineament del text: center (centrat, per defecte), left (a esquerra) o right (a la dreta).

link (O)

Enllaç, es pintarà en blau. No és compatible amb enllaços en l'atribut text.

Només es mostrarà un enllaç per línia de text (així que, si poses canvis de línia " ~ ", ja en podreu posar més)

Exemple:

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

Ens és igual que:

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

Atribut marca

mark (tipus, color): marca (línia) que es posarà a la barra.

Per ara, l'únic tipus de marca possible és una línia. El color, com sempre, ha de definir-se abans amb Colors, o serà negre.

Exemple: PlotData=

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

Queda així <timeline> ImageSize = width:140 height:60 PlotArea = width:100 height:30 left:20 bottom:30 TimeAxis = orientation:horizontal DateFormat = yyyy Period = from:1900 till:2000 AlignBars = early ScaleMajor = unit:year increment:50 start:1900 Colors =

 id:canvas value:rgb(1,1,0.85)

BackgroundColors = canvas:canvas PlotData=

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

</timeline>

ScaleMajor

Indica l'"escala major", és a dir, les ratlles "grans" de l'eix de temps, que porta la data escrita.

gridcolor (O)

Color de les línies de la reixeta. Si no es posa, no hi ha reixeta. Defineix-ho primer amb Colors.

unit (O)

Unitat de temps de l'escala: day (dia), month (mes) o year (any). Si s'ha posat DateFormat yyyy, només poden ser anys.

increment (O)

Temps entre ratlla i ratlla. Per defecte, val 1.

start (O)

Quan comencen les ratlles. Per defecte, start.

Exemples:

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

ScaleMinor

Ratlles petites de l'escala de temps. Funciona igual que ScaleMajor.

Exemple:

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

TextData

Paràgraf de text, que es pot posar en qualsevol part de la gràfica.

text

El text a mostrar, pot tenir enllaços. Vegi's text.

pos: (x, i) : Coordenades de la cantonada superior esquerra del paràgraf, en unitats absolutes o relatives.
link (O)

Enllaç web (URL) de mapes clicables, que es mostrarà en blau. És incompatible amb enllaços en text.

textcolor (O)

Color del text, que ha de definir-se abans amb Colors, o serà negre.

fontsize (O)

Mida de la font de lletra. Pot valer XS, S, M, L o XL; o ser en punts (entre 6 i 30). Vegi's Fonts de lletra.

tabs (O)

Defineix la posició o l'alineació per al caràcter de tabulació:^ (accent circumflex). Especifica multiples paràmetres de tabulació com tabulacions: (x¹-a¹,x²-a²,x³-a³, etc..) a on

xⁿ és el desplaçament horitzontal en valor absolut mesurat des del costat esquerra del text
aⁿ és l'alineació per al segment de text (especifica center, left o right)

lineheight (O)

Interliniat en píxels, com a màxim 40.

Exemple:

TextData =
  pos:(20,67) textcolor:black fontsize:S
  tabs:(10-right,14-left,50-left,90-left,230-left)
  text:^1^1940^27/9^Alemanya, Itàlia i Japó firmen el [[Pacte Tripartit]] 
  text:^10^1944^1-22/7^A Bretton Woods 44 països funden
  text:^^^^^el FMI i el Banc Mundial

Es veurà així: <timeline> ImageSize = width:400 height:70 PlotArea = width:400 height:70 left:0 bottom:0 TimeAxis = orientation:vertical # dummy, required Period = from:0 till:1 # dummy, required Colors =

 id:canvas value:rgb(1,1,0.85)

BackgroundColors = canvas:canvas TextData =

 pos:(20,67) textcolor:black fontsize:S
 tabs:(10-right,14-left,50-left,90-left,230-left)
 text:^1^1940^27/9^Alemanya, Itàlia i Japó firmen el Pacte Tripartit 
 text:^10^1944^1-22/7^A Bretton Woods 44 països funden
 text:^^^^^el FMI i el Banc Mundial

</timeline>

TimeAxis

Eix de temps.

format (O)

Format amb què es presenten les dates en l'eix. Per ara, només pot ser yyyy, que és el valor per defecte. Així que aquest atribut, ara com ara, és inútil.

orientation (O)

Pot ser horitzontal (hor, per defecte) o vertical (ver).

Exemple:

TimeAxis = orientation:horizontal format:yyyy

Valors possibles

Longituds

Les unitats absolutes es mesuren sempre en píxels. S'escriuen simplement posant el número.

Exemple:

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

Les unitats relatives es mesuren sempre en percentatges de l'ample o alt de la imatge. S'escriuen posant un número i el símbol "%".

Exemple:

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

Text

El text no pot ser Unicode, la qual cosa fa que alguns caràcters s'imprimeixin malament. Vegi's Fonts de lletra.

Els espais només es poden posar si es posa el text entre cometes ("text"). També es pot posar el text sense cometes, i posar " _ " on es vulguin els espais, o col·locar el text al final de la línia.

Exemples (tots donen el mateix resultat):

BarData =
  text:Sota_domini_japonès_des_de_1914 bar:Marshalls
BarData =
  text:"Sota domini japonès des de 1914" bar:Marshalls
BarData =
  bar:Marshalls text:Sota domini japonès des de 1914

En paràgrafs creats amb TextData, hi ha dos caràcters especials:

~ (titlla) assenyala un canvi de línia.

^ (accent circumflex) indica un tabulador.

Exemples:

TextData =
  .. text:Generat per Wikipedia~Versió 1.1 - 2 de gener de 2004

# quedarà així:
#
#  Generat per Viquipèdia
#  Versió 1.1 - 2 de gener de 2004

TextData =
  tabs:(4-right,12-right,14-left,34-left)
  text:^1^1940^27/9^Berlin Ger,It,Jap firmen el Pacte Tripartit
  text:^10^1944^1-22/7^En Bretton Woods 44 països funden el 
  text:^^^^^FMI i el Banc Mundial

# quedará así:
#
#      1    27/9 Berlin Ger,It,Jap firmen el Pacte Tripartit
#     10  1-22/7 En Bretton Woods 44 països funden el
#                                    FMI i el Banc Mundial

Mapes clicables

A Viquipèdia, les línies de temps poden aparèixer en dos formats: PNG i SVG. En ambdós podem usar enllaços, que seran barres o texts en blau

Els enllaços poden aparèixer en les ordres BarData, PlotData o TextData, ja sigui en l'atribut link, o com a part de text.

Enllaços al text

Són els enllaços que apareixen com a part d'un text (text). Es fan igual que en qualsevol altra part de Viquipèdia: [[article]], podent posar-se fins i tot enllaços a altres Viquipèdies, indicant el seu prefix. També es pot especificar una URL: [http://www.microsoft.com|monopolio]

Exemples

  text:1642 [[Rembrandt]] pinta un quadre

Queda així:

<timeline> ImageSize = width:300 height:25 PlotArea = left:0 right:0 bottom:0 top:0 TimeAxis = orientation:vertical # Perquè ens obliga Period = from:0 till:1 # Perquè ens obliga Colors =

 id:canvas value:rgb(1,1,0.85)

BackgroundColors = canvas:canvas TextData =

pos:(10,10) fontsize:s text:"1642 Rembrandt pinta un quadre"

</timeline>

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

Queda així:

<timeline> ImageSize = width:280 height:25 PlotArea = left:0 right:0 bottom:0 top:0 TimeAxis = orientation:vertical # Perquè ens obliga Period = from:0 till:1 # Perquè ens obliga Colors =

 id:canvas value:rgb(1,1,0.85)

BackgroundColors = canvas:canvas TextData =

 pos:(10,10) fontsize:S text:"1642 Rembrandt van Rijn pinta un quadre"

</timeline>

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

Queda així:

<timeline> ImageSize = width:280 height:25 PlotArea = left:0 right:0 bottom:0 top:0 TimeAxis = orientation:vertical # Perquè ens obliga Period = from:0 till:1 # Perquè ens obliga Colors =

 id:canvas value:rgb(1,1,0.85)

BackgroundColors = canvas:canvas TextData =

 pos:(10,10) fontsize:S text:"1642 van Rijn pinta un quadre"

</timeline>

Ara, un a la Wikipedia en anglès:

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

Queda així:

<timeline> ImageSize = width:280 height:25 PlotArea = left:0 right:0 bottom:0 top:0 TimeAxis = orientation:vertical # Perquè ens obliga Period = from:0 till:1 # Perquè ens obliga Colors =

 id:canvas value:rgb(1,1,0.85)

BackgroundColors = canvas:canvas TextData =

 pos:(10,10) fontsize:S text:"1642 Rembrandt van Rijn pinta un quadre"

</timeline>

Els dos últims enllaços van a diferents Wikipedias. A més, el text que apareix en passar el ratolí sobre l'enllaç canvia.

Fonts de lletra

La mida de la lletra s'especifica amb l'atribut fontsize, amb valors (de menor a major): XS, S, M, L, XL: <timeline> ImageSize = width:700 height:380 PlotArea = width:700 height:380 left:0 bottom:0 TimeAxis = orientation:vertical #dummy Colors =

 id:ColorFondo  value:Orange
 id:ColorTexto1 value:Black
 id:ColorTexto2 value:Blue

Backgroundcolors = canvas:ColorFondo Period = from:1 till:2 # dummy TextData =

textcolor:ColorTexto1
pos:(10,360)             text:"Font mida: normal -1234567890 abcdefghijklmnopqrstuwxyz"
pos:(10,330) fontsize:XS text:"Font mida: XS -1234567890 abcdefghijklmnopqrstuwxyz"
pos:(10,300) fontsize:S  text:"Font mida: S  -1234567890 abcdefghijklmnopqrstuwxyz"
pos:(10,270) fontsize:M  text:"Font mida: M  -1234567890 abcdefghijklmnopqrstuwxyz"
pos:(10,240) fontsize:L  text:"Font mida: L  -1234567890 abcdefghijklmnopqrstuwxyz"
pos:(10,210)  fontsize:XL text:"Font mida: XL -1234567890 abcdefghijklmnopqrstuwxyz"

textcolor:ColorTexto2
pos:(10,160)             text:"Font mida: normal -1234567890 abcdefghijklmnopqrstuwxyz"
pos:(10,130) fontsize:XS text:"Font mida: XS -1234567890 abcdefghijklmnopqrstuwxyz"
pos:(10,100) fontsize:S  text:"Font mida: S  -1234567890 abcdefghijklmnopqrstuwxyz"
pos:(10,70)  fontsize:M  text:"Font mida: M  -1234567890 abcdefghijklmnopqrstuwxyz"
pos:(10,40)  fontsize:L  text:"Font mida: L  -1234567890 abcdefghijklmnopqrstuwxyz"
pos:(10,10)  fontsize:XL text:"Font mida: XL -1234567890 abcdefghijklmnopqrstuwxyz"

</timeline>

Enllaços relacionats

En anglès:

de:Hilfe:Zeitleisten en:Help:EasyTimeline syntax es:Ayuda:Líneas_de_tiempo eu:Wikipedia:Denbora lerroak fr:Aide:Frise chronologique