「モジュール:Namespace detect」の版間の差分

提供: ひつじ小屋別館2代目
移動先: 案内検索
(1版)
14行目: 14行目:
 
--------------------------------------------------------------------------------
 
--------------------------------------------------------------------------------
 
--]]
 
--]]
 
+
 
local data = mw.loadData('Module:Namespace detect/data')
 
local data = mw.loadData('Module:Namespace detect/data')
 
local argKeys = data.argKeys
 
local argKeys = data.argKeys
 
local cfg = data.cfg
 
local cfg = data.cfg
 
local mappings = data.mappings
 
local mappings = data.mappings
 
+
 
local yesno = require('Module:Yesno')
 
local yesno = require('Module:Yesno')
 
local mArguments -- Lazily initialise Module:Arguments
 
local mArguments -- Lazily initialise Module:Arguments
 
local mTableTools -- Lazily initilalise Module:TableTools
 
local mTableTools -- Lazily initilalise Module:TableTools
 
local ustringLower = mw.ustring.lower
 
local ustringLower = mw.ustring.lower
 
+
 
local p = {}
 
local p = {}
 
+
 
local function fetchValue(t1, t2)
 
local function fetchValue(t1, t2)
 
-- Fetches a value from the table t1 for the first key in array t2 where
 
-- Fetches a value from the table t1 for the first key in array t2 where
38行目: 38行目:
 
return nil
 
return nil
 
end
 
end
 
+
 
local function equalsArrayValue(t, value)
 
local function equalsArrayValue(t, value)
 
-- Returns true if value equals a value in the array t. Otherwise
 
-- Returns true if value equals a value in the array t. Otherwise
49行目: 49行目:
 
return false
 
return false
 
end
 
end
 
+
 
function p.getPageObject(page)
 
function p.getPageObject(page)
 
-- Get the page object, passing the function through pcall in case of
 
-- Get the page object, passing the function through pcall in case of
64行目: 64行目:
 
end
 
end
 
end
 
end
 
+
 
-- Provided for backward compatibility with other modules
 
-- Provided for backward compatibility with other modules
 
function p.getParamMappings()
 
function p.getParamMappings()
 
return mappings
 
return mappings
 
end
 
end
 
+
 
local function getNamespace(args)
 
local function getNamespace(args)
 
-- This function gets the namespace name from the page object.
 
-- This function gets the namespace name from the page object.
local page = fetchValue(args, argKeys.page)
+
local page = fetchValue(args, argKeys.demopage)
 
if page == '' then
 
if page == '' then
 
page = nil
 
page = nil
110行目: 110行目:
 
return ustringLower(ret)
 
return ustringLower(ret)
 
end
 
end
 
+
 
function p._main(args)
 
function p._main(args)
 
-- Check the parameters stored in the mappings table for any matches.
 
-- Check the parameters stored in the mappings table for any matches.
128行目: 128行目:
 
return ret
 
return ret
 
end
 
end
 
+
 
function p.main(frame)
 
function p.main(frame)
 
mArguments = require('Module:Arguments')
 
mArguments = require('Module:Arguments')
135行目: 135行目:
 
return ret or ''
 
return ret or ''
 
end
 
end
 
+
 
function p.table(frame)
 
function p.table(frame)
 
--[[
 
--[[
142行目: 142行目:
 
-- needs to be excluded in the documentation.
 
-- needs to be excluded in the documentation.
 
--]]
 
--]]
+
 
-- Load modules and initialise variables.
 
-- Load modules and initialise variables.
 
mTableTools = require('Module:TableTools')
 
mTableTools = require('Module:TableTools')
150行目: 150行目:
 
and type(frame.args) == 'table'  
 
and type(frame.args) == 'table'  
 
and yesno(frame.args.talk) -- Whether to use the talk parameter.
 
and yesno(frame.args.talk) -- Whether to use the talk parameter.
+
 
-- Get the header names.
 
-- Get the header names.
 
local function checkValue(value, default)
 
local function checkValue(value, default)
161行目: 161行目:
 
local nsHeader = checkValue(cfg.wikitableNamespaceHeader, 'Namespace')
 
local nsHeader = checkValue(cfg.wikitableNamespaceHeader, 'Namespace')
 
local aliasesHeader = checkValue(cfg.wikitableAliasesHeader, 'Aliases')
 
