Template:Pluralize from text/doc

From NARA
< Template:Pluralize from text
Revision as of 07:09, 20 April 2023 by Clarke (talk | contribs) (1 revision imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

[[Category:Template documentation pages{{#translation:}}]]

Usage

{{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

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

{{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

This is the TemplateData documentation for this template used by VisualEditor and other tools.

Pluralize from text

[[Category:TemplateData documentation{{#translation:}}]]

Helper template to adjust infobox field labels based on whether value is plural or not
Generic parameter1
Value of the wikitext parameter with unknown plurality
Example
{{{language|}}}
Plural argument2
value of the wikitext parameter known to be plural
Example
{{{languages|}}}
Singular output3
singular
Label for the parameter if the value is singular
Example
Language
Plural output4
plural
Label for the parameter if the value is plural
Example
Languages
Wikilink5
link
Page to link to in the label
Example
Language
Turn off comma processingno_comma
By default, commas and semicolons indicate plurals. Setting to yes turns this off.
Default
No