Problem: the hexagonal refactor churns the backend tree for nine more phases; the UI delivery stack (web/ SPA, cmd/desktop Wails wrapper, compose/web image) must move to its own repo first so doc/layout rewrites land once on a backend-only tree. Change: - New repo git.hubris.network/dtoro/oikos-web (v0.33.0): web/, desktop/ (updateURL repointed to oikos-web releases), compose/, own CI (web + desktop jobs), own deploy script (CI-green gate, TOCTOU guard, version-tagged images, prune-to-3), own webhook receiver on :9798 + launchd unit, own compose project publishing the same 8091:80. - Cutover executed on mac-mini in order: oikos stack's web service stopped+removed, oikos-web project brought up on 8091; outer Caddy untouched (targets the published port) — serving + Authentik flow + /wails 404 quirk verified post-cutover. - Stripped from oikos: web/, cmd/desktop/, compose/web/, desktop CI workflow, ci.yml web job, Makefile ui/desktop/desktop-package/install targets, the compose web service, oikos-web from deploy.sh's fallback prune list; wails + go-keyring dropped from go.mod, vendor synced. - README / CONTRIBUTING / AGENTS.md / .agents dev+operations docs now point at the new repo; mbse + mascot design docs carry a path note. Risk: production SPA serving depends on the new pipeline now; rollback is versioned-image re-up of the old web service from a pre-split checkout (port 8091). Desktop builds installed before the split still check dtoro/oikos releases — one manual reinstall, noted in the oikos-web release notes. Verification: go vet, make test (race), make generate-check, golangci (no new findings; baseline down 400→365); post-cutover curls — localhost:8091 200, /wails/runtime.js 404, outer Caddy 302 Authentik.
71 lines
1.9 KiB
Groff
71 lines
1.9 KiB
Groff
.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>
|