Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion content/en/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,9 @@ server renders pages and streams frames (plus a click hit-map) to a thin client.
**border-radius**, **box-shadow**, opacity; sibling combinators, `:checked`,
`:not()`.
- **Effects and layout**: `translate`/`rotate`, `filter`, `mask-image`, list
markers, multi-column layout, `vertical-align` on table cells.
markers (`list-style-type`, `::marker`, `inside`/`outside`), CSS counters
(`counter()`/`counters()` in `::before`/`::after`), multi-column layout,
`vertical-align` on table cells.
- **Text**: anti-aliased serif/sans/mono with **real bold and italic** faces.
- **Images**: PNG/JPEG, `data:`, and **SVG** (`<img>`, `data:` and inline `<svg>`).
- **JavaScript**: page scripts run via [goja](https://github.com/dop251/goja)
Expand Down
18 changes: 15 additions & 3 deletions content/en/fidelity.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,18 @@ rate-limited image thumbnails.
(relative/absolute/fixed/sticky), margin collapsing, greedy word-wrap, multi-column
layout.
- **Effects and lists**: `translate`/`rotate`, `filter`, `backdrop-filter`,
`mask-image` (a single `url()` mask), `ul`/`ol` list markers.
`mask-image` (a single `url()` mask). `ul`/`ol` list markers are generated in
layout as a `::marker` box, so every backend gets them as text (the raster
canvas, the vector PDF, go-pdfkit/html2pdf): `list-style-type` `disc`,
`circle`, `square`, `decimal`, `decimal-leading-zero`, `lower-`/`upper-alpha`,
`lower-`/`upper-roman`, a `<string>` and `none`; `list-style-position`
`outside`/`inside`; `::marker` colour, font and `content`; HTML `start`,
`reversed`, `value` and `type` (engine v0.18.0).
- **Generated content and counters**: `::before`/`::after` with strings,
`counter()` and `counters()`; `counter-reset` (with `reversed()`),
`counter-increment`, `counter-set`, scoped and inherited per CSS Lists 3, and
the implicit `list-item` counter. CSS escapes (`"\2022\00a0"`, `.\31 0`) are
decoded in every string, identifier and selector.
- **CSS**: cascade + specificity (inline > id > class > tag) + inheritance;
`var()` custom properties; `@media` width queries; **dark-mode**
(`prefers-color-scheme`); external `<link>` stylesheets; UA defaults.
Expand Down Expand Up @@ -72,8 +83,9 @@ rate-limited image thumbnails.
and `skew` are not supported. SVG has no `<filter>`/`<mask>`/`<pattern>`/
`<text>`/embedded `<image>`, and a per-page image budget caps very icon-heavy
pages.
- `::before`/`::after` generated content is not synthesised, so some icon-font and
`visually-hidden` chrome renders as text where a browser shows an icon.
- `::before`/`::after` take strings, `counter()` and `counters()`; `attr()`,
`url()` and the quote keywords are not supported, nor is `@counter-style` or
`list-style-image`. A form control's own `::before`/`::after` is not drawn.
- Rate-limited image hosts (Wikimedia) answer some requests with HTTP 429. The
engine retries them and the renders are identical, but each retry adds about two
seconds to that page.
Expand Down
5 changes: 3 additions & 2 deletions content/en/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,14 +31,15 @@ in the engine's
| **2.3 — Selector hack** | Sibling combinators `~`/`+`, **`:checked`**, **`:not()`** — the checkbox-hack that collapses MediaWiki dropdowns; "reduce, don't drop" for unmodelled selectors. |
| **2.4 — JS on hit-map** | The `RenderWithLinks` path shares the JS-settled pipeline, so JS-built links land in the click hit-map. |
| **2.5 — Effects and layout** | `translate`/`rotate`, `filter`, `backdrop-filter`, `mask-image`, list markers, multi-column layout, `vertical-align` on table cells, `appearance: none` checkboxes, `@container`, declarative shadow DOM. Released as v0.4.0. |
| **2.6 — Lists and counters** | List markers as text for every backend (`::marker`, `list-style-type` counter styles and strings, `inside`), CSS counters (`counter-reset`/`-increment`/`-set`, `counter()`/`counters()`), CSS escapes decoded everywhere. Released as v0.18.0. |
| **Remote browser** | [`browserproxy`](https://github.com/go-webengine/browserproxy): a WebSocket service that renders server-side with the engine, streams frames + hit-map, forwards clicks/scrolls/keys, and guards against SSRF. **Shipping.** |

Real bold + italic faces replaced the earlier faux-bold synthesis along the way.

## Remaining levers (honest, not promised) {#remaining-levers-honest-not-promised}

- **Fidelity residuals** — icon-font / `visually-hidden` chrome that renders as
text (generated `::before`/`::after` content); `conic-gradient` (recognised, not
- **Fidelity residuals** — the rest of the `content` grammar (`attr()`, `url()`,
quotes), `@counter-style`, `list-style-image`; `conic-gradient` (recognised, not
painted); `scale`/`skew`; SVG `<filter>`/`<mask>`/`<pattern>`/`<text>`/embedded
`<image>`.
- **Performance** — several pages (go.dev/blog, tailwindcss.com, pkg.go.dev) render
Expand Down
Loading