Module:Category handler - Revision history

ArrowHead294: Wikitext debugger option

2025-12-05T23:19:45Z

Wikitext debugger option

← Older revision		Revision as of 23:19, 5 December 2025
Line 165:		Line 165:
	function p.category_handler(frame)		function p.category_handler(frame)
	local args = getArgs(frame)		local args = getArgs(frame)
	local excluded_ns_unparsed = args["excluded_ns"] or "" -- Additional namespaces to exclude (EG, a template that should not be used within main namespace, which is allowed by default)		local excluded_ns_unparsed = args["excluded_ns"] or "" -- Additional namespaces to exclude (EG, a template that should not be used within main namespace, which is allowed by default)
	local allowed_ns_unparsed = args["allowed_ns" ] or "" -- Namespaces to allow; overrides default list (EG, a template that should be used within user namespace, which is disallowed by default)		local allowed_ns_unparsed = args["allowed_ns" ] or "" -- Namespaces to allow; overrides default list (EG, a template that should be used within user namespace, which is disallowed by default)
	local suffixes_unparsed = args["suffixes" ] or "" -- Additional page suffixes in which to disallow categories		local suffixes_unparsed = args["suffixes" ] or "" -- Additional page suffixes in which to disallow categories
	local is_debug = yesno(args["debug"], false) -- Parse debug mode; setting this to TRUE disables all categories		local is_debug = yesno(args["debug"], false) -- Parse debug mode; setting this to TRUE disables all categories
			local wtext = yesno(args["wtext"]) -- Used to show the underlying Wikitext

	-- Parse categories		-- Parse categories
Line 212:		Line 213:
	end		end

	~~return~~ p._category_handler(cats, is_debug, ns_override, suffixes)		local result = p._category_handler(cats, is_debug, ns_override, suffixes)

			if wtext then
			result = "<syntaxhighlight lang=\"wikitext\">" .. result .. "</syntaxhighlight>"
			end

			return frame:preprocess(result)
	end		end

	return p		return p

Ganaram inukshuk: refactor main so debug option is second

2025-10-29T07:33:49Z

refactor main so debug option is second

← Older revision		Revision as of 07:33, 29 October 2025
Line 134:		Line 134:
	-- Disallows categories if it's in a suppressed namespace or the page has a		-- Disallows categories if it's in a suppressed namespace or the page has a
	-- suppressed suffix (subpage)		-- suppressed suffix (subpage)
	function p._category_handler(cats, ns_override, suffixes~~, is_debug~~)		function p._category_handler(cats, is_debug, ns_override, suffixes)
	local cats = cats or {}		local cats = cats or {}
	local is_debug = yesno(is_debug, false)		local is_debug = yesno(is_debug, false)
Line 212:		Line 212:
	end		end

	return p._category_handler(cats, ns_override, suffixes~~, is_debug~~)		return p._category_handler(cats, is_debug, ns_override, suffixes)
	end		end

	return p		return p

Ganaram inukshuk: add namespace alias handling, so main-namespace can be specified

2025-10-24T06:42:43Z

add namespace alias handling, so main-namespace can be specified

