Modul:category tree/poscatboiler/data/wiktionary maintenance

Berikut merupakan pendokumenan yang dijana oleh Templat:poscatboiler data submodule documentation. ^[sunting]

Pautan berguna: laman akar • sublaman • pautan • transklusi • kes ujian • kotak pasir

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:pages").is_valid_title
local new_title = mw.title.new
local split_lang_label = require("Module:category tree").split_lang_label
local php_trim = require("Module:string utilities").php_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["Kategori tersembunyi"] = {
	description = "Kategori yang menggunakan suis tingkah laku <code>[[mw:Help:Magic words#HIDDENCAT|<nowiki>__HIDDENCAT__</nowiki>]]</code>, yang menyembunyikan kategori ini daripada senarai kategori umum serta tidak akan dapat dilihat pengguna melainkan keutamaan penampilan diubah.",
	parents = "Penyelenggaraan Wikikamus",
	can_be_empty = true,
	hidden = true,
}

raw_categories["Indexed pages"] = {
	description = "Pages using the <code>[[mw:Help:Magic words#INDEX|<nowiki>__INDEX__</nowiki>]]</code> behavior switch, which tells search engines to index the page.",
	parents = "Penyelenggaraan Wikikamus",
	can_be_empty = true,
	hidden = true,
}

raw_categories["Noindexed pages"] = {
	description = "Pages using the <code>[[mw:Help:Magic words#NOINDEX|<nowiki>__NOINDEX__</nowiki>]]</code> behavior switch, which tells search engines not to index the page.",
	parents = "Penyelenggaraan Wikikamus",
	can_be_empty = true,
	hidden = true,
}

raw_categories["Noindexed pages"] = {
	description = "Pages using the <code>[[mw:Help:Magic words#NOINDEX|<nowiki>__NOINDEX__</nowiki>]]</code> behavior switch.",
	parents = "Penyelenggaraan Wikikamus",
	can_be_empty = true,
	hidden = true,
}

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

raw_categories["Laman dengan aksara tab"] = {
	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 = "Aksara tab",
	parents = "Penyelenggaraan Wikikamus",
	can_be_empty = true,
	hidden = true,
}

raw_categories["Laman dengan pengepala bahasa dalam susunan salah"] = {
	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 = "Pengepala bahasa dalam susunan salah",
	parents = "Penyelenggaraan Wikikamus",
	can_be_empty = true,
	hidden = true,
}

raw_categories["Laman dengan pengepala bahasa tidak piawai"] = {
	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 = "Pengepala bahasa tidak piawai",
	parents = "Penyelenggaraan Wikikamus",
	can_be_empty = true,
	hidden = true,
}

raw_categories["Laman dengan pengepala L1 tidak dikehendaki"] = {
	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 = "Pengepala L1 tidak dikehendaki",
	parents = "Penyelenggaraan Wikikamus",
	can_be_empty = true,
	hidden = true,
}

raw_categories["Laman dengan parameter templat bertanda kurung dakap gandaan tiga"] = {
	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 = "Parameter templat mentah",
	parents = "Penyelenggaraan Wikikamus",
	can_be_empty = true,
	hidden = true,
}

raw_categories["Laman dengan percanggahan DEFAULTSORT"] = {
	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["Laman dengan percanggahan DISPLAYTITLE"] = {
	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 mainspace or the Reconstruction namespace)." ..
		"\n\nSee also [[:Category:Pages with DEFAULTSORT conflicts]].",
	breadcrumb = "Percanggahan DISPLAYTITLE",
	parents = "Penyelenggaraan Wikikamus",
	can_be_empty = true,
	hidden = true,
}

raw_categories["Laman dengan kunci isih mentah"] = {
	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 = "Kunci isih mentah",
	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 = "Module errors",
	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["Kategori yang memanggil Templat:auto cat"] = {
	description = "Kategori yang telah diletakkan dalam kategori lain dengan memanggil {{tl|auto cat}}.",
	additional = "Inilah cara yang diutamakan untuk mensubkategorikan kesemua kategori. Sebab utama kategori ini adalah untuk memudahkan pencarian kategori yang tidak menggunakan {{tl|auto cat}} melalui penggunaan carian negatif (yakni dengan membuat saringan carian menggunakan {{code|-incategory:\"{{PAGENAME}}\"}}).",
	parents = "Penyelenggaraan Wikikamus",
	can_be_empty = true,
	hidden = true,
}

raw_categories["Kategori dengan kategori menggunakan penanda mentah"] = {
	description = "Categories that have been placed in another category using raw wiki markup (e.g. {{code|<nowiki>[[Category:Wiktionary]]</nowiki>}}). They should be added to the [[Module:category tree|category tree]] data instead.",
	parents = "Penyelenggaraan Wikikamus",
	can_be_empty = true,
	hidden = 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()
			-- Check for {{#invoke:checkparams|warn|...}}.
			-- args[1] is the module and args[2] is the function name, so #INVOKE: will throw an error if either is not present.
			for template in require("Module:template parser").find_templates(content) do
				if template:get_name() == "#INVOKE:" then
					local args = template:get_arguments()
					local arg_2 = args[2]
					if arg_2 and php_trim(args[1]) == "checkparams" and php_trim(arg_2) == "warn" then
						can_be_empty = true
						break
					end
				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}