# Manual wiki/Edición/Líneas de tiempo

Debido a lo completo del artículo en Wikipedia está copiado de Ayuda:Líneas de tiempo
Las líneas de tiempo permiten crear (gracias al programa w:EasyTimeline) gráficas de líneas de tiempos a partir de un w:lenguaje de marcado especial.
En el texto de la gráfica se pueden poner además enlaces al estilo wiki, [[enlace]], [http://www.cia.gov], como siempre.
En Meta piden que se enlace cualquier línea de tiempos desde esta página, para comprobar si falla en caso de hacer un cambio en el software.
En la práctica, conviene poner cada línea de tiempos en un Template aparte, para facilitar su edición, y que no estorbe al editar el resto del artículo. Además, así se puede reutilizar cómodamente en otros artículos relacionados.

## Ejemplos

Que queda así:
A continuación vienen tres líneas de tiempo horizontales

## Referencia
### Estructura

Con el código mínimo:

### Órdenes disponibles

* Maquetación: ImageSize, PlotArea, Colors, BackgroundColors, AlignBars
* Interpretación y presentación de fechas y períodos de tiempo: DateFormat, Period, ScaleMajor, ScaleMinor, TimeAxis
* Eventos, períodos y textos descriptivos: PlotData, TextData
* Ordenar, dividir y dar nombre a grupos de eventos y períodos: BarData, Legend, DrawLines
* Abreviaturas para trozos de código que se repiten: Define
Según el manual, son obligatorios: ImageSize, PlotArea y Period. Además, deben estar PlotData o TextData. Todo lo demás es opcional.
Las órdenes pueden escribirse en mayúsculas o en minúsculas, o mezclando mayúsculas y minúsculas; funcionan igualmente.

### Sintaxis

Los comentarios (cosas que ponemos para aclararnos los seres humanos, y que las máquinas ignoran) se ponen así:
También se pueden hacer de varias líneas, pero poniendo signos de > y <:
La estructura de las órdenes es es:
Un ejemplo:
Se pueden poner en varias líneas, dejando al menos un espacio antes de cada trozo tras el primero:
Otro ejemplo:

#### Bloques de datos

Algunas órdenes (BarData, PlotData, TextData, Colors...) piden un bloque de datos, que no es más que una serie de líneas con datos. Cada línea debe empezar con al menos un espacio, ya que el bloque se acaba cuando aparece una línea cuya primera letra no es un espacio (a menos que sea una línea en blanco).
Un ejemplo:

#### Caracteres especiales

* ~ (tilde) en texto (text) significa: cambio de línea.
* ^ (acento diacrítico ??) en texto (text) significa: tabulador.
* _ (subrayado o guión bajo) en texto (text) significa: espacio.
* $ (signo del dólar) indica una constante de usuario.

### Referencia de órdenes

Los atributos opcionales se marcan así: (O).

#### AlignBars
##### early (por defecto)

    La primera barra se pinta pegada al eje, la última deja algo de espacio hasta el final del gráfico.

##### late

    Lo contrario de early.

##### justify

    La primera y la última barras se pegan a los extremos, no dejando espacio vacío en ninguno de los dos lados.

#### BackgroundColors
##### canvas (O)

    Color de fondo de toda la imagen.

##### bars (O)

    Color de fondo para todas las barras.
Los colores deben definirse primero utilizando Colors.
Ejemplos:

#### BarData

Orden opcional, indicado para líneas de tiempos muy complejas. Sirve para mostrar u ocultar las barras, u ordenarlas de otra forma distinta.

##### bar

    nombre de la barra (no admite espacios, usar "_" cuando se necesiten), utilizado para otras órdenes (como PlotData). También será la etiqueta mostrada para la barra, a menos que se especifique text.

##### text (O)

    texto a mostrar en la etiqueta para la barra (ver text input)

##### link (O)

    enlace (URL). La etiqueta será entonces un enlace azul.
Aviso: Se debe usar "text" o "link", pero nunca ambos.
Ejemplo:

#### Colors

Sirve para definir colores.

##### id

    Nombre que queremos dar al color, y que nos pedirán otras órdenes.

##### value

    Color. Se puede especificar de varias formas:
   * Constante predefinida (hay 32, todas en inglés: red, blue...).
   * rgb (rojo, verde, azul): Describimos el color por medio de sus componentes RGB (roja, verde y azul), expresadas por números entre 0 y 1.
   * hsv (hue, saturación, valor): lo mismo, pero con valores HSV.
   * gray (valor): Tono de gris entre 0 (negro) y 1 (blanco).

##### legend (O)

    Texto que se mostrará en la leyenda para este color.
Ejemplo:

#### DateFormat

Formato en el que se especifican las fechas.

##### dd/mm/yyyy

    Día/Mes/Año (sólo para fechas posteriores a 01/01/1800).

##### mm/dd/yyyy

    Mes/Día/Año (sólo para fechas posteriores a 01/01/1800)

##### yyyy

    Año (así deben especificarse 4 cifras, si tiene menos, rellenar con ceros a la izquierda, o poner menos "y"es).
Ejemplo:
nos permitiría usar fechas como 28/02/372

#### Define

Sirve para definir abreviaturas ("text constants") para trozos de código que se usen varias veces. Los nombres de las abreviaturas deben empezar con un "$".
Ejemplo:

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

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

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

#### 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 órdenes como PlotData y TextData.

##### till

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

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

#### 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 órdenes, 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:

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

##### 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:
Nos da lo mismo que:

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

#### ScaleMinor

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

#### 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$^1$-a$^1$,x$^2$-a$^2$,x$^3$-a$^3$, etc..) where
   * x$^n$ is the horizontal displacement in absolute measurements from the left side of the text
   * a$^n$ is the alignment for the text segment (specify center, left or right)

##### lineheight (O)

    Interlineado en píxeles, como máximo 40.
Ejemplo:
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:

### Valores posibles
#### Longitudes

Las unidades absolutas se miden siempre en w:píxeles. Se escriben simplemente poniendo el número.
Ejemplo:
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:

#### Texto

El texto no puede ser w: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):
En párrafos creados con TextData, hay dos caracteres especiales:
    ~ (tilde) señala un cambio de línea.
    ^ (caret) indica un tabulador.
Ejemplo:

### Mapas clicables

En Wikipedia, 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 las órdenes 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 Wikipedia: [[artículo]], pudiendo ponerse incluso enlaces a otras Wikipedias, indicando su prefijo. También se puede especificar una URL: [http://www.microsoft.com|monopolio]
Ejemplos
Queda así:
Queda así:
Queda así:
Ahora, uno a la Wikipedia en inglés:
Queda así:
Los dos últimos enlaces van a distintas Wikipedias. 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 Ñ):

## Enlaces relacionados

En inglés:
* Manual oficial de EasyTimeline
* Manual de EasyTimeline en Meta
* Todas las líneas de tiempos de esta wikipedia
wikipedia:Help:EasyTimeline syntax w:eu:Wikipedia:Denbora lerroak

## Enlaces interesantes

Ayuda:Líneas de tiempo