Lineas de tiempo para la contextopedia

Easytimeline es una herramienta añadida a mediawiki que permite crear lineas de tiempo interactivas. Al ser programadas (no diseñadas gráficamente) permiten modificarlas de una forma muy rápida y sencilla, aunque eso sí, cada linea de tiempo bien hecha conlleva bastante trabajo.
A mi entender ni las referencias para la instalación ni de utilización están nada claras y por eso he escrito esta mini guía.

Instalando la extensión

Los pasos para la instalación se encuentran en la web oficial de la extensión, lo que sigue es una traducción a mi manera porque considero que a veces no queda muy claro cada paso.

Primero necesitamos instalar el programa Ploticus. Hay que bajarlo de la web y ponerlo en el directorio /usr/local/bin , si no tienes acceso a ese directorio ponlo en cualquier otro y especifícalo en la configuración.

A continuación descargamos dos scripts de php/perl uno es EasyTimeline.pl el otro Timeline.php (atención: no descargues directamente, visita los enlaces pues son repositorios de versiones!). El programa en sí es el pl, pero el php es la extensión para mediawiki que utiliza al otro programa.

Renombra Timeline.php a EasyTimeline.php y muevelo al directorio wiki/extensions/
Mueve el fichero EasyTimeline.pl al directorio wiki/extensions/timeline
Crea un directorio para las imágenes con los permisos adecuados
mkdir wiki/images/timeline
chmod 777 wiki/images/timeline

Y añade esto en el fichero de configuración LocalSettings.php
# Add support for EasyTimeline extension
include('extensions/EasyTimeline.php');
$wgTimelineSettings->ploticusCommand = "/usr/local/bin/pl";
$wgTimelineSettings->perlCommand = "/usr/local/bin/perl";

Aquí es donde tienes que fijar correctamente las rutas a todos los programas, si no tienes claro dónde está cada cosa puedes buscarla con el comando whois: $whois perl

Diseñando lineas de tiempo

Este es un esqueleto básico para crear una linea de tiempo. Hay que encerrarlo entre las etiquetas timeline.

#Configuración imagen
ImageSize = width:250 height:600
PlotArea = left:60 bottom:20 top:10 right:10

#Configuración del tiempo
TimeAxis = orientation:vertical
DateFormat = yyyy
Period = from:1982 till:2012
ScaleMajor = unit:year increment:4 start:1982 #gridcolor:black
ScaleMinor = unit:year increment:1 start:1982
Colors =
id:verdoso value:rgb(0.7,1,0.7) # otro color
id:fondo value:rgb(1,1,0.7)

#BackgroundColors = canvas:fondo

Define $dx = 25 #desplazar el texto

PlotData=
bar:GOBIERNO fontsize:S width:30 #set defaults

from:2008 till:2012 shift:($dx) text:”?” color:verdoso
from:2004 till:2008 shift:($dx) text:”[http://www.lamiradapositiva.es | Rodriguez Zapatero]” color:red
from:1996 till:2004 shift:($dx) text:”[http://aznar2000.pp.es | Jose Maria Aznar]” color:blue
from:1982 till:1996 shift:($dx) text:”[[Felipe Gonzalez]]” color:red

Trasteando toda la tarde con otras lineas de tiempo se aprende que hay muchas formas de hacer las cosas. Lo siguiente son unas referencias rápidas de cuestiones que me ha costado un rato entender, parto de que hacemos una linea de tiempo horizontal.

• Las lineas obligatorias que siempre han de incluirse son: ImageSize, Period y PlotArea
  . Si hay alguna dificultad es en la diferencia entre ImageSize y PlotArea, la primera es como su nombre indica el tamaño total de la imagen resultante, la segunda define un margen de impresión extra para la linea de tiempo, una posible configuración es darle 10 pixeles arriba, 10 a la derecha, 20 abajo y 60 a la izquierda.
  PlotArea = left:60 bottom:20 top:10 right:10
• En el comando PlotData se puede incluir una opción (width) que define el grueso de cada columna:
  PlotData=
align:left color:epoch fontsize:S width:40 #set defaults

  Si lo hacemos así tendremos que establecer la dimensión de la imagen teniendo en cuenta el ancho de cada columna sumado a los márgenes de arriba y abajo.
  Si tuviesemos 3 columnas de width:40 y hemos definido PlotArea = left:60 bottom:20 top:10 right:10 tendremos que definir el tamaño total como: 40(width)*3(columnas)=120 + 20 (bottom) + 10 (top) = 150
ImageSize = width:1000 height:150

• La configuración del tiempo se puede establecer con las siguientes lineas que definen en orden: el eje horizontal, el formato de la fecha en años de cuatro dígitos, el periodo que abarca la linea de tiempo y dos escalas graduadas (una mayor y otra menor).
  TimeAxis = orientation:horizontal
DateFormat = yyyy
Period = from:1923 till:2008
ScaleMajor = unit:year increment:20 start:1923 gridcolor:white
ScaleMinor = unit:year increment:5 start:1923
  Además hemos añadido la opción gridcolor:white a la escala mayor para que muestre una rejilla
• Se puede añadir marcas en las barras at:1982mark:(line,white)
• También podemos definir colores para usarlos posteriormente
  Colors =
id:epoch value:rgb(0.7,0.7,1) legend:Batallas_marinas # light yellow
id:age value:rgb(0.7,1,0.7) # light green
id:era value:rgb(1,1,0.7) # light blue
id:eon value:rgb(1,0.7,1) # light purple
id:black value:black
id:white value:gray(0.9)

Actualización
Acabo de encontrar una página donde se referencian todas las lineas de tiempo y sus códigos de la wikipedia en español.