Module:Build bracket/sandbox

Module documentation[view] [edit] [history] [purge]

This module is intended to be used to create and edit intricate sports brackets that cannot be made by Module:RoundN or Module:Team bracket. For example, additional headers (for double-elimination brackets; 3rd-, 5th-, 7th-place matches; etc), singular omitted matches (i.e., having a horizonal line instead of a match), and N-way brackets (N teams per match). The syntax is slightly more complicated than the aforementioned brackets, but simpler than using the standard wikitable code.

Usage

{{#invoke:Build bracket|main
| rounds =

| col1-headers = 
| col1-matches = 

| col2-headers = 
| col2-matches = 

...

| col1-col2-paths = 
| col2-col3-paths = 

...
}}

Parameters

Parameter	Description	Default
rounds	number of rounds (columns).	1
autocol	set to yes to automatically set set maximum round to display based on entries.	no
rows	manually set the number of rows.	Automatic
teams-per-match	enter the number of teams in each match. Use colm-teams-per-match to set individual columns	2
colm-headers	(optional) enter the row numbers where headers are desired in column m. Separate entries with ,. Half integer values are allowed.	Automatic
colm-matches	enter the row numbers where a match is desired in column m. Matches take up two rows by default. Separate entries with ,. Half integer values are allowed.
RDmh-hide	set to yes to hide the (alpha) hth header and all matches beneath it in column m unless any of those entries are non empty. Useful for consolation matches.
colm-colm+1-paths	enter the starting and ending row numbers, separated by -, from columns m and m+1 where a path is desired. Separate entries with ,. Half integer values are allowed.
colm-colm+1-cross	enter the row number where paths intersect from column m to m+1.
RDm-altname	Alternate name for RDm (e.g., if |RD1-altname=first, then first-team1 can be used instead of RD1-team1). Use RDmh-altname for cells under header mh.
text-altname	Alternate name for RDm-textk (e.g., if |text-altname=details, then RDm-details1 can be used instead of RDm-text1).
maxround	final round to display. This parameter should be omitted unless it is less than the default value set by rounds.
minround	first round to display.	1
height	the amount of vertical visibility desired for the bracket. Creates a vertical scroll bar. Enter a number with units (e.g., 30em or 480px).
col-spacing	the amount of horizontal space between rounds. Enter as a plain number (e.g., 10 for 10px).	5
seed-width	the width of the cells for seeds. Plain numbers are assumed to be in px units (e.g., 25 for 25px or 2em for 2em)	25
team-width	the width of the cells for team names. Plain numbers are assumed to be in px units (e.g., 200 for 200px or 15em for 15em)	150
score-width	the width of the cells for scores. Plain numbers are assumed to be in px units (e.g., 25 for 25px or 2em for 2em)	25
agg-width	the width of the cells for aggregate scores. score-width will change aggregate score widths unless this parameter is used. Plain numbers are assumed to be in px units (e.g., 25 for 25px or 2em for 2em)	25
seeds	set to no to omit seeds in in all matches. set to yes to show seed cells to show for all matches.
legs	the number of legs for all rounds. Use RDm-legs to individually set columns. Use RDm-legsk to individually set teams.	1
autolegs	set to yes to automatically generate score cells per team. If legs or RDm-legs is used, autolegs will be set to no .	no
byes	set to yes to hide any team cells that are empty. Alternatively, set to m to have rounds 1 through m hide any team cells that are empty. Use RDm-byes for just matches under column m. Use RDmh-byes for just matches under header h only in column m.	no
show-bye-paths	set to yes to replace any team cells that that are hidden byes with a path.	no
aggregate	set to yes to add an aggregate score box to each match. Only matches with two or more legs will show the aggregate score box.	no
boldwinner	set to yes to automatically bold the seed/team/score with the higher score in each match.	no
shift	vertically shifts all of the entries by the number entered. Use RDm-shift for individual in columns.	0
RDm, RDmh	The header text of the (alpha hth) header in column m (e.g., RD1 or RD1a for the first header and RD1b for the second header in column 1).
RDm-seedk	The seed of the kth team in column m. Alternatively, use RDmh-seedk for the kth team under header mh.
RDm-teamk	The name of the kth team in column m. Alternatively, use RDmh-teamk for the kth team under header mh.
RDm-scorek	The score of the kth team in column m. Alternatively, use RDmh-scorek for the kth team under header mh. Append the suffix -l for the lth leg or -agg for the aggregate score.
RDm-textk	The text above the kth match in column m. Alternatively, use RDmh-textk for the kth match under header mh.
RDm-groupk	The text for the kth group in column m. Group text will appear to the left of whenever two paths meet.
RD-shade	the background color (in hex format, e.g. #ABCDEF) of all headers. Use RDm-shade or RDmh-shade for individual headers.	#F2F2F2
RDm-RD(m+1)-path	set to no or 0 to omit the paths from round m to round m+1.	yes
paramstyle	set to numbered change the parameter name style of RDm-textk, RDm-seedk, RDm-teamk, and RDm-scorek to a numbered notation (|1=,|2=...). Set |seeds=yes add seeds.	indexed

Parameter hierarchy

• Whenever there are multiple headers in a single column, more than one parameter may be assigned to a cell value. For example, in the following bracket, both |RD1-team3= and |RD1b-team1= can be used to assign the third team in the first column. By default, entries with subheader prefixes will override those without. In the below example, RD1b-team1 will override any value that has been set by RD1-team3.

	Upper round
	Lower round
	RD1-team3 or RD1b-team1

• Parameters used in articles take precedence over parameters used in the template itself. For example, suppose ArticleX used the template NTeamBracket, and suppose NTeamBracket had the parameter |RD1-seed1=1 set. If ArticleX implemented {{NTeamBracket|RD1-seed1=2}}, then the first team in round 1 would have a seed of 2.

Path codes

Path codes are entered in the form a-b, where a is associated match in the first column, and b is associated match in the second column. Path codes can be grouped; for example, (a,b)-c is equivalent to a-c, b-c. To add color, append :color to the end of a path, e.g. 3-5:red. Only one extra color can be used in a bracket.

Example	Output
1-3
(1,5)-3
3-1,3-5:red

Examples

Note: These are only examples to illustrate parameters. Standard 4-team, 8-team, etc. brackets are better handled by Module:Team bracket.

Standard 4-team bracket

{{#invoke:Build bracket|main
| rounds=2

| col1-headers = 1
| col2-headers = 1

| col1-matches = 3,7
| col2-matches = 5

| col1-col2-paths = (3,7)-5

<!-- Defaults -->
| RD2 = Grand Final

| RD1-seed1 = 1
| RD1-seed3 = 2
}}

	Semifinals					Grand Final
	1
	2

3-way bracket

{{#invoke:Build bracket|main
| rounds=2
| teams-per-match = 3

| col1-headers = 1
| col2-headers = 1

| col1-matches = 3,7,11
| col2-matches = 7

| col1-col2-paths = (3,7,11)-7
}}

	Semifinals					Final

Double-elimination bracket

{{#invoke:Build bracket|main
| rounds=4

| col1-headers = 1,7
| col2-headers = 1,7
| col3-headers = 7
| col4-headers = 1

| col1-matches = 4,11
| col2-matches = 3,10
| col3-matches = 9
| col4-matches = 6

| col1-col2-paths = 4-3, 11-10
| col2-col3-paths = 3-3, 10-9
| col3-col4-paths = (3,9)-6

<!-- Defaults -->
| RD1 = Upper round 1
| RD2 = Upper final
| RD3b = Lower final
}}

Upper round 1

Upper final

Final

Lower round 1

Lower round 2

Lower final

Crossing paths

{{#invoke:Build bracket|main
| rounds=2

| col1-matches = 3,7
| col2-matches = 3,7

| col1-col2-paths = 3-7, 7-3
| col1-col2-cross = 5
}}

	Semifinals						Final

Text

{{#invoke:Build bracket|main
| rounds=2
| col1-matches = 3,6
| col2-matches = 4.5
| col1-col2-paths = (3,6)-4.5

| RD1-text1 = Text 1
| RD1-text2 = Text 2
| RD2-text1 = Text 3
}}

	Semifinals					Final
	Text 1
						Text 3
	Text 2

Groups

{{#invoke:Build bracket|main
| rounds=3
| col1-matches = 3,6,9,12
| col2-matches = 4.5,10.5
| col3-matches = 7.5

| col1-col2-paths = (3,6)-4.5, (9,12)-10.5
| col2-col3-paths = (4.5,10.5)-7.5

| RD1-group1 = Group 1
| RD1-group2 = Group 2
| RD2-group1 = Group 3
}}

Quarterfinals

Semifinals

Final

Group 1

Group 3

Group 2

Legs and aggregate

{{#invoke:Build bracket|main
| rounds=3
| legs = 2
| RD1-legs = 3
| aggregate = y

| col1-matches = 3,6,9,12
| col2-matches = 4.5,10.5
| col3-matches = 7.5

| col1-col2-paths = (3,6)-4.5, (9,12)-10.5
| col2-col3-paths = (4.5,10.5)-7.5
}}

Quarterfinals

Semifinals

Final

Byes

{{#invoke:Build bracket|main
| rounds=3
| RD1-byes = y

| col1-matches = 3,6,9,12
| col2-matches = 4.5,10.5
| col3-matches = 7.5

| col1-col2-paths = (3,6)-4.5, (9,12)-10.5
| col2-col3-paths = (4.5,10.5)-7.5

| RD1-team1 = Team 1
| RD1-team2 = Team 2
}}

Quarterfinals

Semifinals

Final

Team 1

Team 2

Bold winner

{{#invoke:Build bracket|main
| rounds=2
| legs = 3
| boldwinner=y
| col1-matches = 3,7
| col2-matches = 5
| col1-col2-paths = (3,7)-5

| RD1-seed1 = 1 | RD1-team1 = Team 1 | RD1-score1-1 = 5  | RD1-score1-2 = 12 | RD1-score1-3 = 15
| RD1-seed2 = 4 | RD1-team2 = Team 2 | RD1-score2-1 = 11 | RD1-score2-2 = 10 | RD1-score2-3 = 4

| RD1-seed3 = 2 | RD1-team3 = Team 3 | RD1-score3-1 = 6  | RD1-score3-2 = 13 | RD1-score3-3 = {{ndash}}
| RD1-seed4 = 3 | RD1-team4 = Team 4 | RD1-score4-1 = 3  | RD1-score4-2 = 2  | RD1-score4-3 = {{ndash}}

| RD2-seed1 = 4 | RD2-team1 = Team 2 | RD2-score1-1 = 2  | RD2-score1-2 = 2  | RD2-score1-3 = 5
| RD2-seed2 = 2 | RD2-team2 = Team 3 | RD2-score2-1 = 1  | RD2-score2-2 = 7  | RD2-score2-3 = 2
}}

	Semifinals							Final
	1	Team 1	5	12	15
	4	Team 2	11	10	4
								4	Team 2	2	2	5
								2	Team 3	1	7	2
	2	Team 3	6	13	–
	3	Team 4	3	2	–

See also

• Module:Team bracket
• Module:RoundN

The above documentation is transcluded from Module:Build bracket/doc. (edit | history)
Editors can experiment in this module's sandbox (edit | diff) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this module.

local p = {}

local function isempty(s)
	return s == nil or s == ''
end

local function notempty(s)
	return s ~= nil and s ~= ''
end

local function createPath(a,tbl,split)
	table.insert(tbl,'| style="border-width:'.. a[1] ..'px '.. a[2] ..'px '.. a[3] ..'px '.. a[4] ..'px; border-style:solid;border-color:black;')
	if split==true then
		table.insert(tbl, 'font-size:50%;" |   \n')
	else
		table.insert(tbl, '" | \n')
	end
end

local function splitPaths(a,b,c,d)
	local s = {}
	local split = true
	table.insert(s, '<table border=0 cellpadding=0 cellspacing=0 style="height:100%;"> \n')
	table.insert(s, '|- \n')
	createPath(a,s,split)
	createPath(b,s,split)
	table.insert(s, '|- \n')
	createPath(c,s,split)
	createPath(d,s,split)
	table.insert(s, '</table>')
	return table.concat(s)
end


local function pathCode(code1,code2)
	local split = false
	local a = {0,0,0,0}
	local b = {0,0,0,0}
	local c = {0,0,0,0}
	local d = {0,0,0,0}
	if code1:find("split") then
		split = true
		if code1:find("out")	then a[3]=1 c[1]=1 end
		if code1:find("up")		then a[2]=1 b[4]=1 end
		if code1:find("down")	then c[2]=1 d[4]=1 end
		if code1:find("in")		then b[3]=1 d[1]=1 end
	else
		if code1:find("out")	then a[3]=1 end
		if code1:find("up")		then a[2]=1 b[4]=1 end
		if code1:find("in")		then b[3]=1 end
		if code2:find("out")	then a[1]=1 end
		if code2:find("down")	then a[2]=1 b[4]=1 end
		if code2:find("in")		then b[1]=1 end
	end
	if split==true then
		table.insert(t, '| colspan="2" style="height:1px;" |'..splitPaths(a,b,c,d)..' \n')
	else
		createPath(a,t,split)
		createPath(b,t,split)
	end
end

local function Style(ctype,color)
	if ctype=='header' then
		return 'style="text-align:center;border:1px solid #aaa;background-color:'..color..';"'
	elseif ctype=='seed' then
		return 'style="text-align:center;background-color:#f2f2f2;border:1px solid #aaa;"'
	elseif ctype=='team' then
		return 'style="border:1px solid #aaa;background-color:#f9f9f9;padding-left:0.3em;"'
	elseif ctype=='score' then
		return 'style="text-align:center;border:1px solid #aaa;background-color:'..color..';"'
	end
end

local function generateRow(i,j,cell,rlegs,header,tseed,tname,tscore,text)
	if cell=='header' then
		if isempty(header[1]) then
			if i==1 and j==c then
				header[1] = 'Final'
			elseif i==1 and j==c-1 then
				header[1] = 'Semifinals'
			elseif i==1 and j==c-2 then
				header[1] = 'Quarterfinals'
			else
				header[1] = 'Round '..j	
			end
		end
		table.insert(t,'| colspan="'.. rlegs+2 ..'" '..Style('header',header[2])..' | '..header[1]..' \n')
	elseif cell=='team' then
		if seeds=='n' or seeds=='no' then
			table.insert(t,'| colspan="2" '..Style('team')..' | '..tname..' \n')
		else
			table.insert(t,'| '..Style('seed')..' | '..tseed..' \n')
			table.insert(t,'| '..Style('team')..' | '..tname..' \n')
		end
		for k=1,rlegs do
			table.insert(t,'| '..Style('score',tscore[k][2])..' | '..tscore[k][1]..' \n')
		end
	elseif cell=='text' then
		table.insert(t,'| colspan="'.. rlegs+2 ..'" | '..text..' \n')
	elseif cell=='line1' then
		table.insert(t,'| colspan="'.. rlegs+2 ..'" style="border-width:0 0 1px 0; border-style:solid;border-color:black;" | \n')
	elseif cell=='line2' then
		table.insert(t,'| colspan="'.. rlegs+2 ..'" style="border-width:1px 0 0 0; border-style:solid;border-color:black;" | \n')
	else
		table.insert(t,'| colspan="'.. rlegs+2 ..'" | \n')
	end

	if j<c then
		if isempty(path_1[i][j]) and isempty(path_2[i][j]) then
			table.insert(t,'| colspan="2" | \n')
		else
			if path_1[i][j]:find("split")==nil then
				path_2[i+1][j] = path_1[i][j]
			end
			pathCode(path_1[i][j],path_2[i][j])
		end
	end
end

local function newRow(t)
	table.insert(t,'|-\n')	
	table.insert(t,'| &nbsp;\n')
end

function p.main(frame)
	fargs = frame.args
	pargs = frame:getParent().args;
	
	r = tonumber(frame.args.rows) or tonumber(frame.args.maxrows) or 1
	c = tonumber(frame.args.rounds) or 1
	
	seeds = fargs.seeds or pargs.seeds or ''
	legs = tonumber(fargs.legs) or tonumber(pargs.legs) or 1
	seed_width = fargs["seed-width"] or  pargs["seed-width"] or 25
	team_width = fargs["team-width"] or pargs["team-width"] or 150
	score_width = fargs["score-width"] or pargs["score-width"] or 25
	
	path_1 = {}
	path_2 = {}
	for i=1,r+2 do 
		path_1[i]={} 
		path_2[i]={}
		for j=1,c do
			path_1[i][j] = fargs[i-1 ..'-'..j..'a'] or ''
			path_2[i][j]= ''
		end
	end
	
	t = {}
	
	table.insert(t,'{| border=0 cellpadding=0 cellspacing=0 style="font-size: 90%; margin:1em 2em 1em 1em;\n')
	newRow(t)
	-- Row 0 --
	for j=1,c do
		local header = {}
		header[1] = fargs['RD'..j] or pargs['RD'..j] or fargs['RD'..j..'-1'] or pargs['RD'..j..'-1'] or ''
		header[2] = fargs['RD'..j..'-shade'] or pargs['RD'..j..'-shade'] or fargs['RD'..j..'-1-shade'] or pargs['RD'..j..'-1-shade'] or fargs['RD-shade'] or pargs['RD-shade'] or '#f2f2f2'
		local rlegs = tonumber(fargs['RD'..j..'-legs']) or tonumber(pargs['RD'..j..'-legs']) or legs
		local cell = fargs['0-'..j] or ''
		generateRow(1,j,cell,rlegs,header)
	end
	
	-- Header/team separator --
	table.insert(t,'|-\n')
	for j=1,c do
		local rlegs = tonumber(fargs['RD'..j..'-legs']) or tonumber(pargs['RD'..j..'-legs']) or legs
		table.insert(t,'| width="5" | &nbsp;\n')
		table.insert(t,'| width="'..seed_width..'" | \n')
		table.insert(t,'| width="'..team_width..'" | \n')
		for k=1,rlegs do
			table.insert(t,'| width="'..score_width..'" | \n')
		end
		if j<c then
			table.insert(t,'| width="5" | \n')
		end
	end
	
	-- Rows 1 to ... --
	local m = {}
	for i=1,c do
		m[i]= {}
		for j=1,2 do
			m[i][j] = 1 
		end
		m[i][3] = 2
	end
	
	for i=1,r do
		newRow(t)
		for j=1,c do
			local cell = fargs[i..'-'..j] or ''
			local rlegs = tonumber(fargs['RD'..j..'-legs']) or tonumber(pargs['RD'..j..'-legs']) or legs
			local header = {}
			header[1] = fargs['RD'..j..'-'..m[j][3]] or pargs['RD'..j..'-'..m[j][3]] or ''
			header[2] = fargs['RD'..j..'-'..m[j][3]..'-shade'] or pargs['RD'..j..'-'..m[j][3]..'-shade'] or fargs['RD-shade'] or pargs['RD-shade'] or '#f2f2f2'
			local text = fargs['RD'..j..'-text'..m[j][2]] or pargs['RD'..j..'-team'..m[j][2]] or '&nbsp;'
			local tseed = fargs['RD'..j..'-seed'..m[j][1]] or pargs['RD'..j..'-seed'..m[j][1]] or ''
			local tname = fargs['RD'..j..'-team'..m[j][1]] or pargs['RD'..j..'-team'..m[j][1]] or '&nbsp;'
			local tscore = {}
			for k=1,rlegs do
				tscore[k]={}
			end
			tscore[1][1]=fargs['RD'..j..'-score'..m[j][1]] or pargs['RD'..j..'-score'..m[j][1]] or fargs['RD'..j..'-score'..m[j][1]..'-1'] or pargs['RD'..j..'-score'..m[j][1]..'-1'] or ''
			tscore[1][2]=fargs['RD'..j..'-score'..m[j][1]..'-shade'] or pargs['RD'..j..'-score'..m[j][1]..'-shade'] or fargs['RD'..j..'-score'..m[j][1]..'-1-shade'] or pargs['RD'..j..'-score'..m[j][1]..'-1-shade'] or '#f9f9f9'
			for k=2,rlegs do
				tscore[k][1]=fargs['RD'..j..'-score'..m[j][1]..'-'..k] or pargs['RD'..j..'-score'..m[j][1]..'-'..k] or ''
				tscore[k][2]=fargs['RD'..j..'-score'..m[j][1]..'-'..k..'-shade'] or pargs['RD'..j..'-score'..m[j][1]..'-'..k..'-shade'] or '#f9f9f9'
			end
			
			generateRow(i+1,j,cell,rlegs,header,tseed,tname,tscore,text)
			if cell=='team' then m[j][1]=m[j][1]+1 end
			if cell=='text' then m[j][2]=m[j][2]+1 end
			if cell=='header' then m[j][3]=m[j][3]+1 end
		end
	end
	table.insert(t,'|}')
	return table.concat(t)
end

return p