Modulo:Avviso/sandbox
Aspetto
La documentazione per questo modulo può essere creata in Modulo:Avviso/sandbox/man
--[[
Source script: https://it.wikivoyage.org/wiki/Modulo:Avviso
Maintainer: Andyrom75, Nastoshka
v.1.0.0 -- Andyrom75 (novembre 2021)
v.2.0.0 -- Nastoshka (gennaio 2024)
]]
-- --------------------------- Funzioni ausiliarie ---------------------------------------------
-- Meta funzione per impostare un valore di default per una tabella Lua
-- nel caso si tentasse l'accesso ad un parametro non esistente
-- Vedi: https://www.lua.org/pil/13.4.3.html
function setDefault (t, d)
local mt = {__index = function () return d end}
setmetatable(t, mt)
end
-- --------------------------- Costanti ---------------------------------------------
-- immagine per il banner di avviso
local IMAGE_PATHS = {
importante = '[[File:Stop hand nuvola.svg|40px|link=]]',
contenuto = '[[File:Emblem-important.svg|40px|link=]]',
stile = '[[File:Broom icon.svg|40px|link=]]',
statico = '[[File:Gnome globe current event.svg|40px|link=]]',
struttura = '[[File:Merge-split-transwiki default.svg|40px|link=]]',
avviso = '[[File:Info non-talk.png|40px|link=]]',
disambigua = '[[File:Info non-talk.png|40px|link=]]',
protezione = '[[File:Padlock.svg|40px|link=]]',
disclaimer = '[[File:Nuvola_apps_important.svg|40px|link=]]',
trasparente = '[[File:No image.svg|link=]]',
-- vetrina = '[[File:Crystal Clear action bookmark silver and gold doubt.svg|40px|link=]]',
default = '[[File:Info non-talk.png|40px|link=]]'
}
setDefault(IMAGE_PATHS, IMAGE_PATHS.default)
-- determina il css da usare e in alcuni casi categorizza (dipendentemente dal namespace)
local WARNING_TYPE = {
importante = 'avviso-importante',
contenuto = 'avviso-contenuto',
stile = 'avviso-stile',
statico = 'avviso-statico',
struttura = 'avviso-struttura',
avviso = 'avviso-informazioni',
disambigua = 'avviso-disambigua hatnote',
protezione = 'avviso-generico',
disclaimer = 'avviso-disclaimer',
default = 'avviso-informazioni'
}
setDefault(WARNING_TYPE, WARNING_TYPE.default)
local IMAGE_BOX_SIZE_DEFAULT = '52px'
-- --------------------------- Funzioni principali ---------------------------------------------
-- Stabilisci l'icona da usare a lato del testo
-- Se un'immagine è stata passata come parametro, prendi quella
-- altrimenti usa il tipo come fallback (se il tipo non esiste nell'array / table, usa il default)
local function getWarningImage(args)
-- Immagine volantariamente disattivata
local isImageDisabled = function() return args['2'] == 'nessuna' or args.immagine == 'nessuna' end
if isImageDisabled() then
return ' '
end
local imagebox_width = args.imageboxsize or IMAGE_BOX_SIZE_DEFAULT
-- Immagine passata come parametro
local isPassedImageAvailable = function() return not (args['2'] == nil or args['2'] == '') or not (args.immagine == nil or args.immagine == '') end
if isPassedImageAvailable() then
local passed_image = args['2'] or args.immagine
return '<div style="width:' .. imagebox_width .. ';">' .. passed_image .. '</div>'
end
-- fallback (usa il tipo, o in alternativa il valore di default)
return '<div style="width:' .. imagebox_width .. ';">' .. IMAGE_PATHS[args.tipo] .. '</div>'
end
local function get_right_image(args)
local right_image = args['immagine a destra'] or false
if not right_image then
return ''
end
return '<div class="avviso-immaginedestra">'
.. '<div style="width:' .. (args.imageboxsize or IMAGE_BOX_SIZE_DEFAULT) .. ';"> ' .. right_image .. ' </div>'
.. '</div>'
end
local function getWarningText(args)
local text = args['1'] or args.testo or ''
return tostring(text)
end
local function getCategoryTag(args)
local title_obj = mw.title.getCurrentTitle()
local namespace = title_obj.namespace
local page_title = title_obj.text
local should_be_categorized = args.tipo == 'avviso' or args.tipo == 'importante'
if namespace == 8 then -- MediaWiki namespace
return '[[Categoria:Messaggi di sistema con avviso|' .. page_title .. ']]'
end
if namespace == 0 and should_be_categorized then -- Main namespace, tipo avviso o importante
return '[[Categoria:Articoli con avviso]]'
end
return '' -- Non categorizzare
end
-- --------------------------- Main logic ---------------------------------------------
local function generateWarningBox(frame)
local args = frame.args
-- raccogliamo i pezzi del puzzle
local style = args.stile or ''
local warningType = WARNING_TYPE[args.tipo]
local warningImage = getWarningImage(args)
local warningRightImage = get_right_image(args)
local warningText = getWarningText(args)
local categoryTag = getCategoryTag(args)
-- e mettiamo insieme il tutto ;)
local htmlOutput = {
'<div style="' .. style .. '" class="plainlinks noprint avviso ambox ' .. warningType .. '">',
'<div class="avviso-immagine mbox-image">',
warningImage,
'</div>',
'<div class="avviso-testo mbox-text-span" style="' .. (args['stile testo'] or '') .. '">',
warningText,
'</div>',
warningRightImage,
'</div>',
categoryTag
}
-- mw.log('htmlOutput: ' .. table.concat(htmlOutput)) -- DEBUG
return table.concat(htmlOutput)
end
-- --------------------------- Interfaccia del modulo ---------------------------------------------
local p = {} -- package to be exported
-- per la differenza tra frame e frame:getParent() vedi
-- - https://en.wikipedia.org/wiki/Help:Lua_for_beginners#Parent_frame
-- - https://it.wikivoyage.org/wiki/Modulo:Arguments/man
function p.avvisoTemplate(frame)
return generateWarningBox(frame:getParent()) -- se invocato attraverso un template
end
function p.avviso(frame)
return generateWarningBox(frame) -- se invocato direttamente in un template
end
return p