imported>Cedar101: /* Bar-related attributes */ lang="ini"

2025-11-04T05:41:23Z

Bar-related attributes: lang="ini"

← Previous revision		Revision as of 05:41, 4 November 2025
Line 549:		Line 549:
	;bottom : Margin between bottom of image and bottom 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.

	~~'''~~width/height attributes~~'''~~		====width/height attributes====

	These attributes are only retained for downward compatibility. Earlier a plot area could only be defined by its total ''width'' and ''height'', and ''left'' and ''bottom'' margins. Now you can specify all four margins, and are advised to do so, and not use ''width'' and ''height'' attributes anymore. The advantage is added flexibility: when you change the overall image size, you do not need to adjust the plotarea definition as well. This is even more important when the image size is calculated automatically (see [[#ImageSize (mandatory)\|ImageSize]]).		These attributes are only retained for downward compatibility. Earlier a plot area could only be defined by its total ''width'' and ''height'', and ''left'' and ''bottom'' margins. Now you can specify all four margins, and are advised to do so, and not use ''width'' and ''height'' attributes anymore. The advantage is added flexibility: when you change the overall image size, you do not need to adjust the plotarea definition as well. This is even more important when the image size is calculated automatically (see [[#ImageSize (mandatory)\|ImageSize]]).

	~~<small>~~Example~~:</small>~~		====Example====
	<~~pre~~>		<syntaxhighlight lang="properties">
	# e.g. extra space to the left and below the plot area for axis labels and legend		# e.g. extra space to the left and below the plot area for axis labels and legend

	PlotArea = left:40 bottom:60 top:10 right:10		PlotArea = left:40 bottom:60 top:10 right:10
	</~~pre~~>		</syntaxhighlight>

	~~----~~

	=== PlotData ===		=== PlotData ===
Line 622:		Line 620:
	</timeline>		</timeline>

	==== Bar related attributes ====		==== Bar-related attributes ====
	;bar : Specifies to which bar all other attributes apply.		;bar
			: Specifies to which bar all other attributes apply.
	:When command [[#BarData\|BarData]] has not been used, bars will be drawn in the order in which they occur in any [[#PlotData\|PlotData]] data block. The id specified here will also be the text presented along the axis, next to the bar.		:When command [[#BarData\|BarData]] has not been used, bars will be drawn in the order in which they occur in any [[#PlotData\|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\|BarData]].		: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\|BarData]].
	;barset : Restarts the bar display "from the top", allowing multiple bars on the same line. Syntax: <~~samp~~>barset:name</~~samp><br /~~>Blank lines may be added to skip over lines that you do not wish to add to with declarations such as <~~samp~~>at:1234</~~samp~~> with no further attributes.		;barset
	;color : Specifies the color is which the bar should be drawn.		: Restarts the bar display "from the top", allowing multiple bars on the same line.
			: Syntax: <code>barset:name</code>
			: Blank lines may be added to skip over lines that you do not wish to add to with declarations such as <code>at:1234</code> with no further attributes.
			;color
			: Specifies the color is which the bar should be drawn.
	:The color id specified should be defined first with command [[#Colors\|Colors]].		:The color id specified should be defined first with command [[#Colors\|Colors]].
	;width : Specifies the width of the bar in absolute or relative [[#Measurements\|measurements]].		;width
			: Specifies the width of the bar in absolute or relative [[#Measurements\|measurements]].

	<~~small~~>Example~~:</small>~~		<syntaxhighlight lang="ini" line linelinks="bar" highlight="11-15">
	~~<pre>~~		# Example of bar-related properties
	BarData=		BarData=
	bar:US text:United States		bar:US text:United States
Line 647:		Line 651:
	bar:Midway from:start till:end color:US # see note 4		bar:Midway from:start till:end color:US # see note 4
	bar:US at:07/12/1941 text:7/12 Pearl Harbour # see note 5		bar:US at:07/12/1941 text:7/12 Pearl Harbour # see note 5
	</~~pre~~>		</syntaxhighlight>
	Notes:		Notes:
	#this line establishes a default bar width for the remainder of the data block		# [[#bar-11\|this line]] establishes a default bar width for the remainder of the data block
	#this line specifies a bar to be drawn and a text to placed on it at the same time		# [[#bar-12\|this line]] specifies a bar to be drawn and a text to placed on it at the same time
	#bar US will be drawn before bar SB, even when specified after it, because command [[#BarData\|BarData]] determines the sequence		# [[#bar-13\|<code>bar:US</code>]] will be drawn before bar SB, even when specified after it, because command [[#BarData\|BarData]] determines the sequence
	#bar Midway will be rejected because it is not declared with command [[#BarData\|BarData]]		# [[#bar-14\|<code>bar:Midway</code>]] will be rejected because it is not declared with command [[#BarData\|BarData]]
	#the last line will not result in a bar being plotted, it merely specifies on which bar the text should be placed		# [[#bar-15\|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 attributes ====
Line 1,075:		Line 1,079:
	== EasyTimeline code with template parameters==		== EasyTimeline code with template parameters==
	To render template parameters you must use <code><nowiki>{{#tag:</nowiki></code> syntax. As an example:		To render template parameters you must use <code><nowiki>{{#tag:</nowiki></code> syntax. As an example:
	<~~pre~~>		<syntaxhighlight lang="wikitext">
	{{#tag:timeline\|		{{#tag:timeline\|
	ImageSize = width:280 height:25		ImageSize = width:280 height:25
Line 1,087:		Line 1,091:
	pos:(10,10) fontsize:XL text:"a"		pos:(10,10) fontsize:XL text:"a"
	}}		}}
	</~~pre~~>		</syntaxhighlight>
	renders as		renders as

Line 1,104:		Line 1,108:

	Example a political timeline		Example a political timeline
	<~~pre~~>		<syntaxhighlight lang="wikitext">
	{{#tag:timeline\|		{{#tag:timeline\|
	ImageSize = width:1010 height:auto barincrement:25		ImageSize = width:1010 height:auto barincrement:25
Line 1,216:		Line 1,220:
	from: 14/03/2025 till: $today color:Liberal text:"[[Mark Carney]]" fontsize:10		from: 14/03/2025 till: $today color:Liberal text:"[[Mark Carney]]" fontsize:10
	}}		}}
	</~~pre~~>		</syntaxhighlight>

	renders as		renders as

imported>Moxy: /* EasyTimeline code with template parameters */

2025-03-17T20:35:59Z

EasyTimeline code with template parameters

Show changes

Help:EasyTimeline syntax - Revision history

imported>Cedar101: /* Bar-related attributes */ lang="ini"

imported>Moxy: /* EasyTimeline code with template parameters */