Hilfe:Zeitleisten

Dies ist eine alte Version dieser Seite, zuletzt bearbeitet am 20. Juli 2005 um 19:21 Uhr durch Exxu (Diskussion | Beiträge) (Parameter vs. Data Items: +Korr. "#" als "<nowiki>"). Sie kann sich erheblich von der aktuellen Version unterscheiden.

Diese Dokumentation ist eine wikifizierte Version von der originalen EasyTimeline Dokumentation (engl.) bzw. eine Übersetzung der Meta-Seite meta:MediaWiki User's Guide: EasyTimeline Syntax.

Siehe auch meta:EasyTimeline, meta:EasyTimeline/Index.

Einführung

Graphische Zeitleisten können mithilfe eines Skripts, das zwischen entsprechenden tags eingeschlossen ist, erstellt werden:
<timeline>
skript
</timeline>

Dem Programm EasyTimeline wird dadurch mitgeteilt, eine PNG-Grafik zu rendern, die optional auch klickbare Links enthalten kann.

Disclaimer: Obwohl EasyTimeline für einfache Benutzung entwickelt wurde, ist eine komplexe graphische Zeitleiste eine nicht-triviale Angelegenheit. Eine einfache Zeitleiste benötigt etwa eine halbe Stunde zum Erstellen (oder sogar weniger, wenn man ein brauchbares Beispiel als Vorlage nimmt). Große Zeitleisten brauchen einige Stunden zur Erstellung und für die Feinjustierung. Dafür ist es aber relativ einfach eine existierende zu korrigieren oder zu ergänzen, selbst für Benutzer die sich in die hier beschriebenen Syntax noch nicht eingearbeitet haben.

Für Fragen und Hilfestellung steht der Autor von EasyTimeline zur Verfügung.

Vorhandene Befehle

Die Skriptbefehle definieren:

Nur drei Befehle sind zwingend notwendig: ImageSize, PlotArea und Period. Zumindest eins der folgenden muss vorhanden sein: PlotData und/oder TextData. Eins davon oder beide kann mehrfach auftreten. Alle anderen Befehle sind optional.

Schreibweise: Befehle und deren Attribute können klein, groß oder gemischt geschreiben werden. Bitte versuche für die Lesbarkeit ein konsistentes System zu benutzen, z.B. gemischte Schreibweise für Befehle und Kleinschreibung für Attribute.


Allgemeine Syntax

Ein Skript kann Befehle und Kommentare beinhalten. Jeder Befehl wird von einem oder mehreren Attributen gefolgt.

Befehle

Befehle sollten am Beginn einer Zeile stehen. Einige Befehle können von mehrzeiligen Datenzeilen und/oder Optionen gefolgt werden. Diese Extrazeilen sollten mindestens mit einem Leerschritt oder besser mit einer Leerzeile beginnen. Das dient der Gruppierung und damit der Lesbarkeit des Skpripts.

Befehle haben eine der folgenden, vom Typ abhängigen, Formen:

Befehl = Attribut

DateFormat = dd/mm/yyyy

Befehl Name = Attribut(e)

Color Jp = value:red legend:Japan

Befehl =
  Attribut(e)
  Attribut(e)
  etc.

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

Kommentare

Ein- und mehrzeilige Kommentare können so geschrieben werden:

  • Text nach dem Hash-Zeichen # wird als Kommentar erkannt
  • Text zwischen #> und <# wird ebenso als Kommentar erkannt. Damit sind mehrzeilige Kommentare möglich.

Beispiele:

Dateformat = dd/mm/yyyy # Europäisches Datumsformat

Period = from:01/09/1939 till:02/09/1945 #> Diese Tabelle zeigt die komplette 
                Dauer des 2. Weltkriegs<#

Attribute

Wenn verschiedene Attribute für einen bestimmten Befehl angegeben werden können, so werden sie als 'Name:Wert' Paare übergeben. Wenn mehrere Werte für ein Attribut angegeben werden, so müssen sie eingeklammert werden.