← Older revision		Revision as of 06:42, 24 October 2025
Line 26:		Line 26:
	-- Adjust as needed!		-- Adjust as needed!
	local DEFAULT_SUPPRESSED_NAMESPACES = {		local DEFAULT_SUPPRESSED_NAMESPACES = {
			["main"] = false,
	["talk"] = true,		["talk"] = true,
	["user"] = true,		["user"] = true,
Line 49:		Line 50:
	"sandbox",		"sandbox",
	}		}

			-- List of namespace aliases
			-- For "main", this is so editors can type in "main" since the main namespace's
			-- actual name is "". For "xw"-related namespaces, these are shorthands.
			local NAMESPACE_ALIASES = {
			[""] = "main", -- "" is treated as "main"
			["xw"] = "xenharmonic wiki", -- Shorthand
			["xw talk"] = "xenharmonic wiki talk" -- Shorthand
			}

			-- Helper function
			-- Converts namespace aliases to their actual names
			-- Must be placed before is_suppressed_namespace()
			local function normalize_ns(ns)
			ns = mw.ustring.lower(mw.text.trim(ns or "")) -- Convert to lowercase and and trim extra spaces
			if ns == "" then ns = "main" end -- Empty-string is assumed to be "main"
			if NAMESPACE_ALIASES[ns] then
			return NAMESPACE_ALIASES[ns]
			end
			return ns
			end

	-- Helper function: check if current namespace is excluded		-- Helper function: check if current namespace is excluded
	-- Accepts an optional table, containing or overriding other namespaces' rules		-- Accepts an optional table, containing or overriding other namespaces' rules
	local function is_suppressed_namespace(ns_override)		local function is_suppressed_namespace(ns_override)
	-- Get current namespace, as lowercase		-- Get current namespace, or aliased namespace, as lowercase
	local curr_ns = ~~mw.ustring.lower~~(mw.title.getCurrentTitle().nsText ~~or ''~~)		local curr_ns = normalize_ns(mw.title.getCurrentTitle().nsText)

	-- Build table of suppressed namespaces; start with default list		-- Build table of suppressed namespaces; start with default list
	local namespaces = {}		local namespaces = {}
	for k, v in pairs(DEFAULT_SUPPRESSED_NAMESPACES) do		for k, v in pairs(DEFAULT_SUPPRESSED_NAMESPACES) do
	namespaces[k] = v		namespaces[normalize_ns(k)] = v
	end		end

Line 65:		Line 87:
	if type(ns_override) == "table" then		if type(ns_override) == "table" then
	for k, v in pairs(ns_override) do		for k, v in pairs(ns_override) do
	namespaces[k] = v		namespaces[normalize_ns(k)] = v
	end		end
	end		end

Ganaram inukshuk: comments

2025-10-23T23:19:17Z

comments

← Older revision		Revision as of 23:19, 23 October 2025
Line 12:		Line 12:
	-- - Infoboxes; these usually shouldn't categorize if they're outside the main		-- - Infoboxes; these usually shouldn't categorize if they're outside the main
	-- namespace.		-- namespace.
	-- - Certain mboxes; some mboxes categorize ~~certain~~ pages, but ~~they shouldn~~'t		-- - Certain mboxes; some mboxes categorize pages, but if that mbox categorizes
	-- categorize their own ~~documentation~~.		-- templates/modules and are placed on that page's /doc subpage, it should
			-- categorize the page on which the documentation is transcluded, not the /doc
			-- page itself.
			-- - Categorizing templates used on their own /doc pages as examples; a special
			-- case of the previous case; passing in debug=1 disables all categorization.

	-- Default list of namespaces in which to suppress categorization. Most		-- Default list of namespaces in which to suppress categorization. Most

Ganaram inukshuk: add allowed namespaces to override default list

2025-10-22T21:43:47Z

add allowed namespaces to override default list

← Older revision		Revision as of 21:43, 22 October 2025
Line 166:		Line 166:
	end		end

	-- ~~TODO: parse~~ allowed namespaces		-- Parse allowed namespaces
	-- This gets added to the ns_override array, with values set to FALSE		-- This gets added to the ns_override array, with values set to FALSE
	-- EG, Template:TODO ~~gets~~ used ~~on more~~ namespaces ~~than just the unsuppressed~~		-- EG, Template:TODO is used in several namespaces that are normally
	-- ~~ones~~: user, talk, help, maybe xw talk		-- suppressed: user, talk, help, and maybe xw talk
			for ns in mw.text.gsplit(allowed_ns_unparsed, "[;\n]") do
			ns = mw.text.trim(ns)
			if ns ~= "" then
			ns_override[ns] = false
			end
			end

	-- Parse excluded suffixes		-- Parse excluded suffixes

Ganaram inukshuk: todo

2025-10-22T09:51:26Z

todo

← Older revision		Revision as of 09:51, 22 October 2025
Line 168:		Line 168:
	-- TODO: parse allowed namespaces		-- TODO: parse allowed namespaces
	-- This gets added to the ns_override array, with values set to FALSE		-- This gets added to the ns_override array, with values set to FALSE
			-- EG, Template:TODO gets used on more namespaces than just the unsuppressed
			-- ones: user, talk, help, maybe xw talk

	-- Parse excluded suffixes		-- Parse excluded suffixes

