Template:Simple Horizontal timeline/doc

Jump to navigation Jump to search

This is a Lua implementation of {{Horizontal timeline}}. It has all the functionality of the legacy one with few more features added to it.

Parameters

Basic Plot settings

  • |bordr= Border of the plot
  • |bgCol= Background color of the plot
  • |width= Width of the timeline plot. Defaults to 100%, can be in px or em too
  • |caption= shows a centered text. Can be used to show legends. Intended to be used to label the axis
  • |from= and |to= Necessary parameters which denotes the start and end of the timeline axis. The entire timeline (for the entire plot) including other type of rows are drawn to this scale. |to= may or may not be greater than |from=. (see |inc= for more on this) If any bars described using parameters shown below lie outside these values, they will be trimmed or eliminated depending on their position.
  • |inc= Optional Increment to be added to |from= to reach |to= and be displayed along the axis. If not specified it will be automatically calculated. If |to= is greater than |from= then |inc= should be positive and vice versa. If not the outcome is undetermined.

The rown parameter

|rown= specifies how horizontal rows are drawn. You can have as many rows as you want. Subscript are positive integers. They specify where the row is rendered on the plot. Lower subscript indicate higher on the plot. That is |row3= will be above |row4=

Three differenct types of rows are possible. They are:

  • scale: Specifies where the axis is drawn. (how it is drawn can be found in the Scale Row section below).
  • timeline: Specifies where and how the bars are drawn.
  • note: Row that contains arrow marked notes to give explanations to the graph.

Generic Parameters

  • |height= Applies height of timeline and note rows.

Each of these types of rows have their own attributes specified with an hyphen. For example, the style of a rown can be specified as |rown-style=. Full list of available attributes and their description can be found below.

Scale Row

  • |axis-negativeFmt=, |axis-positiveFmt= and |axis-zeroFmt= Formatting options for Axis scale. If you want more customization, (like completely hiding a single label on the axis) use the following:
    • |axis-value= - Used to replace the value label on the axis (It will work if and only if the exact value appears on it).
    • |axis-marker-value= - Used to replace the marker point for a label that appears on the axis. (It will work if and only if the exact value appears on it).
  • |axis-nudge= Amount of nudge to be applied to the axis label, defaults to -1.8em.

|axis-marker-1878=  |axis-1878= 

Example Usage

Example without |axis-nudge=
Markup Renders as
{{Simple Horizontal timeline
|from=-2000
|to=2000
|inc=500
|row1=scale
}}
−2000
−1500
−1000
−500
0
500
1000
1500
2000
Example with |axis-nudge= and label formating
Markup Renders as
{{Simple Horizontal timeline
|from=-2000
|to=2000
|inc=500
|row1=scale
|axis-negativeFmt=%s BC
|axis-positiveFmt=%s AD
|axis-zeroFmt= %s AD
|axis-nudge=-0.8em
}}
2000 BC
1500 BC
1000 BC
500 BC
0 AD
500 AD
1000 AD
1500 AD
2000 AD
Example with |axis-value= and |axis-marker-value=
Markup Renders as
{{Simple Horizontal timeline
|from=-2000
|to=2000
|inc=500
|row1=scale
|axis-nudge=-0.8em
|axis--2000=this is minus<br/>two thousand
|axis-marker-0=⇑
|axis-0=Changed<br/>axis marker
}}
−2000
−1500
−1000
−500
Changed
axis marker
500
1000
1500
2000

Timeline Row

  • |rown-bordertop= and |rown-borderbottom= Specifies the top and bottom border for the row.
  • |rown-texttop= specifies vertical nudge for the bar labels for the entire row.
  • |rown-colour= or |rown-color= specifies the row's background color.
Note: colour or color both are acceptable variations for the whole module.
  • |rown-i-from= Starting point for the bar. This is optional, if not specified, will start from value specified in |from=.
  • |rown-i-to= Ending point for the bar.
  • |rown-i-text= Label for the bar.
  • |rown-i-fontsize= Font size for the label.
  • |rown-i-texttop= Vertical nudge for the label of ith bar.
  • |rown-i-colour= bar colour.
  • |rown-i-border= bar border (See Known Issues).
