TimeAxis = orientation:horizontal format:yyyy |
A two letter postfix immediately after the number defines the unit.
Postfixes are: px (for pixels), in (for inches), cm (for centimeters). A resolution of 100 pixels per inch is assumed.
When no postfix is supplied pixels are assumed. Values can have a decimal fraction.
These specifications are equivalent:
width:800 |
width:800px |
width:8in |
width:3.15cm |
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% |
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:
BarData = text:Japanese_mandate_since_1914 bar:Marshalls is equivalent to: BarData = text:"Japanese mandate since 1914" bar:Marshalls is equivalent to: BarData = bar:Marshalls text:Japanese mandate since 1914 |
example:
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:
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 |
The rendering package used (Ploticus) comes out of the box with one ASCII standard font in five sizes, at least in the Windows version. Therefore, until freetype is supported (see below), the range of font sizes for PNG images is limited to these five. EasyTimelines also produces a SVG version of the image. Here any font size is possible.
Five font tags are predefined which will render at slightly different sizes in PGN and SVG images to produce optimal readability for both platforms. It is advised to use these tags instead of numbers whenever possible. They are XS, S (default), M, L or XL, which stands for (very) small, medium and (very) large.
Please review both versions of the image for proper text placement before uploading them to Wikipedia.
If someone is familiar with gcc or another C compiler: the author of Ploticus provides instructions for recompiling Ploticus to add freetype and unicode support to the Windows version. I'd be obliged.
All output formats, i.e. GIF, 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.
For SVG files no change in the web page on which they appear is needed.
For GIF and PNG files this only works when a extra piece of code, a map definition, is added to the HTML code for the page.
Therefore generation of clickable links for the latter two formats depends on an extra runtime option. Run EasyTimeline with option -m to generate a .map file which contains the map definition to be included in the HTML and to render text links blue. With extra runtime option -h a sample HTML file is generated to preview the result.
The map file will look something like this
example:
<area shape="rect" href="/cats-d8c4vu/..some url .." coords="..coordinates of clickable area 1.." > <area shape="rect" href="/cats-d8c4vu/..other url.." coords="..coordinates of clickable area 2.." > etc |
Copy this block of code into the HTML file, surrounded by <map name='mapname'> and </map>
Add a reference to this clickmap in the HTML tag defining the image: <img src=... usemap='#mapname'>
full example:
<map name='map1'> <area shape="rect" href="/cats-d8c4vu/..some url .." coords="..coordinates of clickable area 1.." > <area shape="rect" href="/cats-d8c4vu/..other url.." coords="..coordinates of clickable area 2.." > </map> <img src=Timeline1.png usemap='#map1'> |
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 attrribute link.
Both type of links can be specified with commands BarData, PlotData and TextData and are used for clickable maps.
The syntax for embedded links is based on the MediaWiki syntax, which has been developed for the Wikipedia encyclopedia, but is used elsewhere too.
Text between double square brackets defines a link to a Wikipedia article. By default the link points to the English version. An article on any of the other 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.
The following three embedded links all point to the same article on the English Wikipedia: http://en.wikipedia.org/wiki/Rembrandt
text:1642 [[Rembrandt]] paints Night Watch # will be shown as: 1642 Rembrandt paints Night Watch text:1642 [[Rembrandt|Rembrandt van Rijn]] paints Night Watch # will be shown as: 1642 Rembrandt van Rijn paints Night Watch text:1642 [http://en.wikipedia.org/wiki/Rembrandt|Rembrandt van Rijn] paints Night Watch # will be shown as: 1642 Rembrandt van Rijn paints Night Watch |
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: 1642 Rembrandt van Rijn paints Night Watch |
Solution: You probably specified a long text that extends beyond the defined image boundaries. The image size is then automatically adjusted. Check your texts and modify start position, text alignment and/or font size or add line breaks within the text.
Return to 2: Procedure |
Copyright (C) 2004 Erik Zachte, Amsterdam, The Netherlands. Email:erikzachte@+++.com (nospam: +++=infodisiac).
|
Continue to 4: Download | |||
EasyTimeline is free software; you can redistribute it and/or modify it under the terms of the |