Pergi ke kandungan

Modul:category tree/poscatboiler/data/wiktionary maintenance

Daripada Wikikamus

Submodul data ini mentakrifkan sebahagian daripada struktur kategori Wikikamus.

Untuk pengenalan kepada sistem poscatboiler dan penerangan tentang cara menambah atau mengubah suai kategori, lihat Modul:category tree/poscatboiler/data/doc.


local raw_categories = {}
local raw_handlers = {}

local m_template_parser = require("Module:template parser")

local get_lang = require("Module:languages").getByCode
local insert = table.insert
local is_valid_title = require("Module:utilities").is_valid_title
local new_title = mw.title.new
local split_lang_label = require("Module:auto cat").split_lang_label
local trim = require("Module:string utilities").trim
local uses_hidden_category = require("Module:maintenance category").uses_hidden_category

-----------------------------------------------------------------------------
--                                                                         --
--                              RAW CATEGORIES                             --
--                                                                         --
-----------------------------------------------------------------------------

raw_categories["Penyelenggaraan Wikikamus"] = {
	description = "Kategori mengandungi laman yang dijejak untuk perhatian dan kemas kini penyunting.",
	breadcrumb = "Penyelenggaraan",
	parents = "Wiktionary",
}

raw_categories["Pages using lite templates"] = {
	description = "Pages which use at least one of the lite templates.",
	additional = "See [[:Category:Lua-free templates]].",
	breadcrumb = "Using lite templates",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
	hidden = true,
}

raw_categories["Pages with tab characters"] = {
	description = "Pages which contain a tab character in their wikitext.",
	additional = "These should either be removed or replaced with spaces, because they go against [[WT:NORM]].",
	breadcrumb = "Tab characters",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
	hidden = true,
}

raw_categories["Pages with language headings in the wrong order"] = {
	description = "Pages in which the headings for each language's entry are in the wrong order.",
	additional = "Level 2 language headings should be in alphabetical order, except for Translingual and English, which go at the top (in that order).",
	breadcrumb = "Language headings in the wrong order",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
	hidden = true,
}

raw_categories["Pages with nonstandard language headings"] = {
	description = "Pages which contain a level 2 heading which does not match any language's canonical name.",
	additional = "The level 2 language heading for each language should always be that language's canonical name.",
	breadcrumb = "Nonstandard language headings",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
	hidden = true,
}

raw_categories["Pages with unwanted L1 headings"] = {
	description = "Pages which contain an unwanted level 1 heading.",
	additional = "Level 1 headings are not used in Wiktionary content pages, and only occur due to user error or vandalism.",
	breadcrumb = "Unwanted L1 headings",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
	hidden = true,
}

raw_categories["Pages with raw triple-brace template parameters"] = {
	description = "Pages which contain raw template parameters in the form of triple braces.",
	additional = "Triple-brace template parameters (e.g. {{param|param}}) are intended for use in templates, as they are substituted with the relevant template argument when the page is transcluded. Although they can theoretically be used on any page, there are currently no legitimate uses for them in content namespaces.\n\nTemplate parameters usually occur due to typos, or when {{tl|subst:}} has been used with a template that isn't supposed to be substed.",
	breadcrumb = "Raw template parameters",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
	hidden = true,
}

raw_categories["Pages with DEFAULTSORT conflicts"] = {
	topright = "{{shortcut|CAT:DEFAULTSORT}}",
	description = "Pages on which the {{tl|DEFAULTSORT:}} magic word has been used multiple times with different values.",
	additional = "In some (but not all) cases, this causes a warning to display on the page. In the vast majority of instances, an explicit use of {{tl|DEFAULTSORT:}} in wikitext should be <u>removed</u>.This is because the {{tl|head}} template handles it automatically. The only instances where it should be used in wikitext is outside of entries (i.e. outside of mainspace or the Reconstruction namespace)." ..
		"\n\nSee also [[:Category:Pages with DISPLAYTITLE conflicts]].",
	breadcrumb = "DEFAULTSORT conflicts",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
	hidden = true,
}

raw_categories["Pages with DISPLAYTITLE conflicts"] = {
	topright = "{{shortcut|CAT:DISPLAYTITLE}}",
	description = "Pages on which the {{tl|DISPLAYTITLE:}} magic word has been used multiple times with different values.",
	additional = "In some (but not all) cases, this causes a warning to display on the page. In the vast majority of instances, an explicit use of {{tl|DISPLAYTITLE:}} in wikitext should be <u>removed</u>.This is because the {{tl|head}} template handles it automatically. The only instances where it should be used in wikitext is outside of entries (i.e. outside of maiespace)." ..
		"\n\nSee also [[:Category:Pages with DEFAULTSORT conflicts]].",
	breadcrumb = "DISPLAYTITLE conflicts",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
	hidden = true,
}