Note on Subscripts:
  • |rown-i-<attribute>= denotes the attribute value for ith bar on the nth row.
  • Here subscript n is a positive number used to group rows and their attributed. They may not occur continuous in your script, but are displayed in ascending order.
  • Subscript i is also a positive number which is used to group bar on a specific row.

Style Parameter of the Timeline Row

  • |rown-style= and |rown-i-style= can be used to provide row specific or bar specific styles. Those styles which repeat for every bar or for every row may be grouped into styles and be applied globally. The style prefixes can be anything other than row. See example below on how |styleDefault= is used to apply style common to all rows and |stylePopes=/|styleAntiPopes= are used to specify bar specific styles.

Example Usage

Markup

{{Simple Horizontal timeline

|from=1003
|to=1281
|inc=12
|axis-nudge=-0.5em

|styleDefault-height=1.5em
|styleDefault-1-border=none;
|styleDefault-3-border=none;text-align:left
|styleDefault-3-texttop=0em;left:0.5em;
|styleDefault-5-border=none;text-align:left
|styleDefault-5-texttop=0em;left:0.5em;

|stylePopes-boxcolour=#F7C000
|stylePopes-border=none;border:2px solid #D0A200

|styleAntiPopes-boxcolour=#DD4444
|styleAntiPopes-border=none;border:2px solid #E20000

|row1=timeline
|row1-style=styleDefault
|row1-1-to=1003
|row1-2-to=1003.9
|row1-2-style=stylePopes
|row1-3-text=[[Pope John XVII|John XVII]] (1003)

|row1-3-to=1124
|row1-4-to=1130
|row1-4-style=stylePopes
|row1-5-text=[[Pope Honorius II|Honorius II]] (1124–1130)

|row2=timeline
|row2-style=styleDefault
|row2-1-to=1004
|row2-2-to=1009
|row2-2-style=stylePopes
|row2-3-text=[[Pope John XVIII|John XVIII]] (1004–1009)

|row2-3-to=1124
|row2-4-to=1124.9
|row2-4-style=styleAntiPopes
|row2-5-text=[[Antipope Celestine II|Celestine II]] (1124), antipope

|row3=timeline
|row3-style=styleDefault
|row3-1-to=1009
|row3-2-to=1012
|row3-2-style=stylePopes
|row3-3-text=[[Pope Sergius IV|Sergius IV]] (1009–1012)

|row3-3-to=1130
|row3-4-to=1143
|row3-4-style=stylePopes
|row3-5-text=[[Pope Innocent II|Innocent II]] (1130–1143)

|row4=timeline
|row4-style=styleDefault
|row4-1-to=1012
|row4-2-to=1024
|row4-2-style=stylePopes
|row4-3-text=[[Pope Benedict VIII|Benedict VIII]] (1012–1024)

|row4-3-to=1130
|row4-4-to=1138
|row4-4-style=styleAntiPopes
|row4-5-text=[[Antipope Anacletus II|Anacletus II]] (1130–1138), antipope

|row5=timeline
|row5-style=styleDefault
|row5-1-to=1012
|row5-2-to=1012.9
|row5-2-style=styleAntiPopes
|row5-3-text=[[Antipope Gregory VI|Gregory VI]] (1012), antipope

|row5-3-to=1138
|row5-4-to=1138.9
|row5-4-style=styleAntiPopes
|row5-5-text=[[Antipope Victor IV (1138)|Victor IV]] (1138), antipope

|row6=timeline
|row6-style=styleDefault
|row6-1-to=1024
|row6-2-to=1032
|row6-2-style=stylePopes
|row6-3-text=[[Pope John XIX|John XIX]] (1024–1032)

|row6-3-to=1143
|row6-4-to=1144
|row6-4-style=stylePopes
|row6-5-text=[[Pope Celestine II|Celestine II]] (1143–1144)

|row7=timeline
|row7-style=styleDefault
|row7-1-to=1032
|row7-2-to=1044
|row7-2-style=stylePopes
|row7-3-text=[[Pope Benedict IX|Benedict IX]] (1032–1044, 1045 and 1047–1048)

|row7-3-to=1144
|row7-4-to=1145
|row7-4-style=stylePopes
|row7-5-text=[[Pope Lucius II|Lucius II]] (1144–1145)

|row8=timeline
|row8-style=styleDefault
|row8-1-to=1045
|row8-2-to=1045.9
|row8-2-style=styleAntiPopes
|row8-3-text=[[Pope Silvester III|Silvester III]] (1045)

|row8-3-to=1145
|row8-4-to=1153
|row8-4-style=stylePopes
|row8-5-text=[[Pope Eugene III|Eugene III]] (1145–1153)

|row9=timeline
|row9-style=styleDefault
|row9-1-to=1045
|row9-2-to=1045.9
|row9-2-style=stylePopes
|row9-3-text=[[Pope Benedict IX|Benedict IX]] (1032–1044, 1045 and 1047–1048)

|row9-3-to=1153
|row9-4-to=1154
|row9-4-style=stylePopes
|row9-5-text=[[Pope Anastasius IV|Anastasius IV]] (1153–1154)

|row10=timeline
|row10-style=styleDefault
|row10-1-to=1045
|row10-2-to=1046
|row10-2-style=stylePopes
|row10-3-text=[[Pope Gregory VI|Gregory VI]] (1045–1046)

|row10-3-to=1154
|row10-4-to=1159
|row10-4-style=stylePopes
|row10-5-text=[[Pope Hadrian IV|Hadrian IV]] (1154–1159)

|row11=timeline
|row11-style=styleDefault
|row11-1-to=1046
|row11-2-to=1047
|row11-2-style=stylePopes
|row11-3-text=[[Pope Clement II|Clement II]] (1046–1047)

|row11-3-to=1159
|row11-4-to=1181
|row11-4-style=stylePopes
|row11-5-text=[[Pope Alexander III|Alexander III]] (1159–1181)

|row12=timeline
|row12-style=styleDefault
|row12-1-to=1047
|row12-2-to=1048
|row12-2-style=stylePopes
|row12-3-text=[[Pope Benedict IX|Benedict IX]] (1032–1044, 1045 and 1047–1048)

|row12-3-to=1159
|row12-4-to=1164
|row12-4-style=styleAntiPopes
|row12-5-text=[[Antipope Victor IV (1159-1164)|Victor IV]] (1159–1164), antipope

|row13=timeline
|row13-style=styleDefault
|row13-1-to=1048
|row13-2-to=1048.9
|row13-2-style=stylePopes
|row13-3-text=[[Pope Damasus II|Damasus II]] (1048)

|row13-3-to=1164
|row13-4-to=1168
|row13-4-style=styleAntiPopes
|row13-5-text=[[Antipope Paschal III|Paschal III]] (1164–1168), antipope

|row14=timeline
|row14-style=styleDefault
|row14-1-to=1049
|row14-2-to=1054
|row14-2-style=stylePopes
|row14-3-text=[[Pope Leo IX|Leo IX]] (saint) (1049–1054)

|row14-3-to=1168
|row14-4-to=1178
|row14-4-style=styleAntiPopes
|row14-5-text=[[Antipope Callixtus III|Callixtus III]] (1168–1178), antipope

|row15=timeline
|row15-style=styleDefault
|row15-1-to=1055
|row15-2-to=1057
|row15-2-style=stylePopes
|row15-3-text=[[Pope Victor II|Victor II]] (1055–1057)

|row15-3-to=1179
|row15-4-to=1180
|row15-4-style=styleAntiPopes
|row15-5-text=[[Antipope Innocent III|Innocent III]] (1179–1180), antipope

|row16=timeline
|row16-style=styleDefault
|row16-1-to=1057
|row16-2-to=1058
|row16-2-style=stylePopes
|row16-3-text=[[Pope Stephen IX|Stephen IX]] (1057–1058)

|row16-3-to=1181
|row16-4-to=1185
|row16-4-style=stylePopes
|row16-5-text=[[Pope Lucius III|Lucius III]] (1181–1185)

|row17=timeline
|row17-style=styleDefault
|row17-1-to=1058
|row17-2-to=1061
|row17-2-style=stylePopes
|row17-3-text=[[Pope Nicholas II|Nicholas II]] (1058–1061)

|row17-3-to=1185
|row17-4-to=1187
|row17-4-style=stylePopes
|row17-5-text=[[Pope Urban III|Urban III]] (1185–1187)

|row18=timeline
|row18-style=styleDefault
|row18-1-to=1058
|row18-2-to=1059
|row18-2-style=styleAntiPopes
|row18-3-text=[[Antipope Benedict X|Benedict X]] (1058–1059), antipope

|row18-3-to=1187
|row18-4-to=1187.9
|row18-4-style=stylePopes
|row18-5-text=[[Pope Gregory VIII|Gregory VIII]] (1187)

|row19=timeline
|row19-style=styleDefault
|row19-1-to=1061
|row19-2-to=1064
|row19-2-style=styleAntiPopes
|row19-3-text=[[Antipope Honorius II|Honorius II]] (1061–1064), antipope

|row19-3-to=1187
|row19-4-to=1191
|row19-4-style=stylePopes
|row19-5-text=[[Pope Clement III|Clement III]] (1187–1191)

|row20=timeline
|row20-style=styleDefault
|row20-1-to=1061
|row20-2-to=1073
|row20-2-style=stylePopes
|row20-3-text=[[Pope Alexander II|Alexander II]] (1061–1073)

|row20-3-to=1191
|row20-4-to=1198
|row20-4-style=stylePopes
|row20-5-text=[[Pope Celestine III|Celestine III]] (1191–1198)

|row21=timeline
|row21-style=styleDefault
|row21-1-to=1073
|row21-2-to=1085
|row21-2-style=stylePopes
|row21-3-text=[[Pope Gregory VII|Gregory VII]] (saint) (1073–1085)

|row21-3-to=1198
|row21-4-to=1216
|row21-4-style=stylePopes
|row21-5-text=[[Pope Innocent III|Innocent III]] (1198–1216)

|row22=timeline
|row22-style=styleDefault
|row22-1-to=1084
|row22-2-to=1100
|row22-2-style=styleAntiPopes
|row22-3-text=[[Antipope Clement III|Clement III]] (1084–1100), antipope

|row22-3-to=1216
|row22-4-to=1227
|row22-4-style=stylePopes
|row22-5-text=[[Pope Honorius III|Honorius III]] (1216–1227)

|row23=timeline
|row23-style=styleDefault
|row23-1-to=1085
|row23-2-to=1087
|row23-2-style=stylePopes
|row23-3-text=[[Pope Victor III|Victor III]] (1085–1087)

|row23-3-to=1227
|row23-4-to=1241
|row23-4-style=stylePopes
|row23-5-text=[[Pope Gregory IX|Gregory IX]] (1227–1241)

|row24=timeline
|row24-style=styleDefault
|row24-1-to=1088
|row24-2-to=1099
|row24-2-style=stylePopes
|row24-3-text=[[Pope Urban II|Urban II]] (1088–1099)

|row24-3-to=1241
|row24-4-to=1241.9
|row24-4-style=stylePopes
|row24-5-text=[[Pope Celestine IV|Celestine IV]] (1241)

|row25=timeline
|row25-style=styleDefault
|row25-1-to=1099
|row25-2-to=1118
|row25-2-style=stylePopes
|row25-3-text=[[Pope Paschal II|Paschal II]] (1099–1118)

|row25-3-to=1243
|row25-4-to=1254
|row25-4-style=stylePopes
|row25-5-text=[[Pope Innocent IV|Innocent IV]] (1243–1254)

|row26=timeline
|row26-style=styleDefault
|row26-1-to=1100
|row26-2-to=1100.9
|row26-2-style=styleAntiPopes
|row26-3-text=[[Antipope Theodoric|Theodoric]] (1100), antipope

|row27=timeline
|row27-style=styleDefault
|row27-1-to=1102
|row27-2-to=1102.9
|row27-2-style=styleAntiPopes
|row27-3-text=[[Antipope Adalbert|Adalbert]] (1102), antipope

|row28=timeline
|row28-style=styleDefault
|row28-1-to=1105
|row28-2-to=1111
|row28-2-style=styleAntiPopes
|row28-3-text=[[Antipope Silvester IV|Silvester IV]] (1105–1111), antipope

|row29=timeline
|row29-style=styleDefault
|row29-1-to=1118
|row29-2-to=1119
|row29-2-style=stylePopes
|row29-3-text=[[Pope Gelasius II|Gelasius II]] (1118–1119)

|row30=timeline
|row30-style=styleDefault
|row30-1-to=1118
|row30-2-to=1121
|row30-2-style=styleAntiPopes
|row30-3-text=[[Antipope Gregory VIII|Gregory VIII]] (1118–1121), antipope

|row31=timeline
|row31-style=styleDefault
|row31-1-to=1119
|row31-2-to=1124
|row31-2-style=stylePopes
|row31-3-text=[[Pope Callixtus II|Callixtus II]] (1119–1124)

|row32=scale
|caption=Popes and Antipopes of the Catholic Church from 1003 - 1254
}}
Renders as
John XVII (1003)
Honorius II (1124–1130)
John XVIII (1004–1009)
Celestine II (1124), antipope
Sergius IV (1009–1012)
Innocent II (1130–1143)
Benedict VIII (1012–1024)
Anacletus II (1130–1138), antipope
Gregory VI (1012), antipope
Victor IV (1138), antipope
John XIX (1024–1032)
Celestine II (1143–1144)
Benedict IX (1032–1044, 1045 and 1047–1048)
Lucius II (1144–1145)
Eugene III (1145–1153)
Benedict IX (1032–1044, 1045 and 1047–1048)
Anastasius IV (1153–1154)
Gregory VI (1045–1046)
Hadrian IV (1154–1159)
Clement II (1046–1047)
Alexander III (1159–1181)
Benedict IX (1032–1044, 1045 and 1047–1048)
Victor IV (1159–1164), antipope
Damasus II (1048)
Paschal III (1164–1168), antipope
Leo IX (saint) (1049–1054)
Callixtus III (1168–1178), antipope
Victor II (1055–1057)
Innocent III (1179–1180), antipope
Stephen IX (1057–1058)
Lucius III (1181–1185)
Nicholas II (1058–1061)
Urban III (1185–1187)
Benedict X (1058–1059), antipope
Honorius II (1061–1064), antipope
Clement III (1187–1191)
Alexander II (1061–1073)
Celestine III (1191–1198)
Gregory VII (saint) (1073–1085)
Innocent III (1198–1216)
Clement III (1084–1100), antipope
Honorius III (1216–1227)
Victor III (1085–1087)
Gregory IX (1227–1241)
Urban II (1088–1099)
Paschal II (1099–1118)
Innocent IV (1243–1254)
Theodoric (1100), antipope
Adalbert (1102), antipope
Silvester IV (1105–1111), antipope
Gelasius II (1118–1119)
Gregory VIII (1118–1121), antipope
Callixtus II (1119–1124)
1003
1015
1027
1039
1051
1063
1075
1087
1099
1111
1123
1135
1147
1159
1171
1183
1195
1207
1219
1231
1243
1255
1267
1279

