Modul:Sports table/Volleyball
Dokumentation [visa] [redigera] [historik] [rensa sidcachen]
This style for Lua-based Modul:Sports table is meant to build group and league tables for competitions with a volleyball format. Note that this module is used extensively, so test potential changes rigorously in the sandbox and please ensure consensus exists before implementing major changes. The rest of this documentation explains how to use this module with the WL style in an article or template, check the table of contents for specific items.
Användning
[redigera wikitext]Grundläggande användning
[redigera wikitext]In its simplest form only several parameters need to be used to build a table
| Vad du skriver | {{#invoke:Sports table|main|</nowiki>style=Volleyball<br>
|team1=FDT |team2=BBB |team3=CCC |team4=DDD |team5=EEE
|bwin_FDT=4 |swin_FDT=1 |sloss_FDT=0 |bloss_FDT=0 |sw_FDT=15 |sl_FDT=3 |spw_FDT=423 |spl_FDT=210
|bwin_BBB=3 |swin_BBB=0 |sloss_BBB=1 |bloss_BBB=0 |sw_BBB=9 |sl_BBB=4 |spw_BBB=377 |spl_BBB=251
|bwin_CCC=1 |swin_CCC=2 |sloss_CCC=0 |bloss_CCC=2 |sw_CCC=9 |sl_CCC=5 |spw_CCC=301 |spl_CCC=287
|bwin_DDD=1 |swin_DDD=0 |sloss_DDD=0 |bloss_DDD=3 |sw_DDD=3 |sl_DDD=9 |spw_DDD=222 |spl_DDD=327
|bwin_EEE=0 |swin_EEE=0 |sloss_EEE=2 |bloss_EEE=3 |sw_EEE=0 |sl_EEE=15 |spw_EEE=151 |spl_EEE=399
|name_FDT=[[Dream Team]]
|name_BBB=Team 2
|name_CCC=Team 3
|name_DDD=Team 4
|name_EEE={{dvbf|AUS}}
}}
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Vad det ser ut som |
Uppdaterad den match(er) spelade den unknown. Källor: [källa behövs]
|
| Vad du skriver | {{#invoke:Sports table|main|style=Volleyball
|team1=FDT|team2=BBB|team3=CCC|team4=DDD
|win3s_FDT=3 |win4s_FDT=0 |win5s_FDT=0 |loss5s_FDT=0 |loss4s_FDT=0 |loss3s_FDT=0 |spw_FDT=225 |spl_FDT=158
|win3s_BBB=0 |win4s_BBB=1 |win5s_BBB=1 |loss5s_BBB=0 |loss4s_BBB=0 |loss3s_BBB=1 |spw_BBB=256 |spl_BBB=269
|win3s_CCC=0 |win4s_CCC=1 |win5s_CCC=0 |loss5s_CCC=0 |loss4s_CCC=1 |loss3s_CCC=1 |spw_CCC=243 |spl_CCC=254
|win3s_DDD=0 |win4s_DDD=0 |win5s_DDD=0 |loss5s_DDD=1 |loss4s_DDD=1 |loss3s_DDD=1 |spw_DDD=233 |spl_DDD=276
|name_FDT=[[Dream Team]]
|name_BBB=Team 2
|name_CCC=Team 3
|name_DDD={{dvbf|AUS}}
|col_A=#ccffcc|result1=A|result2=A
|col_E=#ffcccc|result3=E|result4=E
}}
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Vad det ser ut som |
Uppdaterad den match(er) spelade den unknown. Källor: [källa behövs]
|
The main command is the {{#invoke:Sports table|main|style=Volleyball}} statement which basically calls the module and enables you to set everything up. Then you list the positions of the teams as |team1=, |team2=, etc for however many teams you need in the table. You can use full team names there without spaces if you want, but using codes (as in the example) can make it easier. For each team you now define the big wins small wins, small losses, big losses, sets won, sets lost, setpoints won and setpoints lost by using |bwin_TTT=, |swin_TTT=, |sloss_TTT=, |bloss_TTT=, |sw_TTT=, |sl_TTT=, |spw_TTT= and |spl_TTT= respectively (with TTT replaced by the team code). Alternatively, you can define |win3s_TTT=, |win4s_TTT=, |win5s_TTT=, |loss5s_TTT=, |loss4s_TTT=, |loss3s_TTT= for 3-set-wins, 4-set-wins, 5-set-wins, 5-set-losses, 4-set-losses, and 3-set-losses. Note that, win5s is the same as "small wins" and win4s/win3s are the same as "big wins". You should not use both the bwin and win4s/win3s syntax simultaneously. If you do not define any of these numbers, they are automatically assumed to be 0. It is good practice though to include them anyway and to align the columns using appropriate spaces (as in the example), so the code is easy to read. The last step now is to define the |name_TTT= parameters which determine what name is shown in the table, you can use wiki markup and templates in here as well. See #Dating to see how to change the update date.
Customization
[redigera wikitext]Several things can be customized in these tables
Hiding played column
[redigera wikitext]Setting |hide_played=yes hides the played column.
Hiding the sets columns
[redigera wikitext]Setting |show_sets=no hides the sets columns.
Hiding the setpoints columns
[redigera wikitext]Setting |show_setpoints=no hides the setpoints columns.
Showing the setpoints columns first
[redigera wikitext]Setting |setpoints_before_sets=yes moves the setpoints columns before the sets colums.
Wins or points
[redigera wikitext]By default teams are ranked by wins, but also list points which can be adjusted as follows:
| Vad du skriver | {{#invoke:Sports table|main|</nowiki>style=Volleyball<br>
|ranking_style=points
|team1=FDT |team2=BBB |team3=CCC |team4=DDD |team5=EEE
|bwin_FDT=4 |swin_FDT=1 |sloss_FDT=0 |bloss_FDT=0 |sw_FDT=15 |sl_FDT=3 |spw_FDT=423 |spl_FDT=210
|bwin_BBB=3 |swin_BBB=0 |sloss_BBB=1 |bloss_BBB=0 |sw_BBB=9 |sl_BBB=4 |spw_BBB=377 |spl_BBB=251
|bwin_CCC=1 |swin_CCC=2 |sloss_CCC=0 |bloss_CCC=2 |sw_CCC=9 |sl_CCC=5 |spw_CCC=301 |spl_CCC=287
|bwin_DDD=1 |swin_DDD=0 |sloss_DDD=0 |bloss_DDD=3 |sw_DDD=3 |sl_DDD=9 |spw_DDD=222 |spl_DDD=327
|bwin_EEE=0 |swin_EEE=0 |sloss_EEE=2 |bloss_EEE=3 |sw_EEE=0 |sl_EEE=15 |spw_EEE=151 |spl_EEE=399
|adjust_points_FDT=1.5
|adjust_points_EEE=-1.5
|name_FDT=[[Dream Team]]
|name_BBB=Team 2
|name_CCC=Team 3
|name_DDD=Team 4
|name_EEE={{bk|GIB}}
|bwinpoints=5
|swinpoints=1.5
|slosspoints=-0.1
|blosspoints=-0.8
}}
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Vad det ser ut som |
Uppdaterad den match(er) spelade den unknown. Källor: [källa behövs]
|
As a default a big win is worth 3 points, a small win 2 points, a small loss 1 point and a big loss 0 points, these values can be overwritten to what you need by |bwinpoints=, |swinpoints=, |slosspoints= and |blosspoints=. Teams can also start the season with bonus or penalty points, this can be included by using |adjust_points_TTT= for that specific team.
Alternatively teams can also be ranked by points (set |ranking_style=points to bold that row instead) Modul:Sports table/styledoc
-- Style for volleyball tables
local pp = {}
function pp.header(t,Args,p_sub,pos_label,group_col,VTE_text,full_table,results_header_txt)
-- Load relevant modules
local yesno = require('Module:Yesno')
-- Create table header
-- Pre stuff
local team_width = Args['teamwidth'] or '170'
local sort_text = yesno(Args['sortable_table'] or 'no') and 'sortable' or ''
local show_played = not yesno(Args['hide_played'] or 'no')
local show_sets = yesno(Args['show_sets'] or 'yes')
local show_setpoints = yesno(Args['show_setpoints'] or 'yes')
local setpoints_first = yesno(Args['setpoints_before_sets'] or 'no')
-- Custom header
local group_head_text = Args['group_header'] or '<abbr title="Group">Grp</abbr>'
table.insert(t,'{|class="wikitable '..sort_text..'" style="text-align:center;"\n') -- Open table
-- Initialize
local tt = {}
tt.count = 0 -- Up by one after every call
tt.tab_text = t -- Actual text
-- Actual headers
if pos_label ~= nil then
tt = p_sub.colhead(tt,28,pos_label) -- Position col
end
-- Add group header
if full_table and group_col then
tt = p_sub.colhead(tt,28,group_head_text) -- Group col
end
tt = p_sub.colhead(tt,team_width,'Lag'..VTE_text) -- Team col
if show_played then
tt = p_sub.colhead(tt,28,'<abbr title="Matcher spelade">M</abbr>') -- Matches played col
end
if full_table then
tt = p_sub.colhead(tt,28,'<abbr title="Vunna">V</abbr>') -- Win col
tt = p_sub.colhead(tt,28,'<abbr title="Förlorade">F</abbr>') -- Loss col
end
tt = p_sub.colhead(tt,28,'<abbr title="Poäng">P</abbr>') -- Points col
if full_table then
if setpoints_first then
if show_setpoints then
tt = p_sub.colhead(tt,32,'<abbr title="Bollar vunna">BV</abbr>') -- Setpoints won col
tt = p_sub.colhead(tt,32,'<abbr title="Bollar förlorade">BF</abbr>') -- Setpoints lost col
tt = p_sub.colhead(tt,36,'<abbr title="Bollkvot">BK</abbr>') -- Setpoint ratio col
end
if show_sets then
tt = p_sub.colhead(tt,28,'<abbr title="Set vunna">SV</abbr>') -- Sets won col
tt = p_sub.colhead(tt,28,'<abbr title="Set förlorade">SF</abbr>') -- Sets lost col
tt = p_sub.colhead(tt,36,'<abbr title="Setkvot">SK</abbr>') -- Set ratio col
end
else
if show_sets then
tt = p_sub.colhead(tt,28,'<abbr title="Set vunna">SV</abbr>') -- Sets won col
tt = p_sub.colhead(tt,28,'<abbr title="Set förlorade">SF</abbr>') -- Sets lost col
tt = p_sub.colhead(tt,36,'<abbr title="Setkvot">SK</abbr>') -- Set ratio col
end
if show_setpoints then
tt = p_sub.colhead(tt,32,'<abbr title="Bollar vunna">BV</abbr>') -- Setpoints won col
tt = p_sub.colhead(tt,32,'<abbr title="Bollar förlorade">BF</abbr>') -- Setpoints lost col
tt = p_sub.colhead(tt,36,'<abbr title="Bollkvot">BK</abbr>') -- Setpoint ratio col
end
end
end
if full_table then
tt.count = tt.count+1
table.insert(tt.tab_text,results_header_txt)
end
return tt
end
function pp.row(frame,t,Args,p_sub,notes_exist,hth_id_list,full_table,rand_val,team_list,team_code_ii,ii_start,ii_end,ii_fw,bg_col,N_teams,ii,ii_show)
-- Build the inner parts of individual rows
-- Sub-module usage
local mm = require('Module:Math')
local yesno = require('Module:Yesno')
-- Get custom/default options for in table
local bwin_points = tonumber(Args['bwinpoints']) or 3
local swin_points = tonumber(Args['swinpoints']) or 2
local sloss_points = tonumber(Args['slosspoints']) or 1
local bloss_points = tonumber(Args['blosspoints']) or 0
-- Get some input
local bigwins = tonumber(Args['bwin_'..team_code_ii]) or 0
local smallwins = tonumber(Args['swin_'..team_code_ii]) or 0
local biglosses = tonumber(Args['bloss_'..team_code_ii]) or 0
local smallosses = tonumber(Args['sloss_'..team_code_ii]) or 0
local setswon = tonumber(Args['sw_'..team_code_ii]) or 0
local setslost = tonumber(Args['sl_'..team_code_ii]) or 0
local setpointswon = tonumber(Args['spw_'..team_code_ii]) or 0
local setpointslost = tonumber(Args['spl_'..team_code_ii]) or 0
local s_pts = tonumber(Args['adjust_points_'..team_code_ii]) or tonumber(Args['startpoints_'..team_code_ii]) or 0
local hth_local = Args['hth_'..team_code_ii] or nil
-- default values for win3/4/5 and loss3/4/5 unless override
local win_points = {0,0,
tonumber(Args['win3points']) or bwin_points,
tonumber(Args['win4points']) or bwin_points,
tonumber(Args['win5points']) or swin_points
}
local loss_points = {0,0,
tonumber(Args['loss3points']) or bloss_points,
tonumber(Args['loss4points']) or bloss_points,
tonumber(Args['loss5points']) or sloss_points
}
-- Then calculate some values
local matches = bigwins + smallwins + biglosses + smallosses
local points = bwin_points*bigwins + swin_points*smallwins + sloss_points*smallosses + bloss_points*biglosses + s_pts
local wins = bigwins + smallwins
local losses = biglosses + smallosses
-- Optional automatic calculation of wins, losses, sets won, and sets lost
local auto_sets = false
local double_set_count = false
for k=3,5 do
local wink = tonumber(Args['win'..k..'s_'..team_code_ii]) or 0
local lossk = tonumber(Args['loss'..k..'s_'..team_code_ii]) or 0
if (wink > 0) or (lossk > 0) then
if auto_sets == false then
if (setswon > 0) or (setslost > 0) or (wins > 0) or (losses > 0) then
double_set_count = true
end
end
auto_sets = true
end
wins = wins + wink
setswon = setswon + 3*wink
setslost = setslost + (k-3)*wink
points = points + win_points[k]*wink
losses = losses + lossk
setslost = setslost + 3*lossk
setswon = setswon + (k-3)*lossk
points = points + loss_points[k]*lossk
matches = matches + wink + lossk
end
-- Some local vars
local hth_string
local tt_return = p_sub.hth(frame,Args,full_table,hth_id_list,hth_local,notes_exist,team_list,team_code_ii,ii_start,ii_end,rand_val)
hth_string = tt_return.str
hth_id_list = tt_return.list
notes_exist = tt_return.notes_exist
-- What to rank the teams by
local ranking_style = Args['ranking_style'] or 'wins'
local win_fw, win_string, pts_fw, pts_string
ranking_style = string.lower(ranking_style)
if ranking_style=='p' or ranking_style=='pts' or ranking_style=='points' then
-- Based on points
win_fw=ii_fw
win_string = ''
pts_fw = 'font-weight: bold;'
pts_string = hth_string
elseif ranking_style=='none' then
win_fw=ii_fw
win_string = ''
pts_fw=ii_fw
pts_string = ''
else
-- Based on wins
win_fw = 'font-weight: bold;'
win_string = hth_string
pts_fw=ii_fw
pts_string = ''
end
-- Show games played, sets, and setpoints
local show_played = not yesno(Args['hide_played'] or 'no')
local show_sets = yesno(Args['show_sets'] or 'yes')
local show_setpoints = yesno(Args['show_setpoints'] or 'yes')
local setpoints_first = yesno(Args['setpoints_before_sets'] or 'no')
-- Set ratio
local sratio
if setslost == 0 then
sratio = setswon > 0 and 'MAX' or '—'
else
sratio = mm._precision_format(setswon / setslost, 3)
end
-- Setpoint ratio
local spratio
if setpointslost == 0 then
spratio = setpointswon > 0 and 'MAX' or '—'
else
spratio = mm._precision_format(setpointswon / setpointslost, 3)
end
-- Now that we are done calculating, show actual input values
if tonumber(Args['bwin_'..team_code_ii] or 0) == nil or tonumber(Args['swin_'..team_code_ii] or 0) == nil then
wins = '—'
end
if tonumber(Args['bloss_'..team_code_ii] or 0) == nil or tonumber(Args['sloss_'..team_code_ii] or 0) == nil then
losses = '—'
end
local function numorval(s)
return s and ((s == '' and 0) or tonumber(s) or s) or 0
end
if auto_sets == false then
setswon = numorval(Args['sw_'..team_code_ii])
setslost = numorval(Args['sl_'..team_code_ii])
end
setpointswon = numorval(Args['spw_'..team_code_ii])
setpointslost = numorval(Args['spl_'..team_code_ii])
-- Row building
if show_played then
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..matches..'\n') -- Played
end
if full_table then
table.insert(t,'| style="'..win_fw..bg_col..'" |'..wins..win_string..'\n') -- Won
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..losses..'\n') -- Lost
end
if points<0 then
table.insert(t,'| style="'..pts_fw..bg_col..'" | −'..-points..pts_string..'\n')
else
table.insert(t,'| style="'..pts_fw..bg_col..'" | '..points..pts_string..'\n')
end
if full_table then
if setpoints_first then
if show_setpoints then
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..setpointswon..'\n') -- SPW
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..setpointslost..'\n') -- SPL
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..spratio..'\n') -- Setpoint ratio
end
if show_sets then
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..setswon..'\n') -- SW
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..setslost..'\n') -- SL
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..sratio..'\n') -- Set ratio
end
else
if show_sets then
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..setswon..'\n') -- SW
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..setslost..'\n') -- SL
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..sratio..'\n') -- Set ratio
end
if show_setpoints then
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..setpointswon..'\n') -- SPW
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..setpointslost..'\n') -- SPL
table.insert(t,'| style="'..ii_fw..bg_col..'" |'..spratio..'\n') -- Setpoint ratio
end
end
end
local max_sets_per_match = ((tonumber(Args['best_of']) or 5) + 1) / 2
if ( ((tonumber(setswon) or 0) > (max_sets_per_match*matches)) or ((tonumber(setslost) or 0) > (max_sets_per_match*matches))) then
table.insert(t, '[[Kategori:Sidor med felaktigt antal set vid anrop till modulen Sports table/Volleyball|A]]\n')
elseif ( ((tonumber(setpointswon) or 0) > 0) and ((tonumber(setpointswon) or 0) < (tonumber(setswon) or 0)) ) then
table.insert(t, '[[Kategori:Sidor med felaktigt antal set vid anrop till modulen Sports table/Volleyball|B]]\n')
elseif ( ((tonumber(setpointslost) or 0) > 0) and ((tonumber(setpointslost) or 0) < (tonumber(setslost) or 0)) ) then
table.insert(t, '[[Kategori:Sidor med felaktigt antal set vid anrop till modulen Sports table/Volleyball|C]]\n')
end
if double_set_count then
table.insert(t, '[[Kategori:Sidor med felaktigt antal set vid anrop till modulen Sports table/Volleyball|Dubbla set]]\n')
end
return {t=t, notes_exist=notes_exist, hth_id_list=hth_id_list}
end
function pp.status(Args)
-- Declare status options
-- ------------------------------------------------------------
-- NOTE: If you add to status_code, also add to status_called and status_letters!!
-- Or functionality will be compromised
-- ------------------------------------------------------------
local status_code, status_called = {}, {}
status_code = { A='Vidare till nästa runda', C='Mästare', D='Diskvalifierad',
E='Utslagen', H='Värd', O='Play-off vinnare', P='Uppflyttad', Q='Qualified for the phase indicated',
R='Nedflyttad', T='Qualified, but not yet for the particular phase indicated'}
local status_letters = (Args['status_order'] or '') .. 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'
-- Status position (before or after read and default)
local stat_pos_val = string.lower(Args['status_pos'] or '')
local status_position = 'after' -- Default location
if stat_pos_val=='before' then
status_position = 'before'
elseif stat_pos_val=='after' then
status_position = 'after'
end
-- Read in custom status options
for l in mw.text.gsplit(status_letters, '') do
status_called[l] = false
status_code[l] = status_code[l] or '?'
status_letters = mw.ustring.gsub(status_letters, '(' .. l ..'.-)' .. l, '%1')
if Args['status_text_' .. l] then
status_code[l] = Args['status_text_' .. l]
end
end
return {code=status_code, called=status_called, letters=status_letters, position=status_position}
end
return pp