raw_categories["Pages with raw sortkeys"] = {
	description = "Pages on which a sortkey has been used with a raw category.",
	additional = "For example, {{code|<nowiki>[[Category:IPA symbols|B]]</nowiki>}}." ..
	"\n\nThese are a priority to replace with category templates, since they are hard-coded and override the {{tl|DEFAULTSORT:}} value for the page. This causes problems if there are any changes to the sorting scheme for the category, because there is no way of changing them centrally.\n\n" ..
	"By comparison, raw categories which have no sortkey are less of a problem, because they will use the {{tl|DEFAULTSORT:}} value; this can be centrally controlled and is designed to be language-neutral, so avoids the issue of different editors using multiple different sorting schemes for the same category. However, they should still be replaced with category templates, since there may be additional language-specific sorting rules which cannot otherwise be applied.",
	breadcrumb = "Raw sortkeys",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
	hidden = true,
}

raw_categories["Laman dengan ralat modul"] = {
	topright = "{{shortcut|CAT:E|CAT:ERR|CAT:ERROR}}",
	description = "Pages that have errors in a [[Wiktionary:Scribunto|Lua]] module.",
	additional = "If entries are listed here for more than a day or two, the error should probably be reported at [[Wiktionary:GP|the Grease Pit]]. Memory errors are a common source of these errors; see the discussion at [[Wiktionary:Lua memory errors]]." ..
		"\n\nBecause the software does not immediately update pages when a change occurs in a template or module, errors listed here may have already been fixed. Therefore, please ensure that the error is still present before reporting problems. You can do this by performing a \"[[meta:Help:Dummy_edit#Null_edit|null edit]]\" (editing the page and saving without making changes). If the error goes away then, it has already been fixed." ..
		"\n\n<u>You can use [https://en.wiktionary.org/wiki/Special:ApiSandbox#action=purge&format=json&forcelinkupdate=1&generator=categorymembers&utf8=1&formatversion=2&gcmtitle=Category%3APages%20with%20module%20errors&gcmlimit=20 this link] and press \"Make request\" to purge the cache of up to 20 pages from this category in one click.</u> This number can be adjusted up to 5,000, but anything above 30-100 will likely cause time-outs (depending on the size of the pages)." ..
		"\n\nThe contents of this category is controlled by [[Template:maintenance category]]. It is currently set to place talk pages, user pages{{,}} and user sandbox modules and templates in a separate category." ..
		"\n\nSee also [[:Category:Pages with ParserFunction errors]].",
	breadcrumb = "Ralat modul",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
	hidden = true,
}

raw_categories["Pages with ParserFunction errors"] = {
	topright = "{{shortcut|CAT:PFE}}",
	description = "Pages that have errors in a [[mw:Help:Extension:ParserFunctions|ParserFunction]] magic word.",
	additional = "Examples of these magic words are {{tl|#expr:}} and {{tl|#time:}}. If entries are listed here for more than a day or two, the error should probably be reported at [[Wiktionary:GP|the Grease Pit]]." ..
		"\n\nBecause the software does not immediately update pages when a change occurs in a template or module, errors listed here may have already been fixed. Therefore, please ensure that the error is still present before reporting problems. You can do this by performing a \"[[meta:Help:Dummy_edit#Null_edit|null edit]]\" (editing the page and saving without making changes). If the error goes away then, it has already been fixed." ..
		"\n\n<u>You can use [https://en.wiktionary.org/wiki/Special:ApiSandbox#action=purge&format=json&forcelinkupdate=1&generator=categorymembers&utf8=1&formatversion=2&gcmtitle=Category%3APages%20with%20ParserFunction%20errors&gcmlimit=20 this link] and press \"Make request\" to purge the cache of up to 20 pages from this category in one click.</u> This number can be adjusted up to 5,000, but anything above 30-100 will likely cause time-outs (depending on the size of the pages)." ..
		"\n\nThe contents of this category is controlled by [[Template:maintenance category]]. It is currently set to place talk pages, user pages{{,}} and user sandbox modules and templates in a separate category." ..
		"\n\nSee also [[:Category:Pages with module errors]].",
	breadcrumb = "ParserFunction errors",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
	hidden = true,
}

raw_categories["Requests for moves, mergers and splits"] = {
	description = "Pages and categories which have been tagged with a request for them to be moved, merged or split.",
	breadcrumb = "Moves, mergers and splits",
	parents = {"Penyelenggaraan Wikikamus", "Requests"},
	can_be_empty = true,
	hidden = true,
}

raw_categories["Pages to be merged"] = {
	description = "Pages tagged to be merged by the {{tl|merge}} template.",
	parents = {"Requests for moves, mergers and splits"},
	can_be_empty = true,
}

raw_categories["Pages to be moved"] = {
	description = "Pages tagged to be moved by the {{tl|move}} template.",
	parents = {"Requests for moves, mergers and splits"},
	can_be_empty = true,
}

raw_categories["Pages to be split"] = {
	description = "Pages tagged to be split by the {{tl|split}} template.",
	parents = {"Requests for moves, mergers and splits"},
	can_be_empty = true,
}