Beispiele:

AlignBars = justify
Color SSch = value:rgb(0.8,0,0.7) legend:See-Schlachten

Parameter vs. Data Items

Die meisten Befehle akzeptieren nur Attribute, die in der selben Zeile stehen.

Datenblöcke: Einige Befehle wie BarData, PlotData, TextData, Colors erwarten einen Datenblock, der aus einer oder mehreren Datenzeilen besteht. Diese müssen mit einem oder mehr Leerzeichen beginnen. Ein Datenblock wird als beendet erkannt, wenn eine Zeile eingelesen wird, die nicht mit einem Leerzeichen beginnt. Ausnahme: Leerzeilen werden ignoriert, damit die Datenblöcke untergliedert werden können.

Attribute in einem Datenblock können eingeteilt werden in Parameter und Datenobjekte. Diese können innerhalb der Datenblöcke vermischt auftreten.

Datenobjekte: In Datenzeilen gelten die Attribute text, from, till und at ausschließlich für die aktuelle Zeile.

Parameter: In Datenzeilen haben Attribute wie color und fontsize je nach Kontext unterschiedliche Auswirkungen. Wenn diese Parameter in einer Zeile ohne Datensatz stehen, dann setzen sie neue Standards für die nachfolgenden Datenzeilen. Wenn sie in einer Zeile zusammen mit Datensätzen stehen, dann gelten sie nur für diese Zeile und überschreiben dabei zuvor gesetzte Standards.

Beispiel:


# In diesem Beispiel werden zwei Säulengruppen gezeichnet, in rot bzw. blau,
# aber in jeder Gruppe wird eine Säule (Krieg darstellend) in grün dargestellt.

PlotData =
  color:red fontsize:S                               # Standards setzen
  bar:USSR from:1919 till:1922 text:Lenin            # rote Säule
  bar:USSR from:1922 till:1953 text:Stalin           # rote Säule
  bar:USSR from:1939 till:1945 text:WWII color:green # grüne Säule
  bar:USSR from:1953 till:1964 text:Krushchev        # rote Säule
   
  color:blue                                         # Standardfarbe ändern
  bar:US from:1913 till:1921 text:Wilson             # blaue Säule
  bar:US from:1917 till:1918 text:WWI color:green    # grüne Säule
  bar:US from:1921 till:1923 text:Harding            # blaue Säule

 #> Dieser mehrzeilige Kommentar beendet keineswegs den PlotData-Block,
   auch wenn die vorherige Zeile nicht mit einem Leerzeichen beginnt<#

   bar:US from:1923 till:1929 text:Coolidge           # blaue Säule

TextData =                                           # JETZT ist der PlotData-Block abgeschlossen
   tabs:...etc

Spezielle Zeichen

  • #, #>, <# (Hash, Hash+"größer als", "kleiner als"+Hash): siehe Kommentare
  • ~ (Tilde) im Text bedeutet: Zeilenumbruch
  • ^ (Karet) im Text bedeutet: Tabulator
  • _ (Unterstrich) im Text bedeutet: Leerzeichen
  • $ (Dollarzeichen) leitet eine benutzerdefinierte Konstante ein

Befehlsreferenz

Für jeden Befehl werden die gültigen Attribute aufgezählt. Einiege Befehle und / oder Attribute dürfen fehlen ((o)ptional).

Für einige Befehle schließen sich bestimmte Atrribute gegenseitig aus. Dies wird an entsprechender Stelle erwähnt.

AlignBars

Die Balken (Bars) werden immer in gleichen Abständen gezeichnet. Dieser Befehl gibt an, ob die Balken mit größtmöglichem Abstand oder mit ...

or some white space should be reserved between the left/top side of the chart and the first bar or between the last bar and the right/bottom side of the chart.

