Modulo:Kita ti panid

Dokumentasion ti modulo

[kitaen] [urnosen] [pakasaritaan] [purgaen]

Inus-usar daytoy a modulo kadagiti mensahe ti sistema.
Dagiti panagbaliw iti daytoy ket gapuanan dagiti dagus a panagbaliw iti interface ti agar-aramat iti Wikipedia. Tapno maliklikan ti nakaro a pannakagulo, nasken nga umuna a masubokan dagiti ania man a panagbaliw kadagiti subpanid ti /pagipadasan wenno /pangsubok ti modulo, wenno iti bukodmo a pagipadasan. Mabalinton a mainayon dagiti nasubokan a panagbaliw iti maysa a panagurnos iti daytoy a modulo. Pangngaasi a pakitungtungan dagiti ania man a panagbaliw iti panid ti tungtungan sakbay nga isayangkat.

Inus-usar daytoy a modulo kadagiti adu a panid, no baliwam adunto ti makadlaw. Pangngaasi nga umuna a subokan kadagiti subpanid ti /pagipadasan wenno /pangsubok, wenno iti bukodmo a subpanid, ken usigen a pagtungtungan dagiti binaliwan iti panid ti tungtungan sakbay nga isayangkat.

Daytoy dokumentasion a subpanid ti modulo ket saan pay wenno agdama pay laeng a maipatpatarus. No kayat ti tumulong nga agipatarus kadagiti kastoy a panid, kitaen ti Kategoria:Dagiti subpanid ti dokumentasion a nasken a maipatarus.

This module is used to detect the page type of a given page. It detects redirect pages automatically and is highly customisable. It can be used on its own or as a meta-module to create other page-type-detection templates. This module can also be accessed using {{kita ti panid}}.

Syntax

Basic usage