raw_categories["Pages using invalid parameters when calling templates"] = {
	description = "Pages that use unrecognized parameters when calling a template.",
	breadcrumb = "Invalid template parameters",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
}

raw_categories["Pages using deprecated source tags"] = {
	description = "Pages that use the [[mw:Extension:SyntaxHighlight|SyntaxHighlight]] extension with legacy {{wt|source}} tags instead of {{wt|syntaxhighlight}}.",
	breadcrumb = "Deprecated source tags",
	parents = {"Penyelenggaraan Wikikamus"},
	can_be_empty = true,
	hidden = true,
}

insert(raw_handlers, function(data)
	local template_type = data.category:match("^Pages using invalid parameters when calling (.+) templates$")
	
	if not template_type then
		return
	end
	
	local parents = {{
		name = "Pages using invalid parameters when calling templates",
		sort = template_type == "general use" and "*" or template_type,
	}}
	
	local lang = require("Module:languages").getByCanonicalName(template_type, nil, true)
	if lang then
		insert(parents, {name = "entry maintenance", is_label = true, lang = lang:getCode()})
	end
	
	return {
		lang = lang and lang:getCode() or nil,
		description = "Pages that use unrecognized parameters when calling " .. template_type .. " templates.",
		parents = parents,
		breadcrumb = template_type,
	}
end)

do
	local prefixes = require("Module:table").listToSet{"list", "P", "R", "RQ", "table", "U"}
	
	local function add_parent(parents, seen, cat_type, sortkey)
		if seen[cat_type] then
			return
		end
		insert(parents, {
			name = ("Pages using invalid parameters when calling %s templates"):format(cat_type),
			sort = sortkey,
		})
		seen[cat_type] = true
	end
	
	insert(raw_handlers, function(data)
		local template = data.category:match("^Pages using invalid parameters when calling (.+)$")
		
		if not template then
			return
		end
		
		-- Resolve any redirects.
		template = new_title(template)
		while template do
			local redirect = template.redirectTarget
			if not is_valid_title(redirect) then
				break
			end
			template = redirect
		end
		
		-- Disallow templates which would always hidden maintennace categories (e.g. sandboxes).
		if not (template and not uses_hidden_category(template)) then
			return
		end
		
		local prefixed_text, lang = template.prefixedText
		if template.namespace == 10 then
			local name = template.text
			-- Remove the prefix if present (e.g. "R:" or "RQ:").
			local prefix, text = name:match("^(.-):(.+)")
			if not (prefix and prefixes[prefix]) then
				text = name
			end
			-- Check the initial language code, chopping off hyphenated sections until there's a match or they run out.
			local code = mw.ustring.match(text, "^[a-z][a-zA-Z-]*[a-zA-Z]%f[^%w]")
			while code do
				lang = get_lang(code)
				if lang then
					break
				end
				code = code:match("(.+)%-%a*$")
			end
			-- If no match and it's a list: or table: template, check if the template name ends "/CODE".
			if not lang and (prefix == "list" or prefix == "table") then
				code = text:match("%f[^/]%l[%a-]*%a$")
				if code then
					lang = get_lang(code)
				end
			end
		end
		
		local sortkey = template.text
		local parents, seen = {}, {}
		
		-- Categorize as language-specific if a language was found.
		if lang then
			add_parent(parents, seen, lang:getCanonicalName(), sortkey)
		end
		
		-- Also grab any language categories from the template page.
		for _, cat in ipairs(template.categories) do
			if cat:sub(-10) == " templates" or cat:sub(-13) == " subtemplates" then
				local cat_lang = split_lang_label(new_title(cat))
				if cat_lang then
					add_parent(parents, seen, cat_lang:getCanonicalName(), sortkey)
				end
			end
		end
		
		-- If none were found, categorize as general use.
		if #parents == 0 then
			add_parent(parents, seen, "general use", sortkey)
		end
		
		-- Only add can_be_empty if the template exists and contains checkparams.
		local content, can_be_empty = template:getContent()
		if content then
			local frame = mw.getCurrentFrame()
			for t, args in m_template_parser.findTemplates(content) do
				-- Check for {{#invoke:checkparams|warn|...}}. Note: arg 1 has already been preprocessed.
				if t == "#INVOKE:" and trim(args[1]) == "checkparams" and trim(frame:preprocess(args[2])) == "warn" then
					can_be_empty = true
					break
				end
			end
		end
		
		return {
			canonical_name = "Pages using invalid parameters when calling " .. prefixed_text,
			lang = lang and lang:getCode() or nil,
			description = ("Pages that use unrecognized parameters when calling {{tl|%s}}.")
				:format(m_template_parser.getTemplateInvocationName(template)),
			additional = "These template calls should be reviewed and the invalid parameter(s) should be corrected or removed.",
			breadcrumb = prefixed_text,
			parents = parents,
			can_be_empty = can_be_empty,
			hidden = true,
		}
	end)
end

return {RAW_CATEGORIES = raw_categories, RAW_HANDLERS = raw_handlers}