Template:Pluralize from text

Template documentation[view] [edit] [history] [purge]

This template is used on approximately 1,570,000 pages, or roughly 105017% of all pages.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

This template uses Lua:

Module:Detect singular

Usage edit

{{Pluralize from text|generic parameter|singular=singular output|likely=likely plural output|plural=plural output|link=wikilink}}
{{Pluralize from text|generic parameter|plural argument|singular output|plural output|wikilink}}

For use in infoboxes. Takes a generic parameter (e.g, |nickname=) and a plural argument (e.g., |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 |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.

The template makes a decision whether a string is a "likely plural" or a full "plural". The |likely= argument will be the output if the template determines that the string is only "likely plural". If |likely= is not given, "likely plural" and "plural" are treated identically.

The output of the template can be forced by including {{force singular}} or {{force plural}} in the generic parameter.

Options edit

There are four named arguments that control the pluralization:

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

Examples edit

{{Pluralize from text|Chicagoan|singular=singular|plural=plural}} → singular

{{Pluralize from text|761 and 345|singular=singular|plural=plural}} → plural

{{Pluralize from text||761/345|singular=singular|plural=plural}} → plural

{{Pluralize from text|Chicagoan|singular=Demonym|plural=Demonyms|link=Demonym}} → Demonym

{{Pluralize from text|761 and 345|singular=Area Code|plural=Area Codes|link=Area code}} → Area Codes

TemplateData edit

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Pluralize from text in articles based on its TemplateData.

TemplateData for Pluralize from text

Helper template to adjust infobox field labels based on whether value is plural or not

⧼templatedata-doc-param-name⧽		⧼templatedata-doc-param-desc⧽	⧼templatedata-doc-param-type⧽	⧼templatedata-doc-param-status⧽
Generic parameter	`1`	Value of the wikitext parameter with unknown plurality ⧼templatedata-doc-param-example⧽ {{{language\|}}}	⧼templatedata-doc-param-type-content⧽	⧼templatedata-doc-param-status-required⧽
Plural argument	`2`	value of the wikitext parameter known to be plural ⧼templatedata-doc-param-example⧽ {{{languages\|}}}	⧼templatedata-doc-param-type-string⧽	⧼templatedata-doc-param-status-optional⧽
Singular output	`3` singular	Label for the parameter if the value is singular ⧼templatedata-doc-param-example⧽ Language	⧼templatedata-doc-param-type-string⧽	⧼templatedata-doc-param-status-optional⧽
Plural output	`4` plural	Label for the parameter if the value is plural ⧼templatedata-doc-param-example⧽ Languages	⧼templatedata-doc-param-type-string⧽	⧼templatedata-doc-param-status-optional⧽
Wikilink	`5` link	Page to link to in the label ⧼templatedata-doc-param-example⧽ Language	⧼templatedata-doc-param-type-wiki-page-name⧽	⧼templatedata-doc-param-status-optional⧽
Turn off comma processing	`no_comma`	By default, commas and semicolons indicate plurals. Setting to yes turns this off. ⧼templatedata-doc-param-default⧽ No	⧼templatedata-doc-param-type-string⧽	⧼templatedata-doc-param-status-optional⧽

The above documentation is transcluded from Template:Pluralize from text/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.