Seeds of the Word

Module:Track listing: Difference between revisions

Browse history interactively
← Older editNewer edit →
Content deleted Content added
m 1 revision imported
rm non-working code related to the collapsed parameter; deprecated parameter checking can be implemented in the template easily
Line 1:
-- This module implements [[Template:Track listing]]
 
local yesno = require('Module:Yesno')
local checkType = require('libraryUtil').checkType
local cfg = mw.loadData('Module:Track listing/configuration')
 
local SHOW_WARNINGS = false
local INPUT_ERROR_CATEGORY = 'Track listings with input errors'
local COLLAPSED_PARAMETER_CATEGORY = 'Track listings that use the collapsed parameter '
 
--------------------------------------------------------------------------------
Line 64 ⟶ 59:
if hours and hours:sub(1, 1) == '0' then
-- Disallow times like "0:12:34"
self:addWarning(string.format(
string.format(cfg.leading_0_in_hours, mw.text.nowiki(length)),
"Invalid time '%s' (times in format 'h:mm:ss' cannot start with zero)",
cfg.input_error_category
mw.text.nowiki(length)
)
), INPUT_ERROR_CATEGORY)
return nil
end
Line 77 ⟶ 72:
-- Special case to disallow lengths like "01:23". This check has to
-- be here so that lengths like "1:01:23" are still allowed.
self:addWarning(string.format(
string.format(cfg.leading_0_in_minutes, mw.text.nowiki(length)),
"Invalid time '%s' (times in format 'mm:ss' cannot start with zero)",
cfg.input_error_category
mw.text.nowiki(length)
)
), INPUT_ERROR_CATEGORY)
return nil
end
Line 87 ⟶ 82:
-- Add a warning and return if we did not find a match.
if not seconds then
self:addWarning(string.format(
string.format(cfg.not_a_time, mw.text.nowiki(length)),
"Invalid time '%s' (times must be in a format of 'm:ss', 'mm:ss' or 'h:mm:ss')",
cfg.input_error_category
mw.text.nowiki(length)
)
), INPUT_ERROR_CATEGORY)
return nil
end
Line 96 ⟶ 91:
-- Check that the minutes are less than 60 if we have an hours field.
if hours and tonumber(minutes) >= 60 then
self:addWarning(string.format(
string.format(cfg.more_than_60_minutes, mw.text.nowiki(length)),
"Invalid track length '%s' (if hours are specified, the number of minutes must be less than 60)",
cfg.input_error_category
mw.text.nowiki(length)
)
), INPUT_ERROR_CATEGORY)
return nil
end
Line 105 ⟶ 100:
-- Check that the seconds are less than 60
if tonumber(seconds) >= 60 then
self:addWarning(string.format(
string.format(cfg.more_than_60_seconds, mw.text.nowiki(length)),
"Invalid track length '%s' (number of seconds must be less than 60)",
cfg.input_error_category
mw.text.nowiki(length)
)
), INPUT_ERROR_CATEGORY)
end
 
Line 122 ⟶ 117:
addMixin(Track, Validation)
 
Track.fields = {cfg.track_field_names
number = true,
title = true,
note = true,
length = true,
lyrics = true,
music = true,
writer = true,
extra = true,
}
 
