Difference between revisions of "Module:Namespace detect/data"

From Timelines
Jump to: navigation, search
(add a getArgKeys function, so that we can have multiple keys for each argument (helpful for localisation) and so that we only have to create that table once per page)
(give the argKeys table global scope so that getParamMappings can access it without having to process the cfg table again)
Line 13: Line 13:
 
end
 
end
  
local function getArgKeys()
+
-- Get a table of parameters to query for each default parameter name.
-- Returns a table of parameters to query for each default parameter name.
+
-- This allows wikis to customise parameter names in the cfg table while
-- This allows wikis to customise parameter names in the cfg table while
+
-- ensuring that default parameter names will always work. The cfg table
-- ensuring that default parameter names will always work. The cfg table
+
-- values can be added as a string, or as an array of strings.
-- values can be added as a string, or as an array of strings.
+
 
local argKeys = {
+
local argKeys = {
main = {'main'},
+
main = {'main'},
talk = {'talk'},
+
talk = {'talk'},
other = {'other'},
+
other = {'other'},
subjectns = {'subjectns'},
+
subjectns = {'subjectns'},
demospace = {'demospace'},
+
demospace = {'demospace'},
page = {'page'}
+
page = {'page'}
}
+
}
for defaultKey, t in pairs(argKeys) do
+
 
local cfgValue = cfg[defaultKey]
+
for defaultKey, t in pairs(argKeys) do
local cfgValueType = type(cfgValue)
+
local cfgValue = cfg[defaultKey]
if cfgValueType == 'string' then
+
local cfgValueType = type(cfgValue)
addKey(t, cfgValue, defaultKey)
+
if cfgValueType == 'string' then
elseif cfgValueType == 'table' then
+
addKey(t, cfgValue, defaultKey)
for i, key in ipairs(cfgValue) do
+
elseif cfgValueType == 'table' then
addKey(t, key, defaultKey)
+
for i, key in ipairs(cfgValue) do
end
+
addKey(t, key, defaultKey)
 
end
 
end
cfg[defaultKey] = nil -- Free the cfg value as we don't need it any more.
 
 
end
 
end
return argKeys
+
cfg[defaultKey] = nil -- Free the cfg value as we don't need it any more.
 
end
 
end
  
Line 55: Line 54:
 
local ustringLower = mw.ustring.lower
 
local ustringLower = mw.ustring.lower
 
local tinsert = table.insert
 
local tinsert = table.insert
 +
local clone = mw.clone
 
local subjectNamespaces = mw.site.subjectNamespaces
 
local subjectNamespaces = mw.site.subjectNamespaces
local talk = cfg.talk
 
 
local mappings = {}
 
local mappings = {}
mappings[ustringLower(subjectNamespaces[0].name)] = {cfg.main}
+
mappings[ustringLower(subjectNamespaces[0].name)] = clone(argKeys.main)
mappings[talk] = {talk}
+
mappings['talk'] = clone(argKeys.talk)
 
for nsid, ns in pairs(subjectNamespaces) do
 
for nsid, ns in pairs(subjectNamespaces) do
 
if nsid ~= 0 then -- Exclude main namespace.
 
if nsid ~= 0 then -- Exclude main namespace.
Line 77: Line 76:
  
 
return {
 
return {
argKeys = getArgKeys(),
+
argKeys = argKeys,
 
cfg = cfg,
 
cfg = cfg,
 
mappings = getParamMappings()
 
mappings = getParamMappings()
 
}
 
}

Revision as of 23:03, 21 March 2014

Documentation for this module may be created at Module:Namespace detect/data/doc

--------------------------------------------------------------------------------
--                          Namespace detect data                             --
-- This module holds data for [[Module:Namespace detect]] to be loaded per    --
-- page, rather than per #invoke, for performance reasons.                    --
--------------------------------------------------------------------------------

local cfg = require('Module:Namespace detect/config')

local function addKey(t, key, defaultKey)
	if key ~= defaultKey then
		t[#t + 1] = key
	end
end

-- Get a table of parameters to query for each default parameter name.
-- This allows wikis to customise parameter names in the cfg table while
-- ensuring that default parameter names will always work. The cfg table
-- values can be added as a string, or as an array of strings.

local argKeys = {
	main = {'main'},
	talk = {'talk'},
	other = {'other'},
	subjectns = {'subjectns'},
	demospace = {'demospace'},
	page = {'page'}
}

for defaultKey, t in pairs(argKeys) do
	local cfgValue = cfg[defaultKey]
	local cfgValueType = type(cfgValue)
	if cfgValueType == 'string' then
		addKey(t, cfgValue, defaultKey)
	elseif cfgValueType == 'table' then
		for i, key in ipairs(cfgValue) do
			addKey(t, key, defaultKey)
		end
	end
	cfg[defaultKey] = nil -- Free the cfg value as we don't need it any more.
end

local function getParamMappings()
	--[[
	-- Returns a table of how parameter names map to namespace names. The keys
	-- are the actual namespace names, in lower case, and the values are the
	-- possible parameter names for that namespace, also in lower case. The
	-- table entries are structured like this:
	-- {
	--   [''] = {'main'},
	--   ['wikipedia'] = {'wikipedia', 'project', 'wp'},
	--   ...
	-- }
	--]]
	local ustringLower = mw.ustring.lower
	local tinsert = table.insert
	local clone = mw.clone
	local subjectNamespaces = mw.site.subjectNamespaces
	local mappings = {}
	mappings[ustringLower(subjectNamespaces[0].name)] = clone(argKeys.main)
	mappings['talk'] = clone(argKeys.talk)
	for nsid, ns in pairs(subjectNamespaces) do
		if nsid ~= 0 then -- Exclude main namespace.
			local nsname = ustringLower(ns.name)
			local canonicalName = ustringLower(ns.canonicalName)
			mappings[nsname] = {nsname}
			if canonicalName ~= nsname then
				tinsert(mappings[nsname], canonicalName)
			end
			for _, alias in ipairs(ns.aliases) do
				tinsert(mappings[nsname], ustringLower(alias))
			end
		end
	end
	return mappings
end

return {
	argKeys = argKeys,
	cfg = cfg,
	mappings = getParamMappings()
}