textr-cli

Command line interface for Textr

Usage no npm install needed!

<script type="module">
  import textrCli from 'https://cdn.skypack.dev/textr-cli';
</script>

README

textr-cli

NPM version Build Status Dependency Status

Command line interface for Textr

It can compose any functions that transforms text using Textr. For example, check out few: typographic-quotes, typographic-math-symbols, typographic-em-dashes and typographic-ellipses.

Install

Install textr globaly:

npm install -g textr-cli

Usage

After install, you can use textr command for processing your text files, like this:

# load from file, transformers required through few -t flags
$ textr foo.md -t typographic-quotes -t typographic-quotes

# load from file, transformers required through one -t
$ textr foo.md -t typographic-single-spaces,typographic-quotes

# load through stdin, iso-locale equals ru, transformers using --transforms
$ cat foo.md | textr -l ru --transforms=typographic-single-spaces

# load through stdin, write result into file
$ cat foo.md | textr -o bar.md

Options

You can use textr with specified options:

  • -t, --transforms — array of transformers, which will be applied (transformers should be installed globaly or localy in current project);
  • -o, --out-file — write output to file;
  • -l, --locale — ISO 639 locale codes (en-us as default);
  • -w, --watch — Watch changes in source file (works only with input as first argument and output through -o or --out-file flags);
  • -h, --help — show help message.

Real world

For example, you have a markdown article with some typographic mistakes, like a three pe­ri­ods instead of el­lip­sis character or whatever else. Thanks for textr-cli you can easily fix this. Just run textr with transformers which you need and get corrected text:

$ cat foo.md
Hello,   "world"...
Yet    "another" string
Yet...    one…

$ textr foo.md -t typographic-single-spaces,typographic-quotes,typographic-ellipses
Hello, “world”…
Yet “another” string
Yet… one…

Typography for everybody!

License

MIT © Denys Dovhan