This page is a translated version of the page Extension:EasyTimeline and the translation is 18% complete.
MediaWiki extensions manual
OOjs UI icon advanced-invert.svg
Release status: stable
Implementation Tag
Description Adds ‎<timeline> tag for creating timelines
Author(s) Erik Zachte
MediaWiki >= 1.36.0
Database changes No
License GNU General Public License 2.0 only
Example See below
  • $wgTimelineFileBackend
  • $wgTimelineRsvgCommand
  • $wgTimelineFontFile
  • $wgTimelineShell
  • $wgTimelineFonts
  • $wgTimelineFontDirectory
  • $wgTimelinePloticusCommand
  • $wgTimelinePerlCommand
Translate the EasyTimeline extension
Issues Open tasks · Report a bug
Other languages: ar de es eu fr id it ja nl pt tr 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 Graph lati rọpo itẹsiwaju yii.

This extension requires the following programs installed on the server:

Charts examples

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

  • Simpler timelines:

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.

# 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

  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]]

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

Great timelines elsewhere

Here are two great sites that may serve as inspiration, it would be very easy to recreate most of those timelines verbatim and with roughly similar layout with EasyTimeline (not yet with images but that may change), but I'm afraid that would be 'not done'.

  • Hyperhistory e.g. click on button 'people' left, then on 'special lifelines', right.
  • I hope we will have a set like [1] in a years time (click on full size image for any map), possibly even with images. The main effort will be to gather all info without snatching everything from here (most of these maps are based exclusively on data from Britannica).


EasyTimeline does not yet support unicode.

Aug 2004: Minimal UTF-8 support has been added, meaning that 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


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 timeline as png but the links will be disabled.


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 for use on another Wikipedia it is pretty straightforward.


  • See some chart examples to find something you could pick and edit for your own stuff
  • Put each timeline on a separate Template page: this makes it easier to edit, faster to preview, 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

  • m:WikiTimeScale as a proposal for realizing timescales for wikipedia articles externally.


External links