titlecase 0.10.0

A tool that capitalizes text according to a style defined by John Gruber for post titles on his website Daring Fireball.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

# Title Case (titlecase)

`titlecase` is a small tool that capitlizes English text [according to a
style][style] defined by John Gruber for post titles on his website [Daring
Fireball].  `titlecase` runs on Linux, macOS, FreeBSD, NetBSD, and Windows. A
dependency free, single-file binary is built for each supported platform for
[every release][releases].

[![Travis CI](https://travis-ci.org/wezm/titlecase.svg?branch=master)](https://travis-ci.org/wezm/titlecase)
[![Appveyor](https://ci.appveyor.com/api/projects/status/github/wezm/titlecase?svg=true)](https://ci.appveyor.com/project/wezm/titlecase)
[![crates.io](https://img.shields.io/crates/v/titlecase.svg)](https://crates.io/crates/titlecase)
[![Documentation](https://docs.rs/titlecase/badge.svg)][crate-docs]

`titlecase` is licensed under the [MIT license][MIT].

## Examples

```
% echo 'Being productive on linux' | titlecase
Being Productive on Linux

% echo 'Finding an alternative to Mac OS X — part 2' | titlecase
Finding an Alternative to Mac OS X — Part 2

% echo 'an example with small words and sub-phrases: "the example"' | titlecase
An Example With Small Words and Sub-Phrases: "The Example"

```

## Command Line Usage

`titlecase` reads lines of text from **stdin** and prints title cased versions
to **stdout**.

## Usage as a Rust Crate

See the [crate documentation][crate-docs].

## Installation

[Pre-built `titlecase` binaries][releases] are available for Linux, macOS,
FreeBSD, NetBSD, and Windows.

### Rust Developer/Cargo

If you have a stable Rust compiler toolchain installed you can install
`titlecase` with cargo:

```
% cargo install titlecase
```

## Style

Instead of simply capitalizing each word `titlecase` does the following
([amongst other things][style]):

* Lower case small words like an, of, or in.
* Don't capitalize words like iPhone.
* Don't interfere with file paths, URLs, domains, and email addresses.
* Always capitalize the first and last words, even if they are small words
  or surrounded by quotes.
* Don't interfere with terms like "Q&A", or "AT&T".
* Capitalize small words after a colon.

## Credits

This tool makes use of prior work by [John Gruber][style], [Aristotle
Pagaltzis], and [David Gouch]. The continuous integration configuration uses
[trust] by Jorge Aparicio, dual licensed under [the MIT][trust-mit] and
[Apache][trust-apache] licenses.

[Daring Fireball]: https://daringfireball.net/
[style]: https://daringfireball.net/2008/05/title_case
[Aristotle Pagaltzis]: http://plasmasturm.org/code/titlecase/
[David Gouch]: http://individed.com/code/to-title-case/
[releases]: https://github.com/wezm/titlecase/releases
[MIT]: https://github.com/wezm/titlecase/blob/master/LICENSE
[trust]: https://github.com/japaric/trust
[trust-mit]: https://github.com/japaric/trust/blob/master/LICENSE-MIT
[trust-apache]: https://github.com/japaric/trust/blob/master/LICENSE-APACHE
[crate-docs]: https://docs.rs/crate/titlecase