Ganaram inukshuk: todo; comments

2025-10-22T09:42:19Z

todo; comments

← Older revision		Revision as of 09:42, 22 October 2025
Line 139:		Line 139:
	function p.category_handler(frame)		function p.category_handler(frame)
	local args = getArgs(frame)		local args = getArgs(frame)
	local excluded_ns_unparsed = args["excluded_ns"] or ""		local excluded_ns_unparsed = args["excluded_ns"] or "" -- Additional namespaces to exclude (EG, a template that should not be used within main namespace, which is allowed by default)
	local suffixes_unparsed = args["suffixes" ] or ""		local allowed_ns_unparsed = args["allowed_ns" ] or "" -- Namespaces to allow; overrides default list (EG, a template that should be used within user namespace, which is disallowed by default)
			local suffixes_unparsed = args["suffixes" ] or "" -- Additional page suffixes in which to disallow categories
	local is_debug = yesno(args["debug"], false) -- Parse debug mode; setting this to TRUE disables all categories		local is_debug = yesno(args["debug"], false) -- Parse debug mode; setting this to TRUE disables all categories

Line 152:		Line 153:
	end		end
	end		end

	~~--[[~~
	~~for cat in mw.text.gsplit(cats_unparsed, "[;\n]") do~~
	~~cat = mw.text.trim(cat)~~
	~~if cat ~= "" then~~
	~~table.insert(cats, cat)~~
	~~end~~
	~~end~~
	~~]]--~~

	-- Parse excluded namespaces		-- Parse excluded namespaces
Line 173:		Line 165:
	end		end
	end		end

			-- TODO: parse allowed namespaces
			-- This gets added to the ns_override array, with values set to FALSE

	-- Parse excluded suffixes		-- Parse excluded suffixes

Ganaram inukshuk: refactor; try to enter category names one by one as unnamed params

2025-10-22T09:02:06Z

refactor; try to enter category names one by one as unnamed params

← Older revision		Revision as of 09:02, 22 October 2025
Line 135:		Line 135:
	return result		return result
	end		end


	-- Wrapper for templates calling via #invoke		-- Wrapper for templates calling via #invoke
	function p.category_handler(frame)		function p.category_handler(frame)
	local args = getArgs(frame)		local args = getArgs(frame)
	~~local cats_unparsed = args["categories" ] or ""~~
	local excluded_ns_unparsed = args["excluded_ns"] or ""		local excluded_ns_unparsed = args["excluded_ns"] or ""
	local suffixes_unparsed = args["suffixes" ] or ""		local suffixes_unparsed = args["suffixes" ] or ""
Line 146:		Line 144:

	-- Parse categories		-- Parse categories
			-- Categories are entered using unnamed params
	local cats = {}		local cats = {}
			for _, cat in ipairs(args) do
			cat = mw.text.trim(cat)
			if cat ~= "" then
			table.insert(cats, cat)
			end
			end

			--[[
	for cat in mw.text.gsplit(cats_unparsed, "[;\n]") do		for cat in mw.text.gsplit(cats_unparsed, "[;\n]") do
	cat = mw.text.trim(cat)		cat = mw.text.trim(cat)
Line 153:		Line 160:
	end		end
	end		end
			]]--

	-- Parse excluded namespaces		-- Parse excluded namespaces

Ganaram inukshuk: a semicolon

2025-10-21T08:56:49Z

a semicolon

← Older revision		Revision as of 08:56, 21 October 2025
Line 147:		Line 147:
	-- Parse categories		-- Parse categories
	local cats = {}		local cats = {}
	for cat in mw.text.gsplit(cats_unparsed, "[,\n]") do		for cat in mw.text.gsplit(cats_unparsed, "[;\n]") do
	cat = mw.text.trim(cat)		cat = mw.text.trim(cat)
	if cat ~= "" then		if cat ~= "" then

Ganaram inukshuk: rollback again^2

2025-10-21T08:53:14Z

rollback again^2

Show changes