local aliasesHeader = checkValue(cfg.wikitableAliasesHeader, 'Aliases')
 
+
 
-- Put the namespaces in order.
 
-- Put the namespaces in order.
 
local mappingsOrdered = {}
 
local mappingsOrdered = {}
173行目: 173行目:
 
end
 
end
 
mappingsOrdered = mTableTools.compressSparseArray(mappingsOrdered)
 
mappingsOrdered = mTableTools.compressSparseArray(mappingsOrdered)
 
+
 
-- Build the table.
 
-- Build the table.
 
local ret = '{| class="wikitable"'
 
local ret = '{| class="wikitable"'
196行目: 196行目:
 
return ret
 
return ret
 
end
 
end
 
+
 
return p
 
return p

2014年4月27日 (日) 19:20時点における版

This module allows you to output different text depending on the namespace that a given page is in. It is a Lua implementation of the {{namespace detect}} template, with a few improvements: all namespaces and all namespace aliases are supported, and namespace names are detected automatically for the local wiki.

Usage

{{#invoke: Namespace detect | main
| page              = <!-- page to detect namespace for, if not the current page -->
| main              = <!-- text to return for the main namespace -->
| talk              = <!-- text to return for talk namespaces -->

<!-- text to return for specific subject namespaces -->
| portal            = 
| category          = 
| user 	            = 
| wikipedia         = 
| wp                = 
| education program = 
| mediawiki         = 
| book              = 
| timedtext         = 
| template          = 
| special           = 
| media             = 
| file              = 
| image             = 
| help 	            = 
| module            = 

| other             = <!-- text to return for unspecified namespaces -->
| demospace         = <!-- namespace to display text for -->
}}

Parameters

  • page - specifies a page to detect the namespace of. If not specified, and if the |demospace= parameter is not set, then the module uses the current page.
  • main - text to return if the page is in the main namespace.
  • talk - text to return if the page is in a talk namespace. This can be any talk namespace - it will match any of "Talk:", "Wikipedia talk:", "User talk:", etc.
  • Subject namespace parameters, e.g. wikipedia, user, file... - the text to return if the page is in the corresponding namespace. This module accepts all subject namespaces as parameters, including namespace aliases and virtual namespaces. See below for a list of supported values.
  • other - text to return if no parameters for the page's namespace were specified. This text is also returned if |demospace= is set to an invalid namespace value.
  • demospace - force the module to behave as if the page was in the specified namespace. Often used for demonstrations.

Namespace parameters

Possible values for subject namespace parameters are as follows:

Lua エラー package.lua 内、80 行目: module 'Module:TableTools' not found

Porting to different wikis

This module is designed to be portable. To use it on a different wiki, all you need to do is to change the values in the "cfg" table.


--[[
--------------------------------------------------------------------------------
--                                                                            --
--                            NAMESPACE DETECT                                --
--                                                                            --
-- This module implements the {{namespace detect}} template in Lua, with a    --
-- few improvements: all namespaces and all namespace aliases are supported,  --
-- and namespace names are detected automatically for the local wiki. The     --
-- module can also use the corresponding subject namespace value if it is     --
-- used on a talk page. Parameter names can be configured for different wikis --
-- by altering the values in the "cfg" table in                               --
-- Module:Namespace detect/config.                                            --
--                                                                            --
--------------------------------------------------------------------------------
--]]
 
local data = mw.loadData('Module:Namespace detect/data')
local argKeys = data.argKeys
local cfg = data.cfg
local mappings = data.mappings
 
local yesno = require('Module:Yesno')
local mArguments -- Lazily initialise Module:Arguments
local mTableTools -- Lazily initilalise Module:TableTools
local ustringLower = mw.ustring.lower
 
local p = {}
 
local function fetchValue(t1, t2)
	-- Fetches a value from the table t1 for the first key in array t2 where
	-- a non-nil value of t1 exists.
	for i, key in ipairs(t2) do
		local value = t1[key]
		if value ~= nil then
			return value
		end
	end
	return nil
end
 
local function equalsArrayValue(t, value)
	-- Returns true if value equals a value in the array t. Otherwise
	-- returns false.
	for i, arrayValue in ipairs(t) do
		if value == arrayValue then
			return true
		end
	end
	return false
end
 
