|
|
- .Dd August 9, 2013
- .Dt cssesc 1
- .Sh NAME
- .Nm cssesc
- .Nd escape text for use in CSS string literals or identifiers
- .Sh SYNOPSIS
- .Nm
- .Op Fl i | -identifier Ar string
- .br
- .Op Fl s | -single-quotes Ar string
- .br
- .Op Fl d | -double-quotes Ar string
- .br
- .Op Fl w | -wrap Ar string
- .br
- .Op Fl e | -escape-everything Ar string
- .br
- .Op Fl v | -version
- .br
- .Op Fl h | -help
- .Sh DESCRIPTION
- .Nm
- escapes strings for use in CSS string literals or identifiers while generating the shortest possible valid ASCII-only output.
- .Sh OPTIONS
- .Bl -ohang -offset
- .It Sy "-s, --single-quotes"
- Escape any occurences of ' in the input string as \\', so that the output can be used in a CSS string literal wrapped in single quotes.
- .It Sy "-d, --double-quotes"
- Escape any occurences of " in the input string as \\", so that the output can be used in a CSS string literal wrapped in double quotes.
- .It Sy "-w, --wrap"
- Make sure the output is a valid CSS string literal wrapped in quotes. The type of quotes can be specified using the
- .Ar -s | --single-quotes
- or
- .Ar -d | --double-quotes
- settings.
- .It Sy "-e, --escape-everything"
- Escape all the symbols in the output, even printable ASCII symbols.
- .It Sy "-v, --version"
- Print cssesc's version.
- .It Sy "-h, --help"
- Show the help screen.
- .El
- .Sh EXIT STATUS
- The
- .Nm cssesc
- utility exits with one of the following values:
- .Pp
- .Bl -tag -width flag -compact
- .It Li 0
- .Nm
- successfully escaped the given text and printed the result.
- .It Li 1
- .Nm
- wasn't instructed to escape anything (for example, the
- .Ar --help
- flag was set); or, an error occurred.
- .El
- .Sh EXAMPLES
- .Bl -ohang -offset
- .It Sy "cssesc 'foo bar baz'"
- Print an escaped version of the given text.
- .It Sy echo\ 'foo bar baz'\ |\ cssesc
- Print an escaped version of the text that gets piped in.
- .El
- .Sh BUGS
- cssesc's bug tracker is located at <https://github.com/mathiasbynens/cssesc/issues>.
- .Sh AUTHOR
- Mathias Bynens <https://mathiasbynens.be/>
- .Sh WWW
- <https://mths.be/cssesc>
|