Hwɛ beaɛ a ɔnyaa Nhwɛsoɔ:Pluralize from text/doc

{{Documentation subpage}}
{{Lua|Module:Detect singular}}
== Usage ==
<code><nowiki>{{Pluralize from text|generic parameter|plural argument|singular output|plural output|wikilink (optional)}}</nowiki></code>

For use in infoboxes. Takes a generic parameter (e.g, {{para|nickname}}) and a plural argument (e.g., {{para|nicknames}}) and returns a singular output (e.g., "Nickname") if the plural argument is not given and [[Template:Detect singular]] determines that the value of {{para|nickname}} is singular by examining the text. Otherwise produces plural output (e.g., "Nicknames")

If the wikilink is provided, the returned value will use that as a link, and the output will be the link's display text.

===Options===
There are four named arguments that control the pluralization:
* {{para|no_comma}} By default, commas (or semi-colons) will cause the text string to be considered plural. Setting {{para|no_comma|1}} turns this behavior off.
* {{para|any_comma}} By default, commas (or semi-colons) that are adjacent to digits are singular. Setting {{para|any_comma|1}} turns this behavior off.
* {{para|no_and}} By default, "and" causes a string to be plural. Setting {{para|no_and|1}} turns this behavior off.
* {{para|parse_links}} By default, wikilinks are considered to be unparseable (singular) objects. Setting {{para|parse_links|1}} will allow the parser to read the contents of the wikilinks and determine whether that makes the string plural.

==Examples==
<code><nowiki>{{Pluralize from text|Chicagoan||singular|plural}}</nowiki></code> → {{Pluralize from text|Chicagoan||singular|plural}}

<code><nowiki>{{Pluralize from text|761 and 345||singular|plural}}</nowiki></code> → {{Pluralize from text|761 and 345||singular|plural}}

<code><nowiki>{{Pluralize from text||761/345|singular|plural}}</nowiki></code> → {{Pluralize from text||761/345|singular|plural}}

<code><nowiki>{{Pluralize from text|Chicagoan||Demonym|Demonyms|Demonym}}</nowiki></code> → {{Pluralize from text|Chicagoan||Demonym|Demonyms|Demonym}}

<code><nowiki>{{Pluralize from text|761 and 345||Area Code|Area Codes|Area code}}</nowiki></code> → {{Pluralize from text|761 and 345||Area Code|Area Codes|Area code}}

==TemplateData==
<templatedata>
{
	"params": {
		"1": {
			"label": "Generic parameter",
			"description": "Value of the wikitext parameter with unknown plurality",
			"type": "content",
			"required": true,
			"example": "{{{language|}}}"
		},
		"2": {
			"label": "Plural argument",
			"description": "value of the wikitext parameter known to be plural",
			"type": "string",
			"example": "{{{languages|}}}"
		},
		"3": {
			"label": "Singular output",
			"description": "Label for the parameter if the value is singular",
			"type": "string",
			"required": true,
			"example": "Language"
		},
		"4": {
			"label": "Plural output",
			"description": "Label for the parameter if the value is plural",
			"type": "string",
			"required": true,
			"example": "Languages"
		},
		"5": {
			"label": "Wikilink",
			"description": "Page to link to in the label",
			"type": "wiki-page-name",
			"example": "Language"
		}
	},
	"description": "Helper template to adjust infobox field labels based on whether value is plural or not",
	"paramOrder": [
		"1",
		"2",
		"3",
		"4",
		"5"
	]
}
</templatedata>

<includeonly>{{sandbox other||
<!-- Categories below this line -->

}}</includeonly>