function p.getPageObject(page)
	-- Get the page object, passing the function through pcall in case of
	-- errors, e.g. being over the expensive function count limit.
	if page then
		local success, pageObject = pcall(mw.title.new, page)
		if success then
			return pageObject
		else
			return nil
		end
	else
		return mw.title.getCurrentTitle()
	end
end
 
-- Provided for backward compatibility with other modules
function p.getParamMappings()
	return mappings
end
 
local function getNamespace(args)
	-- This function gets the namespace name from the page object.
	local page = fetchValue(args, argKeys.demopage)
	if page == '' then
		page = nil
	end
	local demospace = fetchValue(args, argKeys.demospace)
	if demospace == '' then
		demospace = nil
	end
	local subjectns = fetchValue(args, argKeys.subjectns)
	local ret
	if demospace then
		-- Handle "demospace = main" properly.
		if equalsArrayValue(argKeys.main, ustringLower(demospace)) then
			ret = mw.site.namespaces[0].name
		else
			ret = demospace
		end
	else
		local pageObject = p.getPageObject(page)
		if pageObject then
			if pageObject.isTalkPage then
				-- Get the subject namespace if the option is set,
				-- otherwise use "talk".
				if yesno(subjectns) then
					ret = mw.site.namespaces[pageObject.namespace].subject.name
				else
					ret = 'talk'
				end
			else
				ret = pageObject.nsText
			end
		else
			return nil -- return nil if the page object doesn't exist.
		end
	end
	ret = ret:gsub('_', ' ')
	return ustringLower(ret)
end
 
function p._main(args)
	-- Check the parameters stored in the mappings table for any matches.
	local namespace = getNamespace(args) or 'other' -- "other" avoids nil table keys
	local params = mappings[namespace] or {}
	local ret = fetchValue(args, params)
	--[[
	-- If there were no matches, return parameters for other namespaces.
	-- This happens if there was no text specified for the namespace that
	-- was detected or if the demospace parameter is not a valid
	-- namespace. Note that the parameter for the detected namespace must be
	-- completely absent for this to happen, not merely blank.
	--]]
	if ret == nil then
		ret = fetchValue(args, argKeys.other)
	end
	return ret
end
 
function p.main(frame)
	mArguments = require('Module:Arguments')
	local args = mArguments.getArgs(frame, {removeBlanks = false})
	local ret = p._main(args)
	return ret or ''
end
 
function p.table(frame)
	--[[
	-- Create a wikitable of all subject namespace parameters, for
	-- documentation purposes. The talk parameter is optional, in case it
	-- needs to be excluded in the documentation.
	--]]
 
	-- Load modules and initialise variables.
	mTableTools = require('Module:TableTools')
	local namespaces = mw.site.namespaces
	local cfg = data.cfg
	local useTalk = type(frame) == 'table' 
		and type(frame.args) == 'table' 
		and yesno(frame.args.talk) -- Whether to use the talk parameter.
 
	-- Get the header names.
	local function checkValue(value, default)
		if type(value) == 'string' then
			return value
		else
			return default
		end
	end
	local nsHeader = checkValue(cfg.wikitableNamespaceHeader, 'Namespace')
	local aliasesHeader = checkValue(cfg.wikitableAliasesHeader, 'Aliases')
 
	-- Put the namespaces in order.
	local mappingsOrdered = {}
	for nsname, params in pairs(mappings) do
		if useTalk or nsname ~= 'talk' then
			local nsid = namespaces[nsname].id
			-- Add 1, as the array must start with 1; nsid 0 would be lost otherwise.
			nsid = nsid + 1 
			mappingsOrdered[nsid] = params
		end
	end
	mappingsOrdered = mTableTools.compressSparseArray(mappingsOrdered)
 
	-- Build the table.
	local ret = '{| class="wikitable"'
		.. '\n|-'
		.. '\n! ' .. nsHeader
		.. '\n! ' .. aliasesHeader
	for i, params in ipairs(mappingsOrdered) do
		for j, param in ipairs(params) do
			if j == 1 then
				ret = ret .. '\n|-'
					.. '\n| <code>' .. param .. '</code>'
					.. '\n| '
			elseif j == 2 then
				ret = ret .. '<code>' .. param .. '</code>'
			else
				ret = ret .. ', <code>' .. param .. '</code>'
			end
		end
	end
	ret = ret .. '\n|-'
		.. '\n|}'
	return ret
end
 
return p