early (default)
Der erste Balken wird an linkester/oberster Position der Grafik ( 'glued' to the axis) dargestellt, dann wird der Raum zwischen letztem Balken und rechtem/unterem Rand automatisch bestimmt.
late
Gegenteil von early: der letzte Balken wird möglichs dicht an den rechten/unteren Rand platziert, dann kann eine Zwischenraum zwischen der Achse und erstem Balken erscheinen.
justify
Der erste und letzte Balken wird möglichst weit auseinander platzier. kein Zwischenraum an den Rändern. Wenn nur ein Balken vorhanden ist wird 'justify' als 'zentriert' interpretiert.

Beispiel:

TimeAxis = orientation:horizontal TimeAxis = orientation:vertical
Alignbars =

Hintergrundfarben

Der Befehl "BackgroundColors" erlaubt die Angabe einer Farbe für verschiedene Bereiche der Grafik.

Any color ids specified should be defined first using Colors.

canvas (O)
Specify a background color for the whole image.
bars (O)
Specify a background color for all bars.

Beispiele:

BackgroundColors = bars:darkgrey

BackgroundColors = canvas:lightgrey bars:darkgrey

BackgroundColors = canvas:lightgrey

BarData

This is an optional command which if present determines which bars will be drawn on the chart and in which order. If it is omitted then bars will be drawn in order of their appearance in command PlotData.

For complex timelines with many bars, usage of this command is recommended:

  • It will ease reordering of the displayed data.
  • Bar names specified in PlotData can be validated against this list, thus preventing typing errors.
bar
defines the bar id. Other commands (notably PlotData) will expect this id for reference. This will also be the label to be shown along the axis, unless attribute text is present. The bar id should not contain any spaces: use underscores instead, these will be converted to spaces, as wih article titles.
text (O)
When specified this specifies the text to be presented along the axis, instead of the bar id. See also rules for text input. The text may include one embedded link (see Note 1).
link (O)
Specify a web link (see Note 1) (URL). The label along the axis will be shown as a blue clickable link.

Notes

  1. Either use attribute link, or an embedded link in attribute text, not both.

Examples:

BarData =
  bar:Japan
  bar:US       text:"United States"  # refer in PlotData to bar "US" but show "United States"
  bar:China    text:[[China]]        # label China will be shown as blue clickable link to the Wikipedia article about China

The following lines produce the same output (only reference in PlotData changes):

bar:US            text:[[United_States]]

bar:US            text:"United States" link:http://www.wikipedia.org/wiki/United_States

bar:United_States                      link:http://www.wikipedia.org/wiki/United_States

Colors

This command allows colors to be defined and coupled to an id (identification tag). Other commands will refer to colors with the id specified here. This command expects one or more color definitions, each on a separate indented line.

id
Other commands will use this id to specify text, bar or background colors.
value
Actual color definition. Color values can be either be specified as:
  • predefined color constant, for which 32 predefined color names are recognized (see the Ploticus color page (here) where all these constants are defined).
  • rgb (red,green,blue): specify 3 numbers between 0 (minimal) and 1 (maximal)
  • hsv (hue, saturation, value): specify 3 numbers between 0 and 1
  • gray (value): specify a number between 0 (black) and 1 (white)
legend (O)
Specifies the text that should be displayed in the legend for this color. If this attribute is omitted no entry will appear in the legend at all. See Text Input for rules.

Example:

Colors =
  id:war       value:red   legend:War Period
  id:peace     value:blue  legend:Peace Time
  id:treaty    value:rgb(0.6,0,0.6)
  id:lightgrey value:gray(0.9)
  id:darkgrey  value:gray(0.1)

DateFormat

Dieser Befehl definiert, wie Daten, die durch andere Befehle spezifiziert werden, interpretiert werden.

Erlaubte Formate sind:

dd/mm/yyyy
Daten werden als Tag/Monat/Jahr interpretiert
Bemerkung: Dieses Format ist nur für Daten ab 01/01/1800 erlaubt
mm/dd/yyyy
Daten werden als Monat/Tag/Jahr interpretiert
Bemerkung: Dieses Format ist nur für Daten ab 01/01/1800 erlaubt
yyyy
Hiermit sind Angaben zwischen -9999 und +9999 möglich

