Add singularize template func

See #1438

diff --git a/docs/content/meta/release-notes.md b/docs/content/meta/release-notes.md
index 1670c98122b1bd034aef7bde1d2bcd09e4fd5eb3..f85e314a2ca49b6fbb7fc71d5bf4abfbe576d845 100644 (file)
--- a/docs/content/meta/release-notes.md
+++ b/docs/content/meta/release-notes.md
@@ -14,7 +14,7 @@ weight: 10
 * We now use a custom-built `LazyFileReader` for reading file contents, which means we don't read media files in `/content` into memory anymore -- and file reading is now performed in parallel on multicore PCs. [1181](https://github.com/spf13/hugo/issues/1181)
 * Hugo is now built with `Go 1.5` which, among many other improvements, have fixed the last known data race in Hugo. [917] (https://github.com/spf13/hugo/issues/917)
 * Lots of fixes and improvements in the template funcs:
-       * The new `pluralize` template func.  
+       * The new `pluralize` and `singularize` template funcs.  
        * The `sort` template func now accepts field/key chaining arguments and pointer values. [1330](https://github.com/spf13/hugo/issues/1330)
        * Several fixes for `slicestr` and `substr`, most importantly, they now have full `utf-8`-support. [1190](https://github.com/spf13/hugo/issues/1190) [1333](https://github.com/spf13/hugo/issues/1333) [1347](https://github.com/spf13/hugo/issues/1347) 
        *  The new `last` template function allows the user to select the last `N` items of a slice. [1148](https://github.com/spf13/hugo/issues/1148)

diff --git a/docs/content/templates/functions.md b/docs/content/templates/functions.md
index ac9622269c93cc0d7d76ba541beda7138fda371f..acb6988352f5bba4bc5ceff9e3d5579b8b28d7b4 100644 (file)
--- a/docs/content/templates/functions.md
+++ b/docs/content/templates/functions.md
@@ -433,6 +433,11 @@ Example: Given `style = "color: red;"` defined in the front matter of your `.md`
 Note: "ZgotmplZ" is a special value that indicates that unsafe content reached a
 CSS or URL context.
 
+### singularize
+Singularize the given word with a set of common English pluralization rules.
+
+e.g. `{{ "cats" | singularize }}` → "cat"
+
 ### slicestr
 
 Slicing in `slicestr` is done by specifying a half-open range with two indices, `start` and `end`.

diff --git a/tpl/template_funcs.go b/tpl/template_funcs.go
index fc9b80eed6962258a725201bdd531a649e39bb8f..fa9c9eda9fd969c77a09a14619a29cc89e65be48 100644 (file)
--- a/tpl/template_funcs.go
+++ b/tpl/template_funcs.go
@@ -1379,6 +1379,13 @@ func init() {
                        }
                        return inflect.Pluralize(word), nil
                },
+               "singularize": func(in interface{}) (string, error) {
+                       word, err := cast.ToStringE(in)
+                       if err != nil {
+                               return "", err
+                       }
+                       return inflect.Singularize(word), nil
+               },
        }
 
 }