Módulo:Barra portal

[ máis información | ver o historial | | | ver as instrucións ]

Indicacións de uso do módulo

Obxectivo

Este módulo contén o código Lua do modelo {{Barra portal}}.

• Subpáxinas do módulo: Módulo:Barra portal/imaxes

[ máis información | ver o historial | | | ver as instrucións ]

Esta documentación está transcluída desde Módulo:Barra portal/uso. Os editores poden probar cambios no mesmo en Módulo:Barra portal/probas.
Por favor, engade as categorías na subpáxina de documentación e os interwikis no Wikidata. Ver as subpáxinas deste módulo.

---

-- This module implements {{portal bar}}.

require('Module:No globals')

local p = {}

local buildNavbox = require( 'Module:Navbox' )._navbox
local yesno = require( 'Module:Yesno' )

local function matchImagePage(s)
	-- Finds the appropriate image subpage given a lower-case
	-- portal name plus the first letter of that portal name.
	if type(s) ~= 'string' or #s < 1 then return end
	local firstLetter = mw.ustring.sub(s, 1, 1)
	local imagePage
	if mw.ustring.find(firstLetter, '^[a-z]') then
		imagePage = 'Module:Portal/images/' .. firstLetter
	else
		imagePage = 'Module:Portal/images/other'
	end
	return mw.loadData(imagePage)[s]
end

local function getImageName(s)
	-- Gets the image name for a given string.
	if type(s) ~= 'string' or #s < 1 then
		return 'Portal-puzzle.svg'
	end
	s = mw.ustring.lower(s)
	return matchImagePage(s) or 'Portal-puzzle.svg'
end

-- Builds the portal bar used by {{portal bar}}.
function p._main( portals, args )
	if #portals < 1 then return '' end -- Don't display a blank navbox if no portals were specified.
	local list = mw.html.create( 'ul' )
	for _, portal in ipairs( portals ) do
		list
			:tag( 'li' )
				:css( 'display', 'inline' )
				:css( 'white-space', 'nowrap' )
				:tag( 'span' )
					:css( 'margin', 'auto 0.5em' )
					:wikitext( string.format( '[[File:%s|24x21px]]', getImageName{ portal } ) )
					:done()
				:tag( 'span' )
					:css( 'font-weight', 'bold' )
					:wikitext( string.format( '[[Portal:%s|%s portal]]', portal, portal ) )
	end
	if yesno( args.border ) == false then -- Don't display a border if args.border is "no", "n", "false", 0 or false.
		return tostring(
			mw.html.create( 'div' )
				:addClass( 'noprint metadata' )
				:css( 'width', '100%' )
				:css( 'text-align', 'center' )
				:css( 'padding', '1px' )
				:css( 'font-size', '88%' )
				:node( list )
		)
	else
		return buildNavbox{
			navbar = 'off',
			bodyclass = 'noprint',
			list1 = tostring( list )
		}
	end
end

-- Processes external arguments and sends them to the other functions.
function p.main( frame )
	-- If called via #invoke, use the args passed into the invoking
	-- template, or the args passed to #invoke if any exist. Otherwise
	-- assume args are being passed directly in from the debug console
	-- or from another Lua module.
	local origArgs
	if type( frame.getParent ) == 'function' then
		origArgs = frame:getParent().args
		for k, v in pairs( frame.args ) do
			origArgs = frame.args
			break
		end
	else
		origArgs = frame
	end
	-- Process the args to make an array of portal names that can be used with ipairs. We need to use ipairs because we want to list
	-- all the portals in the order they were passed to the template, but we also want to be able to deal with positional arguments
	-- passed explicitly, for example {{portal|2=Politics}}. The behaviour of ipairs is undefined if nil values are present, so we
	-- need to make sure they are all removed.
	local portals, args = {}, {}
	for k, v in pairs( origArgs ) do
		if type( k ) == 'number' and type( v ) == 'string' then -- Make sure we have no non-string portal names.
			if mw.ustring.find( v, '%S' ) then -- Remove blank values.
				table.insert( portals, k )
			end
		elseif type( k ) ~= 'number' then -- Separate named arguments from portals.
			if type( v ) == 'string' then
				v = mw.text.trim( v )
			end
			args[ k ] = v
		end
	end
	table.sort( portals )
	for i, v in ipairs( portals ) do
		portals[ i ] = mw.text.trim( origArgs[ v ] ) -- Swap keys with values, trimming whitespace.
	end
	return p._main( portals, args )
end

return p