pluralize

A Liquid filter to make it easy to form correct plurals.

At some point, every programmer has had to display a count of objects, like “36 pages” or “1 message”. This Liquid filter makes it easier to form these plurals correctly—no more taking the lazy way out and writing {{ number }} message(s)! (Or worse, assuming that the number will be greater than one.)

Installation

If you’re using Jekyll, see the Jekyll documentation on installing plugins for installation instructions.

If you’re using Liquid without Jekyll, install the liquid_pluralize Gem and then… I’m not sure.

Usage

The sole provided function is pluralize. It can be used in one of two ways:

• for regular plurals (where the plural is formed by appending an s):

    {{ remaining_time | pluralize: "minute" }}
  

  will output “0 minutes”, “1 minute”, “17 minutes”, etc.

• for irregular plurals:

    {{ cul_de_sac_list.length | pluralize: "cul-de-sac", "culs-de-sac" }}
  

  will output “0 culs-de-sac”, “1 cul-de-sac”, “17 culs-de-sac”, etc.

Version history

The version numbers of this project conform to Semantic Versioning 2.0.

• 1.0.1 (2015-03-04): Correctly handle the number 1 when it is given in string form. Don’t refer to Jekyll in the code itself.
• 1.0.0 (2013-08-20): Initial release.

Author

Pluralize was created by Benjamin Esham.

This project is hosted on GitHub. Please feel free to submit issues and pull requests.

License

This script is hereby released into the public domain. To the extent possible, the author places no restrictions upon its use, modification, or redistribution.