Permalink
Branch: master
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
74 lines (46 sloc) 1.33 KB
title type order
Name Parsing
guide
90

Wordsmith provides several helpful methods for working with names.

The parseName() function parses a string as a name and returns an array of name parts — e.g. first name, last name, etc.

Several shortcut filters are also available if you only need to extract one specific part.

Wordsmith's name parsing methods include:

Name parsing methods

firstName

An alias for givenName.

givenName

Parses a string as a name and returns the 'given name' component.

{{ 'Michael Rog' | givenName }}

# "Michael"

lastName

An alias for surname.

parseName

Parses a string as a name and returns a hash of its components:

{% parseName('Mr. Erich O. H. C. M. "The First Auteur" von Stroheim, II') %}

#  {
#    'nickname' : 'The First Auteur'
#    'salutation' : 'Mr.'
#    'givenName' : 'Erich'
#    'initials' : 'O. H. C. M.'
#    'surname' : 'Von Stroheim'
#    'surnameBase' : 'Stroheim'
#    'surnameCompound' : 'von'
#    'suffix' : 'II'
#  }

surname

Parses a string as a name and returns the 'family name' component.

{{ 'Michael Rog' | surname }}

# "Rog"