Beispiel:

DateFormat = mm/dd/yyyy

Define

Dieser Befehl ermöglicht das Definieren von Textkonstanten, d.h. Kurzformen für Skriptcode der mehrfach verwendet wird. Textkonstanten müssen immer mit einem $ (Dollarzeichen) beginnen.

Beispiel:

Define $broad       = width:30
Define $narrow      = width:10
Define $bardefaults = $broad fontsize:S

LineData

Einige Zeitleisten überspannen mehrere klar abgegrenzte Perioden. Zur Darstellung der Grenze kann eine Trennlinie in den Balken eingefügt werden.

Solche Linien werden als Querlinien in den Balken gezeichnet und gehen über die komplette Breite.

at
Angabe des Datums mit Berücksichtigung des Formats (DateFormat).
color
Angabe der Farbe der Linie.
Bemerkung: Die Farb-Id sollte vorher mit dem Colors-Befehl vergeben sein.

Beispiel:

LineData=
  at:start      color:rot
  at:end        color:rot
  at:07/12/1941 color:rot

ImageSize

Dieser Befehl definiert die Gesamtgröße der resultierenden Grafik.

Angabe in Absolutwerten.

width
Breite der Grafik, Maximum sind 1600 Pixel
height
Höhe der Grafik, Maximum sind 1200 Pixel

Beispiel:

ImageSize = width:800 height:600

Legend

Eine Legende wird nur angezeigt wenn dieser Befehl vorhanden ist. Es gibt verschiedene Möglichkeiten, die Darstellung und Position der Legende zu beeinflussen. Einige der Attribute schließen sich gegenseitig aus (siehe unten).

orientation (O)
Die Lage der Balken: hor[izontal] oder ver[tical] (voreingestellt).
Einschränkung: orientation = 'horizontal' und position = 'right' schließen sich gegenseitig aus
position (O)
Definiert die Platzierung der Legende relativ zur chart area. Angabe: top, bottom (default) oder right.
Einschränkung: orientation = 'horizontal' und position = 'right' schließen sich gegenseitig aus
columns (O)
Anzahl der Spalten 1, 2, 3 or 4. Wenn dieses Attribut fehlt wird die Anzahl der Spalten folgendermaßen ermittelt:
  • bei Orientierung horizontal : Attribut 'columns' ist nicht erlaubt, alle Einträge erscheinen in einer Zeile.
  • bei Orientierung vertical :
    • Position right : Alle Einträge kommen in eine Spalte
    • Position top oder bottom : Die Anzahl der Spalten hängt von der Anzahl der Einträge ab:
      1-5 Einträge: 1 Spalte, 6-10 Einträge: 2 Spalten, 11 oder mehr Einträge: 3 Spalten.

Tipp: Anfang folgende Parameter weglassen und erst wenn das Ergebnis nicht zufriedenstellt benutzen.


columnwidth (O)
Definiert den Abstand zwischen Spalten. Angaben in absolutenrEntfernung oder ein relativer Abstand (in Prozent der Grafikbreite).
Einschränkung: dieses Parameter wird ignoriert wenn die Spaltenanzahl 1 ist.
left (O)
Definiert die Distanz zwischen der linken Seite der Legende und dem linken Rand der Grafik. (absolut oder relativ).
top (O)
Definiert die Distanz zwischen oberem Rand der Legend und dem unteren Rand der Grafik. (absolut oder relativ).

Beispiele:

Legend = orientation:vertical position:bottom columns:3 columnwidth:140

Legend = orientation:horizontal position:bottom

Legend = left:100 top:120 columns:3

Period

Definiert das Zeitintervall, das in der Grafik dargestellt wird. Beide Parameter sind erforderlich. Angabe in Übereinstimmung mit dem DateFormat.

