Extension:EasyTimeline/yo

MediaWiki extensions manual

EasyTimeline Release status: stable
Implementation	Tag
Description	Adds ‎<timeline> tag for creating timelines
Author(s)	Erik Zachte
MediaWiki	>= 1.43
Database changes	No
License	GNU General Public License 2.0 only
Download	Download extension Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review CHANGELOG
Example	See below
Parameters $wgTimelineRsvgCommand $wgTimelineFontFile $wgTimelineFileBackend $wgTimelineFonts $wgTimelineFontDirectory $wgTimelinePloticusCommand $wgTimelinePerlCommand
Hooks used ParserFirstCallInit
Public wikis using	7,989 (Ranked 20th)
Translate the EasyTimeline extension
Issues	Open tasks · Report a bug

Other languages:

de es eu fr id it nl pt zh

The EasyTimeline extension produces an embedded image from wikitext. The image can be a one-dimensional diagram (horizontally or vertically) or a two-dimensional one.

Wo oju-iwe iranlọwọ lori lilo sintasi ti a pese nipasẹ itẹsiwaju yii. Wo tun oju-iwe yii lori EasyTimeline tabi ṣere pẹlu rẹ ni test.wikipedia.org.

Wo oju-iwe iranlọwọ lori lilo sintasi ti a pese nipasẹ itẹsiwaju yii.

akitiyan igba pipẹ wa lati gba itẹsiwaju Chart lati rọpo itẹsiwaju yii.

Charts examples

Several examples of what is possible. For more extensive examples, see

• WW II - Pacific Theatre - horizontal

• :en:Timeline of aircraft carriers of the United States Navy - horizontal

• History of Computing - horizontal

• Tour-de-France Sieger - vertical

• Vocal and instrumental pitch ranges (a nice example of a diagram that is not a timeline at all) - horizontal

• Complete Timeline of Macintosh models - horizontal

• Simpler timelines:

• • :en:Template:Extinction events graphical timeline - horizontal, uses w:Template:Horizontal timeline

• • :en:Talk:Invention_of_radio/Archive_1#Timeline.2C_Players - horizontal with arrows

• • :en:Template:Early evolution of the light bulb - vertical

• • :en:Invention of radio#Radio invention timeline - vertical

• • :en:Gaius_Marius#Timeline - vertical

• • :en:User:Syed Atif Nazir/Template:Imam timeline - vertical

• • Population developement - horizontal

Code example

See also: Extension:EasyTimeline/syntax

Just to show you that the script syntax is reasonably intuitive, here is the script for the image above: Soviet Leaders.

<timeline>
# All measures are in pixels

ImageSize  = width:160 height:550
PlotArea   = left:50 right:0 bottom:10 top:10
AlignBars  = justify

DateFormat = yyyy
Period     = from:1917 till:1991
TimeAxis   = orientation:vertical
ScaleMajor = unit:year increment:5 start:1920

# there is no automatic collision detection,
# so shift texts up or down manually to avoid overlap

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

PlotData=
  bar:Leaders color:red width:25 mark:(line,white) align:left fontsize:S

  from:start till:1924 shift:($dx,15)   text:Vladimir~Ilyich~[[Special:MyLanguage/Lenin|Lenin]]
  from:1924  till:1953 shift:($dx,5)    text:[[Special:MyLanguage/Stalin|Josef~Stalin]]
  from:1953  till:1964 shift:($dx,5)    text:Nikita~[[Special:MyLanguage/Khrushchev|Khrushchev]]
  from:1964  till:1982 shift:($dx,5)    text:Leonid~[[Special:MyLanguage/Brezhnev|Brezhnev]]
  from:1982  till:1984 shift:($dx,-12)  text:Yuri~[[Special:MyLanguage/Andropov|Andropov]]
  from:1984  till:1985 shift:($dx,4)    text:Konstantin~[[Special:MyLanguage/Chernenko|Chernenko]] fontsize:XS
  from:1985  till:end  shift:($dx,10)   text:Mikhail~[[Special:MyLanguage/Gorbachev|Gorbachev]]
</timeline>

Double and single brackets can be used like on Wikipedia, and language prefixes are possible, e.g., [[de:foo|more about foo]]. Single brackets for external links are also supported.

Unicode

EasyTimeline does not yet support Unicode.

Aug 2004: Minimal UTF-8 support has been added, meaning EasyTimeline now recognizes UTF-8 encoded characters. However, support for directionality and complex scripts is very lacking. The default font may not have glyphs for all characters. An alternate font can be specified via $wgTimelineFontFile

SVG to PNG

To show texts correctly for RTL languages (like Arabic, Persian, Hebrew,...) you can use ‎<timeline method="svg2png">timeline code here‎</timeline> instead of ‎<timeline>timeline code here‎</timeline>. it shows the timeline as png, but the links will be disabled.

Tips

For first-time users, EasyTimeline may not seem that easy at all. As with all script languages, it takes some getting used to. Also, the syntax description may be a bit bewildering due to its sheer size. Fortunately, many elements of the script language are optional.

The 'Easy' in EasyTimeline conveys the message that once a timeline exists, it is not so hard to understand, enhance, or correct. Also, translating it for use on another Wikipedia is pretty straightforward.

Tips:

• See some chart examples to find something you could pick and edit for your purposes

• Put each timeline on a separate Template page: this makes it easier to edit, faster to preview, and possible to include it in several pages

Using the current date

Lati lo ọjọ ti o wa lọwọlọwọ rii daju pe tabili ṣii pẹlu {{#tag:timeline| ati tilekun pẹlu }}. Lẹhinna ọjọ ti o wa lọwọlọwọ le fi sii nipa lilo awọn ọrọ idan. Fun apẹẹrẹ {{#akoko: d/m/Y }} tabi {{CURRENTDAY2}}/{{CURRENTMONTH2}}/{{CURRENTYEAR }} mejeeji yoo mu ọjọ jade ni ọna kika dd/mm/yyyy.

See also

• EasyTimeline Coding

• Presentation about EasyTimeline at Wikimania 2005 (abstract, slides, speaker notes)

• w:Template:Simple Horizontal timeline An easier timeline to use on Wikipedia.

• Extension:Chart /(Extension:Graph )

Installation

Requirements

This extension requires the following software to be installed on the server:

• Ploticus
• perl
• NIyipada (Windows nikan)

Installation

See the installation instructions.