{{#invoke:kita ti panid|main}}

All parameters

{{#invoke:kita ti panid|main
| page              = 
| defaultns         = 
| main              = 
| user              = 
| wikipedia         = 
| project           = 
| wp                = 
| file              = 
| image             = 
| mediawiki         = 
| template          = 
| help              = 
| category          = 
| portal            = 
| book              = 
| draft             = 
| education program = 
| timedtext         = 
| module            = 
| special           = 
| media             = 
| talk              = 
| redirect          = 
| dab               = 
| na                = 
| other             = 
}}

Basic usage

For simple detection of the page type of the current page, use the default settings:

{{#invoke:kita ti panid|main}}

That will produce the following results, depending on the page type or the namespace:

Page type / namespace	Output
Redirects (in any namespace)	`redirect`
Main namespace	`article`
File namespace	`file`
Template namespace	`template`
Category namespace	`category`
Module namespace	`module`
Book namespace	`book`
Other namespaces	`page`

If the module is used on a talk page, it will detect the page type for the corresponding subject page.

Example

Code	Result
`{{#invoke:kita ti panid\|main}}`	modulo

Page parameter

You can use the page parameter to make the module act as though it was called from that page.

{{#invoke:kita ti panid|main|page=page name}}

Examples

Code	Result
`{{#invoke:kita ti panid\|main\|page=Estados Unidos iti Amerika}}`	artikulo
`{{#invoke:kita ti panid\|main\|page=USA}}`	baw-ing
`{{#invoke:kita ti panid\|main\|page=Tungtungan:Estados Unidos iti Amerika}}`	artikulo
`{{#invoke:kita ti panid\|main\|page=File:Example.svg}}`	papeles
`{{#invoke:kita ti panid\|main\|page=Wikipedia:Pungol}}`	panid
`{{#invoke:kita ti panid\|main\|page=TimedText:Imagine.ogg.en.srt}}`	panid

Adding and removing namespaces

It is possible to specify different behaviour for each namespace than that described in the basic usage section. For example, you might want the module to display "user page" for pages in the user namespace, instead of the default "page". To do this, you can use the code |user=yes. This looks up the typical name used for pages in the user namespace, in this case "user page", and uses that text when the module is used with a page in the user namespace. To use this with other namespaces, use the namespace name in lower case as a parameter:

{{#invoke:kita ti panid|main
| user              = yes
| wikipedia         = yes
| project           = yes
| wp                = yes
| mediawiki         = yes
| help              = yes
| portal            = yes
| draft             = yes
| education program = yes
| timedtext         = yes
| special           = yes
| media             = yes
}}

You can use any of the following to specify the namespace: "yes", "y", "true" or "1". They can be used in any combination of upper and lower case. (These values are defined by Modulo:Wensaan.)

The default text for these namespaces is as follows:

Page type / namespace	Output
User namespace	`user page`
Wikipedia namespace	`project page`
MediaWiki namespace	`interface page`
Help namespace	`help page`
Portal namespace	`portal`
Draft namespace	`draft`
Education program namespace	`education program page`
Timed Text namespace	`Timed Text page`
Special namespace	`special page`
Media namespace	`file`

You can use a similar process to remove any of the default namespace values as well. For example, if you use the code |template=no, then the module will display "page" when used on a template page, rather than the default "template".

{{#invoke:kita ti panid|main
| main     = no
| file     = no
| template = no
| category = no
| module   = no
| book     = no
}}

The following values will all work to remove namespace values: "no", "n", "false" or "0". They can be used in any combination of upper and lower case.

Examples

Code	Result
`{{#invoke:kita ti panid\|main\|page=Wikipedia:Pugol}}`	panid
`{{#invoke:kita ti panid\|main\|page=Wikipedia:Pugol\|wikipedia=yes}}`	panid ti proyekto
`{{#invoke:kita ti panid\|main\|page=Tungtungan:Estados Unidos iti Amerika}}`	artikulo
`{{#invoke:kita ti panid\|main\|page=Tungtungan:Estados Unidos iti Amerika\|talk=y}}`	tungtungan a panid
`{{#invoke:kita ti panid\|main\|page=Estados Unidos iti Amerika}}`	artikulo
`{{#invoke:kita ti panid\|main\|page=Estados Unidos iti Amerika\|main=no}}`	panid
`{{#invoke:kita ti panid\|main\|page=TimedText:Imagine.ogg.en.srt}}`	panid
`{{#invoke:kita ti panid\|main\|page=TimedText:Imagine.ogg.en.srt\|timedtext=Yes}}`	panid

Default namespace sets

As well as adding and removing individual namespaces, it is possible to specify different sets of namespaces by using the |defaultns=. There are four different sets available: all, extended, none and the default set. These sets allow you to specify many namespaces at once, without having to use all of the individual namespace parameters. Namespaces are set according to the following table:

Namespace	Value of `\|defaultns=`				Output
Namespace	`none`	`extended`	`all`	Other values	Output
Main	N	Y	Y	Y	article
User	N	Y	Y	N	user page
Wikipedia	N	Y	Y	N	project page
File	N	Y	Y	Y	file
MediaWiki	N	Y	Y	N	interface page
Template	N	Y	Y	Y	template
Help	N	Y	Y	N	help page
Category	N	Y	Y	Y	category
Portal	N	Y	Y	N	portal
Book	N	Y	Y	Y	book
Draft	N	Y	Y	N	draft
Education Program	N	N	Y	N	education program page
TimedText	N	N	Y	N	Timed Text page
Module	N	Y	Y	Y	module
All talk namespaces	N	N	Y	N	talk page
Special	N	N	Y	N	special page
Media	N	N	Y	N	file

Examples

Code	Result
`{{#invoke:kita ti panid\|main\|page=Estados Unidos iti Amerika}}`	artikulo
`{{#invoke:kita ti panid\|main\|page=Estados Unidos iti Amerika\|defaultns=none}}`	panid
`{{#invoke:kita ti panid\|main\|page=Tuntungan:Estados Unidos iti Amerika}}`	artikulo
`{{#invoke:kita ti panid\|main\|page=Tungtungan:Estados Unidos iti Amerika\|defaultns=all}}`	tungtungan a panid
`{{#invoke:kita ti panid\|main\|page=File:Example.svg}}`	papeles
`{{#invoke:kita ti panid\|main\|page=File:Example.svg\|defaultns=none}}`	panid
`{{#invoke:kita ti panid\|main\|page=Wikipedia:Namespace}}`	panid
`{{#invoke:kita ti panid\|main\|page=Wikipedia:Namespace\|defaultns=extended}}`	panid ti proyekto
`{{#invoke:kita ti panid\|main\|page=TimedText:Imagine.ogg.en.srt\|defaultns=extended}}`	panid
`{{#invoke:kita ti panid\|main\|page=TimedText:Imagine.ogg.en.srt\|defaultns=all}}`	panid

Custom namespace values

It is possible to specify a custom value for any namespace:

{{#invoke:kita ti panid|main
| main              = custom text
| user              = custom text
| wikipedia         = custom text
| project           = custom text
| wp                = custom text
| file              = custom text
| image             = custom text
| mediawiki         = custom text
| template          = custom text
| help              = custom text
| category          = custom text
| portal            = custom text
| book              = custom text
| draft             = custom text
| education program = custom text
| timedtext         = custom text
| module            = custom text
| special           = custom text
| media             = custom text
}}

Examples

Code	Result
`{{#invoke:kita ti panid\|main\|page=Wikipedia:Pungol}}`	panid
`{{#invoke:kita ti panid\|main\|page=Wikipedia:Pungol\|wikipedia=custom text}}`	custom text
`{{#invoke:kita ti panid\|main\|page=Tungtungan:Estados Unidos iti Amerika}}`	artikulo
`{{#invoke:kita ti panid\|main\|page=Tungtungan:Estados Unidos iti Amerikatalk=custom text}}`	custom text
`{{#invoke:kita ti panid\|main\|page=Estados Unidos iti Amerika}}`	artikulo
`{{#invoke:kita ti panid\|main\|page=Estados Unidos iti Amerika\|main=custom text}}`	custom text
`{{#invoke:kita ti panid\|main\|page=TimedText:Imagine.ogg.en.srt}}`	panid
`{{#invoke:kita ti panid\|main\|page=TimedText:Imagine.ogg.en.srt\|timedtext=custom text}}`	custom text

Talk parameter

Normally, the module will treat talk pages as if they were in the corresponding subject namespace. However, if the talk parameter is set, the module will treat talk pages separately from subject pages. The talk parameter sets values for all talk pages, i.e. pages in the Talk: namespace, pages in the User talk: namespace, pages in the Wikipedia talk: namespace, and so on.

{{#invoke:kita ti panid|main|talk=yes}}

{{#invoke:kita ti panid|main|talk=custom text}}

The default value for "talk=yes" is "talk page".

Examples

Code	Result
`{{#invoke:kita ti panid\|main\|page=Wikipedia tungtungan:Pungol}}`	panid
`{{#invoke:kita ti panid\|main\|page=Wikipedia tungtungan:Pungol\|wikipedia=yes}}`	panid ti proyekto
`{{#invoke:kita ti panid\|main\|page=Wikipedia tungtungan:Pungol\|talk=yes}}`	tungtungan a panid
`{{#invoke:kita ti panid\|main\|page=Wikipedia tungtungan:Pungol\|wikipedia=yes\|talk=yes}}`	tungtungan a panid
`{{#invoke:kita ti panid\|main\|page=Wikipedia tungtungan:Pungol\|talk=custom text}}`	custom text
`{{#invoke:kita ti panid\|main\|page=Wikipedia tungtungan:Pungol\|wikipedia=yes\|talk=custom text}}`	custom text

Main namespace classes

For pages in the main namespace, it is possible to add a class value in the first positional parameter:

{{#invoke:kita ti panid|main|class}}

If the class value matches one of the values in the table below, it will produce an alternative to the default output of article.

Class	Class values	Output
Disambiguation page	`disambiguation`, `disambig`, `disamb`, `dab`	`page`
No applicable class	`na`, `n/a`	`page`

You can input the class value in any combination of upper and lower case.

Custom main namespace classes

It is also possible to specify a custom value for the main namespace classes:

{{#invoke:kita ti panid|main|class|dab=yes|na=yes}}

{{#invoke:kita ti panid|main|class|dab=custom text|na=custom text}}

This works the same way that it does for the custom namespace page types. Possible parameters are:

dab: a custom value for disambiguation-class pages. If set to "yes", "y", "true" or "1", this produces "disambiguation page". If set to "no", "n", "false" or "0", no custom value is produced. If set to any other value it produces that text.
na: a custom value for NA-class pages. It works in the same way as the dab parameter. The default value for "yes" etc. is "page".

Examples

Code	Result
`{{#invoke:kita ti panid\|main\|page=Estados Unidos iti Amerika}}`	artikulo
`{{#invoke:kita ti panid\|main\|page=Estados Unidos iti Amerika\|dab}}`	panid
`{{#invoke:kita ti panid\|main\|page=Estados Unidos iti Amerika\|dab\|dab=custom text}}`	custom text
`{{#invoke:kita ti panid\|main\|page=Estados Unidos iti Amerika\|na}}`	panid
`{{#invoke:kita ti panid\|main\|page=Estados Unidos iti Amerika\|na\|na=custom text}}`	custom text

Redirects

By default, the module automatically detects redirects in all namespace. It is not possible to specify redirect behaviour by namespace, but you can turn redirect detection off, or use a custom value for redirect pages.

{{#invoke:kita ti panid|main|redirect=no}}

{{#invoke:kita ti panid|main|redirect=custom text}}

Examples

Code	Result
`{{#invoke:kita ti panid\|main\|page=USA}}`	baw-ing
`{{#invoke:kita ti panid\|main\|page=USA\|redirect=no}}`	artikulo
`{{#invoke:kita ti panid\|main\|page=USA\|redirect=custom text}}`	custom text

Other namespaces

By default, the module produces "page" if used from a namespace that hasn't been specified. This value can be changed with the |other= parameter:

{{#invoke:kita ti panid|main|other=custom text}}

Examples

Code	Result
`{{#invoke:kita ti panid\|main\|page=Wikipedia:Pungol}}`	panid
`{{#invoke:kita ti panid\|main\|page=Wikipedia:Pungol\|other=custom text}}`	custom text
`{{#invoke:kita ti panid\|main\|page=Wikipedia:Pungol\|other=custom text\|wikipedia=wikipedia-space text}}`	wikipedia-space text

Plurals

By default the module returns the name of the namespace in the singular. Adding the parameter |plural=y returns the plural form.

Code	Result
`{{#invoke:kita ti panid/pagipadasan\|main\|page=Filipinas}}`	artikulo
`{{#invoke:kita ti panid/pagipadasan\|main\|page=Filipinas\|plural=y}}`	dagiti artikulo
`{{#invoke:kita ti panid/pagipadasan\|main\|page=Kategoria:Liblibro}}`	kategoria
`{{#invoke:kita ti panid/pagipadasan\|main\|page=Kategoria:Liblibro\|plural=y}}`	dagiti kategoria

The rules for pluralisation can be customised in Modulo:Kita ti panid/pannakaaramid to allow localisation.

Capitalisation

By default the module returns the page type in lowercase. Adding the parameter |caps=y returns a version with a capital letter at the start.

Code	Result
`{{#invoke:kita ti panid/pagipadasan\|main\|page=Filipinas}}`	artikulo
`{{#invoke:kita ti panid/pagipadasan\|main\|page=Filipinas\|caps=y}}`	Artikulo
`{{#invoke:kita ti panid/pagipadasan\|main\|page=Filipinas\|plural=y\|caps=y}}`	Dagiti artikulo

--------------------------------------------------------------------------------
--                                                                            --
--                                Kita ti panid                               --
--                                                                            --
--      This is a meta-module intended to replace {{kita ti panid}} and similar    --
--      templates. It automatically detects namespaces, and allows for a      --
--      great deal of customisation. It can easily be ported to other         --
--      wikis by changing the values in the [[Modulo:Kita ti panid/pannakaaramid]].       --
--                                                                            --
--------------------------------------------------------------------------------

-- Load config.
local cfg = mw.loadData('Modulo:Kita ti panid/pannakaaramid')

-- Load required modules.
local getArgs = require('Modulo:Dagiti argumento').getArgs
local yesno = require('Modulo:Wensaan')
local nsDetectModule = require('Modulo:Panagduktal ti nagan ti espasio')
local nsDetect = nsDetectModule._main
local getParamMappings = nsDetectModule.getParamMappings
local getPageObject = nsDetectModule.getPageObject

local p = {}

local function shallowCopy(t)
	-- Makes a shallow copy of a table.
	local ret = {}
	for k, v in pairs(t) do
		ret[k] = v
	end
	return ret
end

local function checkPagetypeInput(namespace, val)
	-- Checks to see whether we need the default value for the given namespace,
	-- and if so gets it from the pagetypes table.
	-- The yesno function returns true/false for "yes", "no", etc., and returns
	-- val for other input.
	local ret = yesno(val, val)
	if ret and type(ret) ~= 'string' then
		ret = cfg.pagetypes[namespace]
	end
	return ret
end

local function getPagetypeFromClass(class, param, aliasTable, default)
	-- Gets the pagetype from a class specified from the first positional
	-- parameter.
	param = yesno(param, param)
	if param ~= false then -- No check if specifically disallowed.
		for _, alias in ipairs(aliasTable) do
			if class == alias then
				if type(param) == 'string' then
					return param
				else
					return default
				end
			end
		end
	end
end

local function getNsDetectValue(args)
	-- Builds the arguments to pass to [[Modulo:Panagduktal ti nagan ti espasio]] and returns
	-- the result.

	-- Get the default values.
	local ndArgs = {}
	local defaultns = args[cfg.defaultns]
	if defaultns == cfg.defaultnsAll then
		ndArgs = shallowCopy(cfg.pagetypes)
	else
		local defaultnsArray
		if defaultns == cfg.defaultnsExtended then
			defaultnsArray = cfg.extendedNamespaces
		elseif defaultns == cfg.defaultnsNone then
			defaultnsArray = {}
		else
			defaultnsArray = cfg.defaultNamespaces
		end
		for _, namespace in ipairs(defaultnsArray) do
			ndArgs[namespace] = cfg.pagetypes[namespace]
		end
	end

	--[[
	-- Add custom values passed in from the arguments. These overwrite the
	-- defaults. The possible argument names are fetched from
	-- Module:Namespace detect automatically in case new namespaces are
	-- added. Although we accept namespace aliases as parameters, we only pass
	-- the local namespace name as a parameter to Module:Namespace detect.
	-- This means that the "image" parameter can overwrite defaults for the
	-- File: namespace, which wouldn't work if we passed the parameters through
	-- separately.
	--]]
	local mappings = getParamMappings()
	for ns, paramAliases in pairs(mappings) do
		-- Copy the aliases table, as # doesn't work with tables returned from
		-- mw.loadData.
		paramAliases = shallowCopy(paramAliases)
		local paramName = paramAliases[1]
		-- Iterate backwards along the array so that any values for the local
		-- namespace names overwrite those for namespace aliases.
		for i = #paramAliases, 1, -1 do
			local paramAlias = paramAliases[i]
			local ndArg = checkPagetypeInput(paramAlias, args[paramAlias])
			if ndArg == false then
				-- If any arguments are false, convert them to nil to protect
				-- against breakage by future changes to
				-- [[Module:Namespace detect]].
				ndArgs[paramName] = nil
			elseif ndArg then
				ndArgs[paramName] = ndArg
			end
		end
	end
	-- Check for disambiguation-class and N/A-class pages in mainspace.
	if ndArgs.main then
		local class = args[1]
		if type(class) == 'string' then
			-- Put in lower case so e.g. "Dab" and "dab" will both match.
			class = mw.ustring.lower(class)
		end
		local dab = getPagetypeFromClass(
			class,
			args[cfg.dab],
			cfg.dabAliases,
			cfg.dabDefault
		)
		if dab then
			ndArgs.main = dab
		else
			local na = getPagetypeFromClass(
				class,
				args[cfg.na],
				cfg.naAliases,
				cfg.naDefault
			)
			if na then
				ndArgs.main = na
			end
		end
	end
	-- If there is no talk value specified, use the corresponding subject 
	-- namespace for talk pages.
	if not ndArgs.talk then
		ndArgs.subjectns = true
	end
	-- Add the fallback value. This can also be customised, but it cannot be
	-- disabled.
	local other = args[cfg.other]
	-- We will ignore true/false/nil results from yesno here, but using it
	-- anyway for consistency.
	other = yesno(other, other)
	if type(other) == 'string' then
		ndArgs.other = other
	else
		ndArgs.other = cfg.otherDefault
	end
	-- Allow custom page values.
	ndArgs.page = args.page
	return nsDetect(ndArgs)
end

local function detectRedirects(args)
	local redirect = args[cfg.redirect]
	-- The yesno function returns true/false for "yes", "no", etc., and returns
	-- redirect for other input.
	redirect = yesno(redirect, redirect)
	if redirect == false then
		-- Detect redirects unless they have been explicitly disallowed with
		-- "redirect=no" or similar.
		return
	end
	local pageObject = getPageObject(args.page)
	-- If we are using subject namespaces elsewhere, do so here as well.
	if pageObject
		and not yesno(args.talk, true)
		and args[cfg.defaultns] ~= cfg.defaultnsAll
	then
		pageObject = getPageObject(
			pageObject.subjectNsText .. ':' .. pageObject.text
		)
	end
	-- Allow custom values for redirects.
	if pageObject and pageObject.isRedirect then
		if type(redirect) == 'string' then
			return redirect
		else
			return cfg.redirectDefault
		end
	end
end

function p._main(args)
	local redirect = detectRedirects(args)
	local pagetype = ""
	if redirect then
		pagetype = redirect
	else
		pagetype = getNsDetectValue(args)
	end
	if yesno(args.plural, false) then
		if cfg.irregularPlurals[pagetype] then
			pagetype = cfg.irregularPlurals[pagetype]
		else
			pagetype = cfg.plural..' '..pagetype -- often preceded with the word 'dagiti' denoting a plural in Ilokano.
		end
	end
	if yesno(args.caps, false) then
		pagetype = mw.ustring.upper(mw.ustring.sub(pagetype, 1, 1)) ..
			mw.ustring.sub(pagetype, 2)
	end
	return pagetype
end

function p.main(frame)
	local args = getArgs(frame)
	return p._main(args)
end

return p