from
Beginn der Zeitleiste.
till
Endzeitpunkt der Grafik.

Diese Werte werden an die Konstanten 'start' bzw. 'end' übergeben, auf die bei Befehlen wie PlotData und TextData zurückgegriffen werden kann.

Beispiel:

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

PlotArea

width
Specify value in absolute or relative measurements.
height
Specify value in absolute or relative measurements.
left
Margin between left side of image and left side of plot area. Specify value in absolute or relative measurements.
bottom
Margin between bottom of image and bottom of plot area. Specify value in absolute or relative measurements.

Examples:

PlotArea = width:640 height:420 left:160 bottom:120

PlotArea = width:80% height:70% left:20% bottom:20%

PlotData

Used to define bars (symbolizing a time period), and add text next to these bars on a specific position.

For texts which are not related to a certain period or date/year or which require extensive formatting use command TextData.

Attributes text, at, from and till always apply only to the line on which they occur. All other attributes, when not combined with one these four, act as default for the remainder of the command block or until a new default is specified, and may be overruled for a single line. See Parameters vs Data Items for more info and an example.

PlotData accepts a lot of attributes, some of which are mutually exclusive. These attributes can be grouped as follows:

  • Positional attributes
  • Bar related attributes
  • Text attributes
  • Marker attribute

Positional attributes

at
Specifies at which date/year a text should be positioned. Depending on attribute align the text either starts, ends or is centered at this position. Use date/year format as specified in DateFormat or specify start or end which refers to time frame defined by command Period.
NB: This attribute can not be combined with attributes from or till.
from
Specifies at which date/year a bar should start. Use date/year format as specified in DateFormat or specify start which refers to time frame defined by command Period.
NB: This attribute should be used in combination with attribute till and can not be combined with attribute at.
till
Specifies at which date/year a bar should end. Use date/year format as specified in DateFormat or specify end which refers to time frame defined by command Period.
NB: This attribute should be used in combination with attribute from and can not be combined with attribute at.
shift
Specifies a horizontal and vertical displacement in absolute measurements for a text. This allows:
  • Texts to be shifted to avoid overlaps
  • Placement of text beside a bar, instead of on top of it.

Examples:

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"
bar
Specifies to which bar all other attributes apply.
When command BarData has not been used, bars will be drawn in the order in which they occur in any PlotData data block. The id specified here will also be the text presented along the axis, next to the bar.
When command BarData has been used, bars will presented in the order specified there, also the bar id specified here will be validated against that list. Also the text presented along the axis will depend on the definition in BarData.
color
Specifies the color is which the bar should be drawn.
The color id specified should be defined first with command Colors.
width
Specifies the width of the bar in absolute or relative measurements.

Example:

BarData=
  id:US text:United States
  id:SB text:Sea Battles

Colors=
  id:US value:blue legend:United_States
  id:SB value:rgb(0.8,0,0.7) legend:Sea_Battles

PlotData=
  width=0.3                                                            # see note 1
  bar:SB     from:07/08/1942 till:09/02/1943 text:Guadalcanal color:SB # see note 2
  bar:US     from:start      till:end color:US                         # see note 3
  bar:Midway from:start      till:end color:US                         # see note 4
  bar:US     at:07/12/1941   text:7/12 Pearl Harbor                    # see note 5

Notes:

  1. this line establishes a default bar width for the remainder of the data block
  2. this line specifies a bar to be drawn and a text to placed on it at the same time
  3. bar US will be drawn before bar SB, even when specified after it, because command BarData determines the sequence
  4. bar Midway will be rejected because it is not declared with command BarData
  5. the last line will not result in a bar being plotted, it merely specifies on which bar the text should be placed

Text attributes

