יחידה:סקירת סדרה
ניתן ליצור תיעוד על היחידה הזאת בדף יחידה:סקירת סדרה/תיעוד
-- This module implements {{Series overview}}.
require('Module:No globals')
local yesno = require('Module:Yesno')
local HTMLcolor = mw.loadData( 'Module:Color contrast/colors' )
--------------------------------------------------------------------------------
-- SeriesOverview class
-- The main class.
--------------------------------------------------------------------------------
local SeriesOverview = {}
function SeriesOverview.cellspan(SeasonEntries, SeasonEntries_ordered, key, cell, multipart, setspan)
if setspan ~= nil then return setspan end
local spanlength = 1
local firstEntry = SeasonEntries[SeasonEntries_ordered[cell]]
if key == 'network' and firstEntry.networkA and not firstEntry.networkB then spanlength = 2 end
for i = cell+1, #SeasonEntries_ordered do
local entry = SeasonEntries[SeasonEntries_ordered[i]]
-- Split season, then regular season
if entry.startA then
if not entry[key..'A'] then spanlength = spanlength + 1
else break end
if not entry[key..'B'] then spanlength = spanlength + 1
else break end
if not entry[key..'C'] then spanlength = spanlength + 1
else break end
else
if not entry[key] and (key == 'network' or ((string.sub(key,0,7) == 'postaux' or string.sub(key,0,3) == 'aux') and (not entry.special or entry.episodes)) or (string.sub(key,0,4) == 'info') and multipart) then
spanlength = spanlength + 1
else break end
end
end
return spanlength
end
-- Sorting function
function SeriesOverview.series_sort(op1, op2)
local n1,s1 = string.match(op1,"(%d+)(%a*)")
local n2,s2 = string.match(op2,"(%d+)(%a*)")
local n1N,n2N = tonumber(n1),tonumber(n2)
if n1N == n2N then
return s1 < s2
else
return n1N < n2N
end
end
-- Function to add either text or {{N/a}} to cell
function SeriesOverview.season_cell(text, frame)
local cell
if string.find(text or '', 'table-na', 0, true) ~= nil then
local findpipe = string.find(text, ' | ', 0, true)
if findpipe ~= nil then
cell = SeriesOverview.series_attributes( frame:expandTemplate{title='N/a',args={string.sub(text,findpipe+3)}} )
else
cell = SeriesOverview.series_attributes( frame:expandTemplate{title='N/a'} )
end
else
cell = mw.html.create('td'):wikitext(text)
end
return cell
end
-- Allow usages of {{N/A}} cells
function SeriesOverview.series_attributes(infoParam)
local entries = {}
local infoCell = mw.html.create('td')
local attrMatch = '([%a-]*)="([^"]*)"'
while true do
local a,b = string.match(infoParam,attrMatch)
if a == nil or b == nil then break end
infoCell:attr(a,b)
infoParam = string.gsub(infoParam,attrMatch,'',1)
end
infoParam = string.gsub(infoParam,'%s*|%s*','',1)
infoCell:wikitext(infoParam)
return infoCell
end
function SeriesOverview.new(frame, args)
args = args or {}
local initialArticle = args['1'] or ''
local categories = ''
local title = mw.title.getCurrentTitle()
local allReleased = yesno(args.allreleased)
-- Create series overview table
local root = mw.html.create((args.multiseries or not args.series) and 'table' or '')
local cellPadding = '0 8px'
local basePadding = '0.2em 0.4em'
root
:addClass('wikitable')
:addClass('plainrowheaders')
:css('text-align', 'center')
-- Sortable
if args.sortable then
root:addClass('sortable');
end
-- Width
if args.width then
root:css('width', args.width)
end
-- Caption
if args.caption then
root:attr('aria-label', args.caption)
-- root:tag('caption'):wikitext(frame:expandTemplate{title='Screen reader-only',args={args.caption}})
end
-- Extract seasons info and place into a 3D array
local SeasonEntries = {}
for k,v in pairs(args) do
local str, num, str2 = string.match(k, '([^%d]*)(%d*)([%a]*)')
if num ~= '' then
-- Special
local special = false
if string.sub(str2,1,1) == 'S' then
special = true
num = num .. str2
str2 = ''
end
-- Add to entries, create if necessary
if not SeasonEntries[num] then
SeasonEntries[num] = {}
end
SeasonEntries[num][str .. str2] = v
if special then
SeasonEntries[num]['special'] = 'y'
end
end
end
-- Order table by season number
local SeasonEntries_ordered = {}
for k in pairs(SeasonEntries) do
table.insert(SeasonEntries_ordered, k)
end
table.sort(SeasonEntries_ordered,SeriesOverview.series_sort)
local firstRow = args.multiseries and {} or SeasonEntries[SeasonEntries_ordered[1]]
-- Colspan calculation for information cells (0 = no info set)
local numAuxCells = 0
local numInfoCells = 0
for i = string.byte('A'), string.byte('Z') do
local param = 'info' .. string.char(i)
if args[param] then numInfoCells = numInfoCells + 1 end
end
-- Use of colors
local noColors = true
for i = 1, #SeasonEntries_ordered do
local season, entry = SeasonEntries_ordered[i], SeasonEntries[SeasonEntries_ordered[i]]
for j0 = string.byte('A')-1, string.byte('Z') do
local j = string.char(j0)
if j0 == string.byte('A')-1 then j = '' end
if entry['color' .. j] then noColors = false end
end
end
-- Top info cellfirstRow
-- @ = string.char(64), A = string.char(65)
local topInfoCell = numInfoCells > 0 and string.char(numInfoCells + (string.byte('A') - 1)) or '@'
-- Networks are included if the very first entry sets the first network
local setNetwork = (args.multiseries and args.network) or firstRow.network or firstRow.networkA
local networkTransclude = args.network_transclude
if (networkTransclude == 'onlyinclude' and title.fullText == initialArticle) or (networkTransclude == 'noinclude' and title.fullText ~= initialArticle) then
setNetwork = false
end
-- Headers
do
if args.multiseries or not args.series then
local headerRow = root:tag('tr')
headerRow
:css('text-align', 'center')
local releasedBlurb = args.released and 'הוזרמה' or 'שודרה'
-- Base series/season content on the format of the first date; Series = D M Y, Season = M D, Y
local matchDMY = false
local thisStart = firstRow.start or firstRow.startA
if thisStart then
if string.match(thisStart:gsub(" "," "), '(%d+)%s(%a+)%s(%d+)') then
matchDMY = true
end
end
-- Multiple series header
if args.multiseries then
headerRow:tag('th')
:attr('scope', 'col')
:css('padding', cellPadding)
:attr('rowspan', allReleased and 1 or 2)
:wikitext('סדרה')
end
-- Season header
headerRow:tag('th')
:attr('scope', 'col')
:attr('rowspan', allReleased and 1 or 2)
:attr('colspan', (not args.multiseries and noColors) and 1 or 2)
:css('min-width', '50px')
:css('padding', cellPadding)
:wikitext(args.seriesT or args.seasonT or (matchDMY and 'סדרה') or 'עונה')
for _a = 1, 3 do
if _a == 1 or _a == 3 then
-- Aux headers
local auxtype = (_a == 3 and 'post' or '') .. 'aux'
for i = string.byte('A'), string.byte('Z') do
local param = auxtype .. string.char(i)
if args[param] then
numAuxCells = numAuxCells + 1
headerRow:tag('th')
:attr('scope', 'col')
:css('padding', cellPadding)
:attr('rowspan', allReleased and 1 or 2)
:wikitext(args[param])
end
end
end
if _a == 2 then
-- Episodes header
headerRow:tag('th')
:attr('scope', 'col')
:attr('rowspan', allReleased and 1 or 2)
:attr('colspan', 2)
:css('padding', cellPadding)
:wikitext('פרקים')
end
end
-- Originally aired header
local OriginallyColspan = (not allReleased and setNetwork) and 3 or 2
local countryBlurb = ''
if args.country then
countryBlurb = ' (' .. args.country .. ')'
end
headerRow:tag('th')
:attr('scope', 'col')
:attr('colspan', OriginallyColspan)
:wikitext(releasedBlurb .. ' לראשונה' .. countryBlurb)
-- Network subheader for released series
if setNetwork and allReleased then
headerRow:tag('th')
:attr('scope', 'col')
:attr('rowspan', allReleased and 1 or 2)
:css('padding', cellPadding)
:wikitext('רשת שידור')
end
-- Information headers
if topInfoCell ~= '@' then
for i = string.byte('A'), string.byte(topInfoCell) do
local param = 'info' .. string.char(i)
local infoTransclude = args[param .. '_transclude']
if (infoTransclude == 'onlyinclude' and title.fullText == initialArticle) or (infoTransclude == 'noinclude' and title.fullText ~= initialArticle) then else
headerRow:tag('th')
:attr('scope', 'col')
:attr('rowspan', allReleased and 1 or 2)
:css('padding', cellPadding)
:wikitext(args[param])
end
end
end
-- Subheader row
local subheaderRow = mw.html.create('tr')
if not allReleased then
-- First aired subheader
subheaderRow:tag('th')
:attr('scope', 'col')
:wikitext('הפרק הראשון')
-- Last aired subheader
subheaderRow:tag('th')
:attr('scope', 'col')
:wikitext('הפרק האחרון')
-- Network subheader for aired series
if setNetwork then
subheaderRow:tag('th')
:attr('scope', 'col')
:css('padding', cellPadding)
:wikitext('רשת שידור')
end
end
-- Check for scenarios with an empty subheaderRow
if not allReleased or numInfoCells > 0 then
root:node(subheaderRow)
end
end
end
-- Season rows
do
if args.multiseries then
-- Multi series individual entries
if args.multiseries ~= "y" then
root:node(args.multiseries)
end
else
-- One row entries, only categorized in the mainspace
if title.namespace == 0 and #SeasonEntries == 1 then
categories = categories .. '[[קטגוריה:דפים שמשתמשים בתבנית:סקירת יחידה עם שורה אחת בלבד]]'
end
-- Determine number of rows in the whole overview
local SeasonEntriesRows = 0
for X = 1, #SeasonEntries_ordered do
local season, entry = SeasonEntries_ordered[X], SeasonEntries[SeasonEntries_ordered[X]]
local splits = 0
for i = string.byte('A'), string.byte('Z') do
local param = 'start' .. string.char(i)
if entry[param] then splits = splits + 1 end
end
if splits == 0 then splits = 1 end
SeasonEntriesRows = SeasonEntriesRows + splits
end
for X = 1, #SeasonEntries_ordered do
local season, entry = SeasonEntries_ordered[X], SeasonEntries[SeasonEntries_ordered[X]]
-- Determine number of splits in a season
local splits = 0
for i = string.byte('A'), string.byte('Z') do
local param = 'start' .. string.char(i)
if entry[param] then splits = splits + 1 end
end
local splitSeason = (splits > 1)
-- Season rows for each season
for k0 = string.byte('A')-1, string.byte('Z') do
local k = string.char(k0)
if k0 == string.byte('A')-1 then k = '' end
-- New season row
-- local seasonRow = (entry['color' .. k] or entry['episodes' .. k] or entry['start' .. k] or entry['end' .. k]) and root:tag('tr') or mw.html.create('tr')
local seasonRow = entry['start' .. k] and root:tag('tr') or mw.html.create('tr')
-- Part header
if entry.part then
seasonRow:node(entry.part)
end
-- Series name for group overviews
if X == 1 and (k == '' or k == 'A') and args.series then
seasonRow:tag('th')
:attr('scope', 'row')
:attr('rowspan', SeasonEntriesRows)
:wikitext(args.series)
end
-- Colored cell
if not noColors then
if entry['color' .. k] ~= nil and HTMLcolor[entry['color' .. k]] == nil then
entry['color' .. k] = '#'..(mw.ustring.match(entry['color' .. k], '^[%s#]*([a-fA-F0-9]*)[%s]*$') or '')
end
if splitSeason and entry.color then
if k == 'A' then
seasonRow:tag('td')
:attr('rowspan', entry.color and splits or 1)
:css('background', entry.color)
:css('width','10px')
end
else
seasonRow:tag('td')
:css('background',entry['color' .. k])
:css('width','10px')
end
end
-- Season number link, included only in the first row
if k == '' or k == 'A' then
seasonRow:tag(args.series and 'td' or 'th')
:attr('scope', 'row')
:attr('rowspan', splitSeason and splits or nil)
:attr('colspan', entry.special and not entry.episodes and 3+numAuxCells or 1)
:css('text-align', 'center')
:wikitext((entry.link and '[[' .. entry.link .. '|' .. (entry.linkT or season) .. ']]' or (entry.linkT or season)) .. (entry.linkR or ''))
end
for _a = 1, 3 do
if _a == 1 or _a == 3 then
-- Aux headers
local auxtype = (_a == 3 and 'post' or '') .. 'aux'
-- Aux cells
for i = string.byte('A'), string.byte('Z') do
local param = auxtype .. string.char(i)
if entry[param .. k] then
local thisCell = SeriesOverview.season_cell(entry[param .. k], frame)
:attr('scope', 'col')
:attr('rowspan', SeriesOverview.cellspan(SeasonEntries, SeasonEntries_ordered, param, X, (args.series and true or false), entry[param .. k .. 'span'] or nil))
:css('padding', cellPadding)
seasonRow:node(thisCell)
end
end
end
if _a == 2 then
-- Episodes counts
if ((splitSeason and k == 'A' and (entry.episodes ~= 'hide' and entry.episodes ~= 'הסתר')) or not splitSeason) then
if entry.episodes then
local thisCell = SeriesOverview.season_cell(entry.episodes, frame)
:attr('colspan', splitSeason and 1 or 2)
:attr('rowspan', splitSeason and splits or nil)
seasonRow:node(thisCell)
elseif not entry.special then
local infoCell = SeriesOverview.series_attributes( frame:expandTemplate{title='N/a',args={'—'}} )
infoCell
:attr('colspan', splitSeason and 1 or 2)
:attr('rowspan', splitSeason and splits or nil)
seasonRow:node(infoCell)
end
end
if splitSeason then
if entry['episodes' .. k] then
local thisCell = SeriesOverview.season_cell(entry['episodes' .. k], frame)
:attr('colspan', (entry.episodes ~= 'hide' and entry.episodes ~= 'הסתר') and 1 or 2)
seasonRow:node(thisCell)
else
local infoCell = SeriesOverview.series_attributes( frame:expandTemplate{title='N/a',args={'—'}} )
:attr('colspan', (entry.episodes ~= 'hide' and entry.episodes ~= 'הסתר') and 1 or 2)
seasonRow:node(infoCell)
end
end
end
end
-- Start date
if entry['start' .. k] then
local thisCell = SeriesOverview.season_cell(entry['start' .. k], frame)
:attr('colspan',((not entry.special and (entry['end' .. k] == 'start' or entry['end' .. k] == 'רצף')) or (entry.special and not entry['end' .. k]) or allReleased) and 2 or 1)
:css('padding',basePadding)
seasonRow:node(thisCell)
else
local infoCell = SeriesOverview.series_attributes( frame:expandTemplate{title='N/a',args={'—'}} )
infoCell:css('padding',basePadding)
seasonRow:node(infoCell)
end
-- End date
if not allReleased and (entry['end' .. k] ~= 'start' and entry['end' .. k] ~= 'רצף') and ((entry.special and entry['end' .. k]) or not entry.special) then
if entry['end' .. k] then
local thisCell = SeriesOverview.season_cell(entry['end' .. k], frame)
:css('padding',cellPadding)
seasonRow:node(thisCell)
else
local infoCell = SeriesOverview.series_attributes( frame:expandTemplate{title='N/a',args={'—'}} )
infoCell:css('padding',cellPadding)
seasonRow:node(infoCell)
end
end
-- Network
if entry['network' .. k] and setNetwork then
local thisCell = SeriesOverview.season_cell(entry['network' .. k], frame)
:attr('rowspan', SeriesOverview.cellspan(SeasonEntries, SeasonEntries_ordered, 'network', X, (args.series and true or false), entry['network' .. k .. 'span'] or nil))
seasonRow:node(thisCell)
end
-- Information
for i = string.byte('A'), string.byte(topInfoCell) do
local param0 = 'info' .. string.char(i)
local param = 'info' .. string.char(i) .. k
local infoTransclude = args[param .. '_transclude']
if (infoTransclude == 'onlyinclude' and title.fullText == initialArticle) or (infoTransclude == 'noinclude' and title.fullText ~= initialArticle) then else
local infoParam = entry[param]
if infoParam and splitSeason and k == '' and not entry[param .. 'A'] then
entry[param .. 'A'] = entry[param]
entry[param .. 'spanning'] = 'y'
end
local rowspan = (entry[param0 .. 'spanning'] and splits) or
(args.series and SeriesOverview.cellspan(SeasonEntries, SeasonEntries_ordered, param0, X, (args.series and true or false), entry[param0 .. 'span'] or nil))
or nil
if k == 'A' or (k ~= 'A' and not entry[param0 .. 'spanning']) then
-- Cells with {{N/A|...}} already expanded
if infoParam then
if string.sub(infoParam,1,5) == 'style' then
local infoCell = SeriesOverview.series_attributes(infoParam)
infoCell:attr('rowspan', rowspan)
seasonRow:node(infoCell)
else
-- Unstyled content info cell
local thisCell = SeriesOverview.season_cell(infoParam, frame)
:attr('rowspan', rowspan)
seasonRow:node(thisCell)
end
else
if not args.series then
local infoCell = SeriesOverview.series_attributes( frame:expandTemplate{title='N/a',args={'—'}} )
infoCell:attr('rowspan', rowspan)
seasonRow:node(infoCell)
end
end
elseif not entry[param0 .. 'spanning'] then
if not args.series then
local infoCell = SeriesOverview.series_attributes( frame:expandTemplate{title='N/a',args={'—'}} )
infoCell:attr('rowspan', rowspan)
seasonRow:node(infoCell)
end
end
end
end
end -- End k0 string.byte
end -- End 'for' SeasonEntries_ordered
end -- End 'if' multiseries
end -- End 'do' season rows
return (args.dontclose and mw.ustring.gsub(tostring(root), "</table>", "") or tostring(root)) .. categories
end
--------------------------------------------------------------------------------
-- Exports
--------------------------------------------------------------------------------
local p = {}
-- Populate the series overview from wikidata items
local function SeriesOverviewWikidata(frame)
local args = {}
local entityId = mw.wikibase.getEntityIdForCurrentPage()
local series = mw.wikibase.getBestStatements(entityId, 'P527')
if #series == 0 then return end -- doesn't have related wikidata item with this property
local seriesNum = 0
for _,v in pairs(series) do
seriesNum = seriesNum + 1
local seriesEpisodes = mw.wikibase.getBestStatements(v.mainsnak.datavalue.value.id, 'P1113')
if #seriesEpisodes>0 then
args['episodes'..seriesNum] = mw.wikibase.renderSnak(seriesEpisodes[1].mainsnak)
else
local seriesEpisodesInfo = mw.wikibase.getBestStatements(v.mainsnak.datavalue.value.id, 'P527')
if #seriesEpisodesInfo>0 then
args['episodes'..seriesNum] = #seriesEpisodesInfo
end
end
local startInfo = mw.wikibase.getBestStatements(v.mainsnak.datavalue.value.id, 'P580')
local endInfo = mw.wikibase.getBestStatements(v.mainsnak.datavalue.value.id, 'P582')
if #startInfo==0 then error('Missing P580 in ' .. v.mainsnak.datavalue.value.id) end
if #endInfo==0 then error('Missing P582 in ' .. v.mainsnak.datavalue.value.id) end
if #startInfo>0 and #endInfo>0 then
args['start'..seriesNum] = mw.wikibase.renderSnak(startInfo[1].mainsnak)
args['end'..seriesNum] = mw.wikibase.renderSnak(endInfo[1].mainsnak)
else
local seriesBroadInfo = mw.wikibase.getBestStatements(v.mainsnak.datavalue.value.id, 'P449')
if #seriesBroadInfo>0 and seriesBroadInfo[1].qualifiers and seriesBroadInfo[1].qualifiers['P580'] then
args['start'..seriesNum] = mw.wikibase.renderSnak(seriesBroadInfo[1].qualifiers['P580'][1])
end
if #seriesBroadInfo>0 and seriesBroadInfo[1].qualifiers and seriesBroadInfo[1].qualifiers['P582'] then
args['end'..seriesNum] = mw.wikibase.renderSnak(seriesBroadInfo[1].qualifiers['P582'][1])
end
end
end
local cat = '[[קטגוריה:דפים עם סקירת סדרה מוויקינתונים]]'
return SeriesOverview.new(frame, args)..cat
end
function p.main(frame)
local args = require('Module:Arguments').getArgs(frame)
-- translate params
local translatedParams = {};
local numArgs = 0
for k,v in pairs(args) do
if mw.ustring.match(k, '[א-ת]') ~=nil then
local enKey = mw.ustring.gsub( k, 'צבע ', 'color' )
enKey = mw.ustring.gsub( enKey, 'ארץ השידור', 'country' )
enKey = mw.ustring.gsub( enKey, 'מספר פרקים ', 'episodes' )
enKey = mw.ustring.gsub( enKey, 'תאריך פרק ראשון ', 'start' )
enKey = mw.ustring.gsub( enKey, 'תאריך פרק אחרון ', 'end' )
enKey = mw.ustring.gsub( enKey, 'תווית', 'caption' )
enKey = mw.ustring.gsub( enKey, 'פרקים ', 'episodes' )
enKey = mw.ustring.gsub( enKey, 'זיכיון', 'multiseries' )
enKey = mw.ustring.gsub( enKey, 'כותרת עונה', 'seasonT' )
enKey = mw.ustring.gsub( enKey, 'כותרת סדרה', 'seriesT' )
enKey = mw.ustring.gsub( enKey, 'סדרה ', 'series' )
enKey = mw.ustring.gsub( enKey, 'לא לסגור', 'dontclose' )
enKey = mw.ustring.gsub( enKey, 'ראשון ', 'start' )
enKey = mw.ustring.gsub( enKey, 'אחרון ', 'end' )
enKey = mw.ustring.gsub( enKey, 'מדינה', 'country' )
enKey = mw.ustring.gsub( enKey, 'רשת ', 'network' )
enKey = mw.ustring.gsub( enKey, 'הערת קישור ', 'linkR' )
enKey = mw.ustring.gsub( enKey, 'כותרת קישור ', 'linkT' )
enKey = mw.ustring.gsub( enKey, 'קישור ', 'link' )
enKey = mw.ustring.gsub( enKey, 'אחרי ', 'postaux' )
enKey = mw.ustring.gsub( enKey, 'לפני ', 'aux' )
enKey = mw.ustring.gsub( enKey, 'מידע ', 'info' )
enKey = mw.ustring.gsub( enKey, ' פרישה ', 'span' )
enKey = mw.ustring.gsub( enKey, 'שוחרר', 'allreleased' )
enKey = mw.ustring.gsub( enKey, 'הזרמה', 'released' )
-- enKey = mw.ustring.gsub( enKey, '_הכלל', '_transclude' )
enKey = mw.ustring.gsub( enKey, ' ספיישל ', 'S' )
enKey = mw.ustring.gsub( enKey, ' ספיישל', 'S' )
enKey = mw.ustring.gsub( enKey, 'כותרת ', 'T' )
numArgs = numArgs + 1
translatedParams[enKey] = v
else
numArgs = numArgs + 1
translatedParams[k] = v
end
end
-- Translate ordinal Hebrew letters
local translatedArgs = {};
for k,v in pairs(translatedParams) do
if mw.ustring.match(k, '[א-ת]') ~=nil then
local enKey = mw.ustring.gsub( k, 'א', 'A' )
-- Match the first ordinal Hebrew letter with the first ordinal Latin letter
local diff = mw.ustring.codepoint('א') - mw.ustring.codepoint('A')
for i = mw.ustring.codepoint('ב'), mw.ustring.codepoint('ת') do
-- Final forms Hebrew letters are not used as ordinal, therefore skip them
if not mw.ustring.match(mw.ustring.char(i), '[םןץףך]') then
-- S & T letters are saved for special use, therefore skip them
if mw.ustring.char(i-diff) == 'S' then diff = diff - 2 end
-- Replace ordinal Hebrew letter with corresponding ordinal Latin letter
enKey = mw.ustring.gsub( enKey, mw.ustring.char(i), mw.ustring.char(i-diff) )
else
-- When a final form Hebrew letter is skipped, hold current ordinal Latin letter
diff = diff + 1
end
end
numArgs = numArgs + 1
translatedArgs[enKey] = v
else
numArgs = numArgs + 1
translatedArgs[k] = v
end
end
if numArgs ==0 then
-- populate from wikidata if possible
return SeriesOverviewWikidata(frame)
else
return SeriesOverview.new(frame, translatedArgs)
end
end
return p