NAME
Lingua::EN::Titlecase::Simple - John Gruber's headline capitalization script
SYNOPSIS
use Lingua::EN::Titlecase::Simple 'titlecase';
print titlecase 'Small word at end is nothing to be afraid of';
# output: Small Word at End Is Nothing to Be Afraid Of
print titlecase 'IF IT’S ALL CAPS, FIX IT';
# output: If It’s All Caps, Fix It
DESCRIPTION
This module capitalizes English text suitably for use as a headline, based on traditional editorial rules from The New York Times Manual of Style.
INTERFACE
There are no default exports.
titlecase
Takes one or more strings as arguments, each representing one headline to capitalize.
When given a single string, returns a scalar. When given several strings, returns a list in list context, but an arrayref in scalar context. When given nothing, returns nothing in list context or undef in scalar context.
This function can be exported on request.
Note that the arrayref return is problematic because it depends on the number of arguments. If you have a variable number of arguments to pass, and that number can sometimes be less than 2, you will sometimes get a plain scalar or an undefined value instead of the arrayref you expected. Passing multiple strings in scalar context is therefore discouraged.
@SMALL_WORD
Contains the list of words to avoid capitalizing.
SEE ALSO
Lingua::EN::Titlecase provides a much more heavyweight, modular solution for the same problem. If you seriously disagree with the style rules in this module somewhere, you may be happier with that one.
AUTHOR
John Gruber <http://daringfireball.net/2008/05/title_case>
Aristotle Pagaltzis <pagaltzis@gmx.de>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2018 by John Gruber, Aristotle Pagaltzis.
This is free software, licensed under:
The MIT (X11) License