text
Defines a text that should be plotted on or near a bar. The anchor position can be defined either explicitly with attribute at, or implicitly with attributes from and till. In the latter case the text will be positioned in the middle of the defined bar segment. See also Text Input for rules
The text may include embedded links (see Notes 1 & 2) for use in clickable maps.
textcolor (O)
Defines the color of the text. The color id specified should be defined first with command Colors. When not specified color black will be assumed.
fontsize (O)
Specify a point size between 6 and 30, or (preferably) one of tags XS, S (default), M, L or XL. See Font Support for more details.
align (O)
Specify center (default), left or right.
link (O)
Specify a web link (see Note 1) (URL) for use in clickable maps. The text will be shown as a blue clickable link.

Notes

  1. Either use attribute link, or an embedded link in attribute text, not both.
  2. On PNG images only one clickable link will be shown per text segment (text with line breaks (~) constitutes several segments).

Example:

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

produces the same result as:

PlotData=
   bar:US at:07/12/1941 align:left textcolor:black fontsize:XS text:"7/12 Pearl Harbor" link:http://www.wikipedia.org/wiki/Pearl_Harbor

Marker attribute

mark
Places a marker in a bar at the specified position. Specify as mark:(symbol, color). The only value for symbol supported to date is line. The color id specified should be defined first with command Colors. When not specified color black will be assumed.

Example:

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

will be shown as:


ScaleMajor

This command divides the timeline into smaller periods, either

  • Graphically, through thin vertical or horizontal lines in the chart
  • Textually, through stubs in the time axis, below or to the left of the chart
  • Both graphically and textually

Note: the orientation of the lines and/or placement of the stubs depends on the orientation of the TimeAxis.

gridcolor (O)
Defines the color for the grid lines. When this attribute is omitted no grid lines will be drawn.
Note: The color id specified should be defined first with command Colors.
unit (O)
Specifies the unit by which the grid spacing is incremented. Specify day, month or year (default).
Note: When DateFormat yyyy is specified, only unit year is allowed.
increment (O)
Specifies the numbers of units by which the grid spacing is incremented. Default is 1.
start (O)
Specifies where the first grid line and/or stub should be displayed. Defaults to start of defined Period.

Examples:

ScaleMajor = gridcolor:red start:1940

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

ScaleMinor

This command defines a further subdivision of the timescale. See ScaleMajor for syntax .

Example:

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

TextData

Used to define a text block that can be positioned anywhere on the chart.

text
The actual text. See also Text Input for rules. The text may include embedded links (see Notes 1 & 2).
pos
Defines the top-left corner of the text block in absolute or relative measurements. Define as pos:(x,y).
link (O)
Specify a web link (see Note 1) (URL) for use in clickable maps. The label along the axis will be shown as a blue clickable link.
textcolor (O)
Defines the color of the text. The color id specified should be defined first using Colors. When not specified, the color black will be assumed.
fontsize (O)
Specify a point size between 6 and 30, or (preferably) one of tags XS, S (default), M, L or XL (see Font Support for more details).
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)
Defines spacing between consecutive lines in absolute measurements. Specify a value up to 40 pixels or 0.4in. When not specified a default lineheight will be based on the font size currently in use.

Notes:

  1. Either use attribute link, or an embedded link in attribute text, not both.
  2. On PNG images only one clickable link will be shown per text segment (text with tabs (^) constitutes several segments).

Example:

TextData =
  pos:(20,67) textcolor:black fontsize:S
  tabs:(10-right,14-left,50-left,90-left,230-left)
  text:^1^1940^27/9^Germany,Italy and Japan sign [[Tripartite Pact]]
  text:^10^1944^1-22/7^Bretton Woods 44 nations establish
  text:^^^^^IMF and World Bank

will be shown as:

Tripartite Pact

TimeAxis

Defines the orientation of the time axis, and textual representation of stubs along that axis.

format (O)
Specify in which format dates should be presented along the time axis.
Currently only format yyyy (default) is supported. More formats may follow.
orientation (O)
Specify hor[izontal] (default) or ver[tical].

Example:

TimeAxis = orientation:horizontal format:yyyy

Input rules

Measurements

