← Docs · Stoa

Issues and diagrams

Two Stoa units present a site's own content: the Issues List turns an issue register into static tables at build time, and the Diagram Viewer opens a diagram in a dialog to zoom and pan. Both leave the content to the site and fail the build on data they cannot trust.

Issues List

The Issues List is build-only: a renderer and an Eleventy shortcode, with no script in the browser. It validates the register before writing anything, groups issues by status, counts each group and names the next issue due for a call. The site owns the statuses, the area vocabulary, the owners and the wording; columns such as Owner and For call appear only when some issue fills them.

A sample register grouped by status, with its summary and next call. Edit its inputs in the workbench

Strict validation rejects any field it does not recognise, with an error naming it. Each row can carry the Filter Bar's attributes, so a register can be filtered on the page.

Diagram Viewer

The Diagram Viewer writes a complete static figure, image or inline SVG, with its caption. With script, clicking the diagram or its Explore button opens it in a native dialog with zoom, pan, Fit and Reset; Escape closes it and returns focus. Without script the figure simply stays on the page.

A sample diagram; click it or Explore, then zoom and pan. Edit its inputs in the workbench