Popes and Antipopes of the Catholic Church from 1003 - 1254

Note Row

  • |rown-i-at= Necessary parameter. Specifies where the note is placed
  • |rown-i-text= Specifies the content of the note
  • |rown-i-shift= and |rown-i-lift= Specifies the nudge applied to the note. Defaults to 0em
  • |rown-i-arrow= Specifies the arrow Character. Defaults to . Nullify with &nbsp;.

Example Usage

Markup Renders as
{{Simple Horizontal timeline

|from=-600
|to=0

|row1=note
|row1-1-text='''Minor events'''
|row1-1-shift=-2.8em
|row1-1-arrow= 
|row1-1-at=-590
|row1-2-at=-542
|row1-2-text=[[End-Ediacaran extinction|End-Ediacaran?]]
|row1-3-at=-420
|row1-3-text=[[Lau event]]
|row1-4-at=-183
|row1-4-text=[[Toarcian turnover]]
|row1-4-lift=-1em
|row1-4-shift=-4.8
|row1-6-at=-91.5
|row1-6-text=[[Cenomanian-Turonian boundary event|Cenomanian-Turonian]]
|row1-6-lift=-1.3em
|row1-6-shift=-5.1

|row2=scale
|axis-nudge=-0.8em
|caption=Millions of years before present

}}
−600
−480
−360
−240
−120
0

Millions of years before present

Note: |row1-5-lift= is missing. Same as n, i does not have to be continuous.

Usage Tips

Examples

Known Issues

  • Left and bottom border for bars (not rows) will not render properly in old browsers which lacks support for CSS3 Box-sizing.(Refer here for full supported browser list) All modern browsers provides at-least minimal support for this. Also only in extereme circumstances you will need to set bar border. Most of the time row border will be sufficient. Hence this should not be a problem.

See also