Absolute measurements may be used for specifying sizes, positions and position shifts, and are measured in pixels.

Example:

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

Relative measurements may be used for specifying sizes and positions. Specify a number between 0 and 100, immediately followed by a % (percentage) sign. For horizontal measurements the percentage is related to image width, for vertical measurements to image height.

Example:

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

Text Input

Text input is subject to a few rules:

1 No unicode is allowed yet. See also font support.

2 When text should contain spaces, either specify these by using underscores or place the text between double quotes.

Exception: when the text attribute is the last attribute on a line, spaces are allowed (no confusion will arise where the text stops and the next attribute starts, that is—to be precise—when no colons occur in the text).

Example: (the following are all equivalent)

BarData =
  text:Japanese_mandate_since_1914 bar:Marshalls

BarData =
  text:"Japanese mandate since 1914" bar:Marshalls

BarData =
  bar:Marshalls text:Japanese mandate since 1914

3 In data lines following command TextData two characters have special meaning:

~ (tilde) means line break
^ (caret) means tab

Example showing line breaks:

TextData =
  .. text:Generated for Wikipedia~Version 1.1 - 2 Januari 2004

# will be shown as:
#
#  Generated for Wikipedia
#  Version 1.1 - 2 Januari 2004

Example showing tabs:

TextData =
  tabs:(4-right,12-right,14-left,34-left)
  text:^1^1940^27/9^Berlin Ger,It,Jap sign Tripartite Pact
  text:^10^1944^1-22/7^Bretton Woods 44 nations establish
  text:^^^^^IMF and World Bank

# will be shown as:
#
#      1    27/9 Berlin Ger,It,Jap sign Tripartite Pact
#     10  1-22/7 Bretton Woods 44 nations establish
#                                    IMF and World Bank

Clickable Maps

Both output formats available on Wikipedia, i.e. PNG and SVG, can contain clickable links. Texts shown in blue, and bars, may then be clicked, to surf to another web page.

Links can be specified with commands BarData, PlotData and TextData, either with attribute link, or as embedded links, via attribute text.

Embedded links are links that are (part of a) displayable text, specified with attribute text. Their counterpart are explicit links (URL only) which are defined with attribute link.

Both type of links can be specified with commands BarData, PlotData and TextData and are used for clickable maps.

Text between double square brackets defines a link to a Wikipedia article. An article on any of the Wikipedias can be defined by prefixing the article name with the 2 or 3 letter code for that Wikipedia. Any text following after a | (pipe) symbol, will be displayed instead of the actual article name.

Any web link (URL) can be specified between single square brackets. Again, the actual text to be displayed follows after a | (pipe) symbol.

Examples:

  text:1642 [[Rembrandt]] paints Night Watch

will be shown as:

Rembrandt
  text:1642 [[Rembrandt|Rembrandt van Rijn]] paints Night Watch

will be shown as:

Rembrandt
  text:1642 [http://www.wikipedia.org/wiki/Rembrandt|Rembrandt van Rijn] paints Night Watch

will be shown as:

www.wikipedia.org/..

The following embedded link points to the article on the Dutch Wikipedia: http://nl.wikipedia.org/wiki/Rembrandt

  text:1642 [[nl:Rembrandt|Rembrandt van Rijn]] paints Night Watch

will be shown as:

nl:Rembrandt

Notice that last two links point to different Wikipedias. Also the hint popup text varies (move over link with mouse).


Schriften

Unicode ist (noch) nicht erlaubt. Der Schrifttyp kann (noch) nicht festgelegt werden.

Fünf Schriftgrößen sind vordefiniert, die in leicht unterschiedlicher Größe in PNG- und SVG-Bildern dargestellt werden, um optimale Lesbarkeit auf beiden Plattformen zu erreichen. Es wird empfohlen woimmer möglich diese 'tags' statt numerischer Angaben zu benutzen.

Es sind: XS=eXtra Small, S=Small (default), M=Medium, L=Large, XL=eXtra large