Track.cellMethods = {
Line 173 ⟶ 159:
function Track.makeSimpleCell(wikitext)
return mw.html.create('td')
:wikitext(wikitext or cfg.blank_cell)
:css('vertical-align', 'top')
:wikitext(wikitext or ' ')
end
 
function Track:makeNumberCell()
return mw.html.create('tdth')
:attr('id', string.format(cfg.track_id, self.number))
:css('padding-right', '10px')
:cssattr('text-alignscope', 'rightrow')
:wikitext(string.format(cfg.number_terminated, self.number))
:css('vertical-align', 'top')
:wikitext(self.number .. '.')
end
 
function Track:makeTitleCell()
local titleCell = mw.html.create('td')
titleCell:wikitext(
self.title and string.format(cfg.track_title, self.title) or cfg.untitled
:css('vertical-align', 'top')
)
:wikitext(self.title and string.format('"%s"', self.title) or 'Untitled')
if self.note then
titleCell:wikitext(string.format(cfg.note, self.note))
titleCell
:wikitext(' ')
:tag('span')
:wikitext(string.format('(%s)', self.note))
end
return titleCell
Line 217 ⟶ 198:
function Track:makeLengthCell()
return mw.html.create('td')
:cssaddClass('paddingtracklist-right', '10pxlength')
:wikitext(self.length or cfg.blank_cell)
:css('text-align', 'right')
:css('vertical-align', 'top')
:wikitext(self.length or ' ')
end
 
function Track:exportRow(optionscolumns)
optionslocal columns = optionscolumns or {}
local columns = options.columns or {}
local row = mw.html.create('tr')
row:css('background-color', options.color or '#fff')
for i, column in ipairs(columns) do
local method = Track.cellMethods[column]
Line 244 ⟶ 221:
TrackListing.__index = TrackListing
addMixin(TrackListing, Validation)
TrackListing.fields = cfg.track_listing_field_names
 
TrackListing.fieldsdeprecatedFields = {cfg.deprecated_track_listing_field_names
headline = true,
all_writing = true,
all_lyrics = true,
all_music = true,
extra_column = true,
total_length = true,
title_width = true,
writing_width = true,
lyrics_width = true,
music_width = true,
extra_width = true,
category = true,
}
 
TrackListing.deprecatedFields = {
writing_credits = true,
lyrics_credits = true,
music_credits = true,
}
 
function TrackListing.new(data)
Line 273 ⟶ 231:
for deprecatedField in pairs(TrackListing.deprecatedFields) do
if data[deprecatedField] then
self:addCategory('Track listings with deprecated parameters'cfg.deprecated_parameter_category)
break
end
Line 337 ⟶ 295:
function TrackListing:makeIntro()
if self.all_writing then
return string.format(cfg.tracks_written, self.all_writing)
'All tracks are written by %s.',
self.all_writing
)
elseif self.all_lyrics and self.all_music then
return stringmw.formatmessage.newRawMessage(
cfg.lyrics_written_music_composed,
'All lyrics are written by %s; all music is composed by %s.',
self.all_lyrics,
self.all_music
):plain()
elseif self.all_lyrics then
return string.format(cfg.lyrics_written, self.all_lyrics)
'All lyrics are written by %s.',
self.all_lyrics
)
elseif self.all_music then
return string.format(cfg.music_composed, self.all_music)
'All music is composed by %s.',
self.all_music
)
else
return ''nil
end
end
Line 387 ⟶ 336:
 
function TrackListing:renderWarnings()
if not SHOW_WARNINGScfg.show_warnings then
return ''
end
Line 394 ⟶ 343:
 
local function addWarning(msg)
table.insert(ret, string.format(cfg.track_listing_error, msg))
'<strong class="error">Track listing error: %s</strong>',
msg
))
end
 
Line 414 ⟶ 360:
 
function TrackListing:__tostring()
-- Root of the output
local root = mw.html.create('div')
:addClass('track-listing')
local intro = self:makeIntro()
if intro then
root:tag('p')
:wikitext(intro)
:done()
end
-- Start of track listing table
local tableRoot = mw.html.create('table')
tableRoot
:addClass('tracklist')
-- Header row
if self.headline then
tableRoot:tag('caption')
:wikitext(self.headline or cfg.track_listing)
end
 
-- Headers
local headerRow = tableRoot:tag('tr')
 
---- Track number
headerRow
:tag('th')
:addClass('tracklist-number-header')
:attr('scope', 'col')
:tag('abbr')
:attr('title', cfg.number)
:wikitext(cfg.number_abbr)
 
