| Mode | Name | Size | |
|---|---|---|---|
| -rw-r--r-- | README.md | 2146 | logstatsplainblame |
| -rwxr-xr-x | build-site | 3515 | logstatsplainblame |
| -rw-r--r-- | card.png | 40025 | logstatsplainblame |
| d--------- | demo | 361 | logstatsplain |
| -rwxr-xr-x | gen-card | 3213 | logstatsplainblame |
| -rwxr-xr-x | gen-logo-mask | 2381 | logstatsplainblame |
| -rw-r--r-- | index.html | 17769 | logstatsplainblame |
| -rwxr-xr-x | publish | 1563 | logstatsplainblame |
| d--------- | recordings | 290 | logstatsplain |
| -rw-r--r-- | site.css | 25210 | logstatsplainblame |
web — the slosh website
Everything the website is made of lives here (plus the docs generator, which
make docs shares). One front page, the documentation, and the in-browser
demo, assembled into a single static site:
| path | what | comes from |
|---|---|---|
/ |
the front page: what it is, the demo video, install | index.html + site.css, hand-written, no build step |
/docs/ |
the documentation | contrib/gen-docs, the same pages make docs renders |
/demo/ |
the in-browser machine | demo/, on its own page so the front page stays light |
/recordings/ |
scripted feature playbacks the front page embeds | recordings/, native format + player — see recordings/PLAN.md |
Build
make www # the site -> build/www
NO_DEMO=1 web/build-site # ...without the demo (it cross-compiles a guest)
web/demo/serve --dir build/www
Deploying is make www-publish (or web/publish): it builds, sanity-checks
the output, and rsyncs it to /opt/slosh on the box — leaving /arch (the
pacman repository) and, on a NO_DEMO build, the served demo untouched.
The output is only static files. Any host that serves a directory works, with
the one condition the webdemo README already states: .wasm must be served as
application/wasm.
Decisions
- The page is drawn like a session. Tab strip as the nav, sections as
panes with the title set into the frame, a status line at the bottom. The
palette is
contrib/themes/sl0p.kdl. This is what keeps it from looking like every generated landing page: it looks like slosh, because it copies slosh rather than a template. - The demo lives on its own page. Loading it costs ~11 MiB and a machine boot; the front page costs two files and no JavaScript beyond the copy buttons.
- No framework, no fonts fetched, no tracker. Two files for the front page. The system monospace stack everywhere the terminal is being imitated.
TODO
- Every feature in the tour has its recording now; what remains on the
recordings side (a detach demo, storyline polish, static no-JS posters) is
in
recordings/PLAN.md.