You're viewing the readable version of this site. The interactive extras (search, diagrams, read-aloud) need JavaScript and a current browser. Enable JavaScript; if it is already enabled, update your browser.

Internal · Testbed

evergreen

Widget Specimens

Reusable content widgets and editorial layout machines for articles. For Pliara UI components, see the Pliarium laboratory.

·

testbed, widgets, design-system, internal

This page exercises the site's reusable content widgets: authored blocks that carry meaning beyond ordinary prose. Interactive Pliara UI components are explored and verified in the Pliarium component laboratory; this page tests the editorial blocks that make an article scannable.

Use this page as the first stop when changing widget CSS, filters, or authoring conventions. A widget should appear here before it becomes common in real articles.

Coverage

This page directly exercises the reusable article widgets. Heavier widgets whose output depends on page-level data, generated manifests, or special article modes are listed with their canonical specimens.

Widget family Canonical specimen Notes
Article openers This page epigraph, objectives, pullquote, keystone.
Callouts This page note, warning, important, eli5.
Marginalia This page Sidenotes, margin notes, arrow notes, sticky notes, margin figures.
Timelines This page, Josfi, Watchdog Plain dots and icon markers share the same primitive.
Scannable facts This page, Work, Watchdog factsheet, statband, dateline, generated metrics.
Layout helpers This page twocol, fullwidth, marginfigure, inline figures.
Language helpers This page, Kitchen sink lang-*, dir-rtl, and verse blocks.
Icons This page, Kitchen sink Phosphor icon font, link icons, timeline markers.
Diagrams and viz Diagrams Static Typst/SVG and interactive viz islands.
Research-paper mode Sample paper Authors, affiliation, abstract, definitions, theorems, lemmas, algorithms.
Gallery Photos Manifest-driven photo grid and lightbox.
CV contact strip CV Page-class-specific contact widget.
Evidence widgets Watchdog JSON-driven adopters, citations, sectors, and tables.
Blog index Blog Generated postlist and year-grouped timeline.
Hero Home Landing-page-only hero register.

Article Openers

Make the important thing visible, then make everything else quiet.

— Specimen text

The page should teach the eye where to land.

Widgets should carry structure, not decoration.

Callouts

Note

A note adds useful context without changing the argument. It should feel like a hand on the reader's shoulder, not an alarm.

Warning

A warning marks a real footgun: something a reader could plausibly get wrong and regret later.

Important

An important callout is for a load-bearing constraint. If the reader remembers only one thing from the section, it should be this.

Imagine the page as a guided walk. Prose is the path; widgets are signs at forks in the path.

Marginalia

This sentence carries a sidenote11 Sidenotes are the numbered marginal notes generated from ordinary Org footnotes. They must remain readable beside dense widgets. and an arrow note.

Arrow notes are for exact associations: a word, a phrase, or a specific line of reasoning.

Plain margin notes are quieter. They sit near the relevant paragraph but do not require an exact anchor.

Sticky notes are foreign objects. Use them rarely, when the note should feel placed on top of the page rather than set into it.

Timelines

  • Published — an icon marker via the curated ph-<name> class.
  • Ligature marker — the icon name as text content in a bare ph span. Any of Phosphor's ~1,500 glyphs work this way (the full font ships and liga is on), with no CSS to add — prefer this over extending the curated ph-<name> allowlist in _base.scss.
  • Plain marker — the old dot remains the fallback when no icon is authored.

Two ways to place a Phosphor icon: the curated ph-<name> class (a fixed allowlist in assets/scss/_base.scss, kept for the handful used in chrome), or ligature mode — a bare <span class"ph">icon-name</span>= with the icon's name as its text content. Ligature mode reaches the whole icon set without touching CSS, so reach for it in article bodies; keep aria-hidden on decorative markers.

Scannable Facts

Component
Widget specimen page
Purpose
Keep authored blocks visually testable.
Source
Org special blocks and small HTML islands
Status
Internal testbed, not a publication
  • 12 widget families
  • 3 callout strengths
  • 1 shared timeline primitive

The dateline is a small contextual label. On the CV it introduces a role; in articles it can label a dated entry without pretending to be a heading.

Layout Helpers

Before. Related details are scattered through prose. The reader has to keep the comparison in memory.

After. Parallel details sit side by side. The comparison becomes a shape, not a chore.

A code-tabs block (#+BEGIN_tabs / #+BEGIN_tab <Label>) shows the same example in several languages, one tab per language; the code is highlighted at build time. With JavaScript off it renders as a labeled stack of every panel — so it prints and curls whole; the tab strip is progressive enhancement. A tab's body is ordinary markup, so a twocol (or anything else) nests inside:

def greet(name):
    return f"hello, {name}"

The Python tab body. The code-tabs widget treats ordinary source blocks as tab content.

func greet(name string) string {
    return "hello, " + name
}

The Go tab body. The same greeting shape renders under a second tab.

fn greet(name: &str) -> String {
    format!("hello, {name}")
}

The Rust tab body. A third language checks longer tokens and punctuation.

A full-width figure can span the measure and the margin together.

A margin figure sits in the gutter and travels with the paragraph it explains.

This paragraph has a margin figure beside it. The body text should keep its measure, while the figure uses the gutter without colliding with sidenotes or ordinary marginalia.

0 1 2 b a a b a b
An inline figure lets prose wrap around a compact visual.

Inline figures are useful when the illustration is small enough that sending it to a full-width figure would interrupt the argument. The left and right variants should preserve a readable line length and clear themselves cleanly on narrow screens.

expr: term + - term: factor * / factor: number ( expr ) number: digit digit: 0 9
The right variant uses the same wrapper, mirrored.

The second paragraph exercises the right-floating variant. The text should wrap beside the figure and then return to the normal body measure after the figure's box is cleared.

Language Helpers

चतुरधिकं शतमष्टगुणं द्वाषष्टिस्तथा सहस्राणाम् ।
अयुतद्वयविष्कम्भस्यासन्नो वृत्तपरिणाहः ॥
الخط الهادئ يجعل الصفحة أيسر قراءة.

Icons

Colophon · Resume PDF · GitHub

  • link
  • copy
  • download
  • metric

Component islands

Server-rendered data-machine markup enhanced in place by the islands feature: clicks drive the behavior machine, and the root's contract attributes track settled state. The checkbox rests on its script-only mixed state (the dash must appear at load — that is the synchronous adoption prime at work); the tree derives its parent squares from leaf state, so no click sequence can strand them.

Specialized Widgets

Some widgets need their own full specimen pages because their state, data, or page register is large:

  • Diagrams exercises static Typst figures and interactive viz islands.
  • Sample paper exercises the paper register: authors, affiliation, abstract, numbered sections, definitions, theorems, lemmas, and algorithms.
  • Photos exercises the gallery and lightbox.
  • Watchdog exercises evidence tables, citation timelines, sector tiles, and metrics.