-- Find columns to output
local columns = {'number', 'title'}
Line 430 ⟶ 410:
end
columns[#columns + 1] = 'length'
 
-- Find colspan and column width
local nColumns = #columns
local nOptionalColumns = nColumns - 3
local titleColumnWidth
local titleColumnWidth = 100
if nColumns >= 5 then
titleColumnWidth = 40
elseif nColumns >= 4 then
titleColumnWidth = 60
else
titleColumnWidth = 100
end
local optionalColumnWidth = (100 - titleColumnWidth) / nOptionalColumns
local optionalColumnWidth = ((100 - titleColumnWidth) / nOptionalColumns) .. '%'
titleColumnWidth = titleColumnWidth .. '%'
optionalColumnWidth = optionalColumnWidth .. '%'
 
-- Root of the output
local root = mw.html.create()
 
-- Intro
root:node(self:makeIntro())
 
-- Start of track listing table
local tableRoot = root:tag('table')
tableRoot
:addClass('tracklist')
:css('display', 'block')
:css('border-spacing', '0px')
-- Header row
if self.headline then
tableRoot:tag('caption')
:addClass('tlheader mbox-text')
:attr('colspan', nColumns)
:css('text-align', 'left')
:css('background-color', '#fff')
:css('font-weight', '700')
:wikitext(self.headline or 'Track listing')
end
---- Title column
-- Deprecated collapsed parameter
if self.collapsed then
self:addWarning("Deprecated collapsed parameter in use", COLLAPSED_PARAMETER_CATEGORY);
end
 
-- Headers
local headerRow = tableRoot:tag('tr')
 
---- Track number
headerRow
:tag('th')
:addClass('tlheader')
:attr('scope', 'col')
:css('width', '2em')
:css('padding-left', '10px')
:css('padding-right', '10px')
:css('text-align', 'right')
:css('background-color', '#eee')
:tag('abbr')
:attr('title', 'Number')
:wikitext('No.')
 
---- Title
headerRow:tag('th')
:addClass('tlheader')
:attr('scope', 'col')
:css('width', self.title_width or titleColumnWidth)
:wikitext(cfg.title)
:css('text-align', 'left')
:css('background-color', '#eee')
:wikitext('Title')
 
---- Optional headers: writer, lyrics, music, and extra
Line 505 ⟶ 435:
if self.optionalColumns[field] then
headerRow:tag('th')
:addClass('tlheader')
:attr('scope', 'col')
:css('width', width or optionalColumnWidth)
:css('text-align', 'left')
:css('background-color', '#eee')
:wikitext(headerText)
end
end
addOptionalHeader('writer', 'Writer(s)'cfg.writer, self.writing_width)
addOptionalHeader('lyrics', 'Lyrics'cfg.lyrics, self.lyrics_width)
addOptionalHeader('music', 'Music'cfg.music, self.music_width)
addOptionalHeader(
'extra',
self.extra_column or '{{{extra_column}}}'cfg.extra,
self.extra_width
)
Line 524 ⟶ 451:
---- Track length
headerRow:tag('th')
:addClass('tlheadertracklist-length-header')
:attr('scope', 'col')
:wikitext(cfg.length)
:css('width', '4em')
:css('padding-right', '10px')
:css('text-align', 'right')
:css('background-color', '#eee')
:wikitext('Length')
 
-- Tracks
for i, track in ipairs(self.tracks) do
tableRoot:node(track:exportRow({columns))
columns = columns,
color = i % 2 == 0 and '#f7f7f7' or '#fff'
}))
end
 
Line 544 ⟶ 464:
tableRoot
:tag('tr')
:tagaddClass('tdtracklist-total-length')
:tag('th')
:attr('colspan', nColumns - 1)
:cssattr('paddingscope', 0'row')
:tag('span')
:csswikitext('width', '7cfg.5em'total_length)
:css('float', 'right')
:css('padding-left', '10px')
:css('background-color', '#eee')
:css('margin-right', '2px')
:wikitext("'''Total length:'''")
:done()
:done()
:tag('td')
:csswikitext('padding', '0 10px 0 0'self.total_length)
:css('text-align', 'right')
:css('background-color', '#eee')
:wikitext(string.format("'''%s'''", self.total_length))
end
root:node(tableRoot)
-- Warnings and tracking categories
root:wikitext(self:renderWarnings())
root:wikitext(self:renderTrackingCategories())
 
return tostringmw.getCurrentFrame(root):extensionTag{
name = 'templatestyles', args = { src = 'Module:Track listing/styles.css' }
} .. tostring(root)
end
 
Retrieved from "https://en.seminaverbi.bibleget.io/wiki/Module:Track_listing"