You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
70 lines
1.9 KiB
70 lines
1.9 KiB
.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>
|
|
|