Skip to content

Manual theme

The public pages of the dustinedwards.info sites, set after the 1975 NASA Graphics Standards Manual.

<div class="cap-running-head" id="m-running"><span class="cap-running-head-name"><span class="cap-running-head-no">4</span>Tools</span><span class="cap-running-head-folio">22 tools</span></div>

Installation

// package.json: "capsomer": "github:DrDustinEdwards/capsomer#v0.152.2"
import "capsomer/tokens.css";
import "capsomer/base.css";
import "capsomer/manual.css";
import { patchDots, patchSvg, checklistHtml } from "capsomer/behavior/manual";

Usage

<div class="cap-running-head"><span class="cap-running-head-name"><span class="cap-running-head-no">1</span>Programs</span><span class="cap-running-head-folio">Alex Rivera</span></div>

<section class="cap-part">
  <h2 class="cap-part-title"><span class="cap-part-no">1.3</span>Guides</h2>
  <p class="cap-part-lead">The team's field methods, each on its own page.</p>
  <section class="cap-checklist" aria-label="Field guides">
    <p class="cap-checklist-strip" aria-hidden="true"><span>Field · Guides</span><span>6 cards</span></p>
    <ol class="cap-checklist-items">
      <li class="cap-checklist-item">
        <div class="cap-checklist-line"><a href="/guides/site-survey">Site survey</a><span class="cap-checklist-dots" aria-hidden="true"></span><span class="cap-checklist-kind">Guide</span></div>
        <p class="cap-checklist-note">Choosing sites, walking transects and logging each sample.</p>
      </li>
    </ol>
  </section>
</section>

<dl class="cap-form-boxes">
  <div class="cap-form-boxes-box"><dt>First published</dt><dd>2026-10-04</dd></div>
  <div class="cap-form-boxes-box" data-span="all"><dt>Written for</dt><dd>Writers and developers.</dd></div>
</dl>

<nav class="cap-signs" aria-label="More"><a class="cap-sign" rel="prev" href="/about">About</a><a class="cap-sign" rel="next" href="/contact">Contact</a></nav>

<footer><div class="cap-letterhead"><p class="cap-letterhead-logo">Alex<br>Rivera</p><p class="cap-letterhead-address"><b>Research Office</b><br>Example Co</p><span class="cap-letterhead-folio">1</span></div></footer>
import { patchSvg } from "capsomer/behavior/manual";
patchSvg({ id: "desk", name: "The desk", foot: "example.com", count: 6, unit: "sites" });

Examples

Running head as a sign

<div class="cap-running-head" data-variant="sign" id="m-sign-head"><span class="cap-running-head-name"><span class="cap-running-head-no">2</span>Flows</span><span class="cap-running-head-folio">9 flows</span></div>

A numbered part with its lead

<section class="cap-part" id="m-part">
  <h3 class="cap-part-title"><span class="cap-part-no">1.2</span>Sites on the network</h3>
  <p class="cap-part-lead">Six sites publish through one desk. Each keeps its own posts and checks.</p>
  <p>The desk saves an AI draft beside the writer's own and never on top of it.</p>
</section>

Form boxes: a title block

<dl class="cap-form-boxes" id="m-title-block">
  <div class="cap-form-boxes-box" data-span="2"><dt>Title</dt><dd>Publish a post from the desk</dd></div>
  <div class="cap-form-boxes-box"><dt>Updated</dt><dd>2026-10-25</dd></div>
  <div class="cap-form-boxes-box" data-weight="bold"><dt>Page</dt><dd>3 of 9</dd></div>
  <div class="cap-form-boxes-box" data-span="all"><dt>Written for</dt><dd>Writers deciding how much an AI assistant may touch.</dd></div>
</dl>

Form boxes: readings on a tone scale

<dl class="cap-form-boxes" data-variant="tones" id="m-tones">
  <div class="cap-form-boxes-box"><dt>Claims checked</dt><dd>1,890</dd></div>
  <div class="cap-form-boxes-box"><dt>Matched GitHub</dt><dd>98%</dd></div>
  <div class="cap-form-boxes-box"><dt>Tools</dt><dd>22</dd></div>
  <div class="cap-form-boxes-box"><dt>Sites</dt><dd>10</dd></div>
</dl>

Form boxes: an instrument panel

<dl class="cap-form-boxes" data-variant="panel" id="m-panel">
  <div class="cap-form-boxes-box"><dt>Papers</dt><dd>36</dd></div>
  <div class="cap-form-boxes-box"><dt>Student researchers</dt><dd>157</dd></div>
  <div class="cap-form-boxes-box"><dt>Cohorts</dt><dd>9</dd></div>
  <div class="cap-form-boxes-box"><dt>Posts</dt><dd>14</dd></div>
</dl>

Leader index

<ol class="cap-leader-index" id="m-index">
  <li><a class="cap-leader-index-link" href="#areas"><span class="cap-leader-index-no">1.1</span><span class="cap-leader-index-name">Program areas</span><span class="cap-leader-index-dots" aria-hidden="true"></span><span class="cap-leader-index-fact">3</span></a></li>
  <li><a class="cap-leader-index-link" href="#projects"><span class="cap-leader-index-no">1.2</span><span class="cap-leader-index-name">Projects</span><span class="cap-leader-index-dots" aria-hidden="true"></span><span class="cap-leader-index-fact">75</span></a></li>
  <li><a class="cap-leader-index-link" href="#guides" aria-current="true"><span class="cap-leader-index-no">1.3</span><span class="cap-leader-index-name">Guides</span><span class="cap-leader-index-dots" aria-hidden="true"></span><span class="cap-leader-index-fact">6</span></a></li>
</ol>

Checklist card

<section class="cap-checklist" aria-label="Field guides" id="m-checklist">
  <p class="cap-checklist-strip" aria-hidden="true"><span>Field · Guides</span><span>3 cards</span></p>
  <ol class="cap-checklist-items">
    <li class="cap-checklist-item"><div class="cap-checklist-line"><a href="#site-survey">Site survey and sampling plan</a><span class="cap-checklist-dots" aria-hidden="true"></span><span class="cap-checklist-kind">Guide</span></div><p class="cap-checklist-note">Choosing sites, walking transects and logging each sample with its place and time.</p></li>
    <li class="cap-checklist-item"><div class="cap-checklist-line"><a href="#calculators">Field calculators</a><span class="cap-checklist-dots" aria-hidden="true"></span><span class="cap-checklist-kind">Calculators</span></div><p class="cap-checklist-note">Areas, sample sizes and travel times between sites, with the arithmetic shown.</p></li>
    <li class="cap-checklist-item"><div class="cap-checklist-line"><a href="#forms">Field forms</a><span class="cap-checklist-dots" aria-hidden="true"></span><span class="cap-checklist-kind">Forms</span></div><p class="cap-checklist-note">Printable record sheets and the order to fill them in.</p></li>
  </ol>
</section>

Plate

<figure class="cap-plate" id="m-plate">
  <div class="cap-plate-box"><span class="cap-plate-no">Plate I</span><svg viewBox="0 0 400 200" role="img" aria-label="Three rings inside a circle"><circle cx="200" cy="105" r="80" fill="none" stroke="currentColor" stroke-width="1.5"/><circle cx="175" cy="80" r="12" fill="none" stroke="currentColor"/><circle cx="230" cy="110" r="8" fill="none" stroke="currentColor"/><circle cx="190" cy="140" r="4" fill="none" stroke="currentColor"/><path d="M330 182h40" stroke="currentColor" stroke-width="2"/></svg></div>
  <figcaption class="cap-plate-caption"><span><b>Plate I.</b> Ring sizes, drawn.</span><span class="cap-plate-fig">Fig. 1</span></figcaption>
</figure>

Signs: the ways on

<nav class="cap-signs" aria-label="More" id="m-signs"><a class="cap-sign" rel="prev" href="#about">About</a><a class="cap-sign" rel="next" href="#contact">Contact</a></nav>

Mission patch

<div class="cap-specimen-row" id="m-patch"><svg class="cap-patch" viewBox="0 0 140 140" aria-hidden="true" focusable="false"><defs><path id="cap-patch-desk-top" d="M 22 70 A 48 48 0 0 1 118 70"/><path id="cap-patch-desk-foot" d="M 27 74 A 43 43 0 0 0 113 74"/></defs><circle class="cap-patch-rim" cx="70" cy="70" r="68"/><circle class="cap-patch-field" cx="70" cy="70" r="61"/><circle class="cap-patch-disc" cx="70" cy="70" r="36"/><circle class="cap-patch-dot" cx="70.00" cy="34.00" r="3.4"/><circle class="cap-patch-dot" cx="101.18" cy="52.00" r="3.4"/><circle class="cap-patch-dot" cx="101.18" cy="88.00" r="3.4"/><circle class="cap-patch-dot" cx="70.00" cy="106.00" r="3.4"/><circle class="cap-patch-dot" cx="38.82" cy="88.00" r="3.4"/><circle class="cap-patch-dot" cx="38.82" cy="52.00" r="3.4"/><text class="cap-patch-name" text-anchor="middle"><textPath href="#cap-patch-desk-top" startOffset="50%">THE DESK</textPath></text><text class="cap-patch-foot" text-anchor="middle"><textPath href="#cap-patch-desk-foot" startOffset="50%">EXAMPLE.COM</textPath></text><text class="cap-patch-count" x="70" y="77" text-anchor="middle">6</text><text class="cap-patch-unit" x="70" y="89" text-anchor="middle">SITES</text></svg><p>Carrel publishes for six sites.</p></div>

Letterhead

<div class="cap-letterhead" id="m-letterhead"><p class="cap-letterhead-logo">Alex<br>Rivera</p><p class="cap-letterhead-address"><b>Research Office</b><br>Example Co<br>Springfield, Oregon</p><span class="cap-letterhead-folio">1</span></div>

Layout grid behind a page's head

<div class="cap-layout-grid" id="m-grid" data-labeled><p class="cap-part-lead">Tools</p><p>Twenty-two tools, each with its rules and the claims it has checked.</p></div>

Direction strip

<nav class="cap-direction" aria-label="Breadcrumb" id="m-direction"><ol><li><a href="#home">Home</a></li><li><a href="#software">Software</a></li><li><a href="#capsid" aria-current="page">Capsid</a></li></ol></nav>

Cheatline and a card's stripe

<article class="cap-plate-box" data-livery id="m-livery-card"><p>A card with a length of the band along its top.</p></article>
<div class="cap-livery" id="m-livery"></div>

Roll blocks

<div class="cap-specimen-row" id="m-roll"><ol class="cap-roll" aria-hidden="true"><li data-state="done"></li><li data-state="done"></li><li data-state="now"></li><li data-state="ahead"></li><li data-state="ahead"></li></ol><p>Step 3 of 5</p></div>

Time line

<ol class="cap-timeline" id="m-timeline">
  <li><span class="cap-timeline-mark">2019</span><div class="cap-timeline-body"><p><b>Senior editor</b>, Example Co</p></div></li>
  <li><span class="cap-timeline-mark">2014</span><div class="cap-timeline-body"><p><b>Editor</b>, Example Co</p></div></li>
  <li><span class="cap-timeline-mark">2011</span><div class="cap-timeline-body"><p><b>Staff writer</b>, Example University</p></div></li>
</ol>

Cue card

<section class="cap-cue" aria-labelledby="m-cue-title" id="m-cue">
  <p class="cap-cue-strip" aria-hidden="true"><span>Site survey</span><span>Card 3 of 5</span></p>
  <ol class="cap-roll" aria-hidden="true"><li data-state="done"></li><li data-state="done"></li><li data-state="now"></li><li data-state="ahead"></li><li data-state="ahead"></li></ol>
  <h3 class="cap-cue-title" id="m-cue-title">Sample log</h3>
  <ul class="cap-cue-lines">
    <li><a class="cap-cue-name" href="#bag-labels">Bag labels</a><span class="cap-cue-value">2 per sample</span></li>
    <li><span class="cap-cue-name">Sample volume</span><span class="cap-cue-value">250 mL</span></li>
    <li><span class="cap-cue-name">Store</span><span class="cap-cue-value">24 h, 4 °C</span></li>
  </ul>
</section>

Holding position marking

<p>The last paragraph of a post.</p>
<hr class="cap-hold" id="m-hold">
<p>What other sites said about it.</p>

Annunciator panel

<ul class="cap-annunciator" aria-label="Health checks" id="m-annunciator">
  <li data-state="normal">Database<span class="cap-annunciator-state">Pass</span></li>
  <li data-state="caution">Backup<span class="cap-annunciator-state">Caution</span></li>
  <li data-state="warning">Search index<span class="cap-annunciator-state">Warning</span></li>
  <li data-state="normal">Media<span class="cap-annunciator-state">Pass</span></li>
  <li data-state="off">Mentions<span class="cap-annunciator-state">Off</span></li>
  <li data-state="normal">Feeds<span class="cap-annunciator-state">Pass</span></li>
</ul>

API reference

Patch

PropTypeRequiredDoes
idstringYesA unique id on the page, for the patch's text paths.
namestringYesSet round the top, in capitals.
footstringYesSet round the foot, in capitals: the site or the series.
countnumberYesThe number on the disc, and the number of dots round it (at most 24).
unitstringYesThe word under the number, in capitals.

RunningHead

PropTypeRequiredDoes
nostringYesThe section's number (the site's own, for the section Prelum's sectionOf picks).
trailreadonly string[]YesThe section's trail, joined with a middle dot.
foliostringYesThe right side: the deepest route's folio (manual.ts folioOf), else the site's name.

Signs

PropTypeRequiredDoes
labelstringYesThe nav's name ("Parts of Field notes", "More in Guides").
prevWaysThe ways back (left arrow) and the ways on (right arrow and the family color on top).
nextWays
classNamestring
renderLink(props: SignLinkProps) => ReactNodeDraws each link. Default React Router's Link, with Capsomer's prefetch.

Functions

FunctionSignatureDoes
patchDots(count: number): [string, string][]The dots round a patch's disc, one per count (at most 24), as [cx, cy] strings: the SVG and the React patch share them.
patchSvg({ id, name, foot, count, unit }: PatchOptions): stringA project's round patch as SVG markup, as each Apollo crew wore its mission's (capsomer/manual.css draws it). Plain string building, so a server or a static build can write it into the page. The patch is decorative: the page says the same in words beside it, so it is hidden from screen readers.
checklistHtml(options: { label: string; strip: readonly [string, string]; items: readonly ChecklistItem[]; }): stringA checklist card: a dark strip naming it (strip, two parts), then each item as a step.
timelineHtml(steps: readonly TimelineStep[]): stringA time line of dated steps.
formBoxesHtml(boxes: readonly FormBox[], { variant }?: { variant?: "grid" | "readings" | "tones" | "panel" | undefined; }): stringForm boxes: facts in ruled boxes. variant is readings, tones, panel or grid.
leaderIndexHtml(rows: readonly LeaderRow[]): stringA leader index: number, bold name, a dotted leader and a fact at the right; a row with an href is a link.
cueCardHtml(options: { id: string; strip: readonly [string, string]; title: string; lines: readonly { name: string; value: string; }[]; className?: string | undefined; note?: string | undefined; }): stringA cue card: the strip (two parts), a title with its id (the section's aria-labelledby), and its lines.
signsHtml(label: string, signs: readonly Sign[]): stringSigns: the ways on as dark panels. label names the nav.
folioOf(matches: readonly { handle?: unknown; loaderData?: unknown; data?: unknown; }[]): string | undefinedThe deepest route's folio, from the router's matches (React Router's useMatches), or undefined.

CSS variables

VariableDefault
--box-min10rem
--cap-letterhead-logo-leading0.82
--cap-letterhead-logo-sizeclamp(2.5rem, 6vw, 4.5rem)
--cap-letterhead-logo-tracking-0.045em
--cap-patch-foot-size0.5625rem
--cap-patch-foot-tracking2px
--cap-patch-tracking1.4px
--cap-patch-unit-size7px
--cap-patch-unit-tracking1px
--cols4
--grid-fillcolor-mix(in oklab, var(--crit) 4%, transparent)
--grid-linecolor-mix(in oklab, var(--crit) 45%, transparent)
--grid-softcolor-mix(in oklab, var(--crit) 14%, transparent)

Parts and data attributes

ClassIs
.cap-annunciatorits own class
.cap-annunciator-stateits own class
.cap-checklistits own class
.cap-checklist-dotsits own class
.cap-checklist-itemits own class
.cap-checklist-itemsits own class
.cap-checklist-kindits own class
.cap-checklist-lineits own class
.cap-checklist-noteits own class
.cap-checklist-stripits own class
.cap-cue-linesits own class
.cap-cue-nameits own class
.cap-cue-stripits own class
.cap-cue-titleits own class
.cap-cue-valueits own class
.cap-directionits own class
.cap-form-boxesits own class
.cap-form-boxes-boxits own class
.cap-holdits own class
.cap-layout-gridits own class
.cap-leader-indexits own class
.cap-leader-index-dotsits own class
.cap-leader-index-factits own class
.cap-leader-index-linkits own class
.cap-leader-index-nameits own class
.cap-leader-index-noits own class
.cap-letterheadits own class
.cap-letterhead-addressits own class
.cap-letterhead-folioits own class
.cap-letterhead-logoits own class
.cap-partits own class
.cap-part-leadits own class
.cap-part-noits own class
.cap-part-titleits own class
.cap-patch-countits own class
.cap-patch-discits own class
.cap-patch-dotits own class
.cap-patch-fieldits own class
.cap-patch-footits own class
.cap-patch-nameits own class
.cap-patch-rimits own class
.cap-patch-unitits own class
.cap-patchedits own class
.cap-plateits own class
.cap-plate-boxits own class
.cap-plate-captionits own class
.cap-plate-figits own class
.cap-plate-noits own class
.cap-rollits own class
.cap-running-headthe root
.cap-running-head-folioa part
.cap-running-head-namea part
.cap-running-head-noa part
.cap-running-head-tracksa part
.cap-running-head-traila part
.cap-signits own class
.cap-signsits own class
AttributeValues
data-labeledpresent or absent
data-liverypresent or absent
data-sizes
data-span2 all
data-stateahead caution done now off warning
data-variantforward grid panel readings sign tones
data-weightbold
StateRead from
:focus-visiblethe platform
:hoverthe platform
[aria-current]an attribute

Accessibility

KeyDoes
TabMoves through the links in the index, the checklist and the signs, in reading order. Nothing else takes focus.
  • Every label and value is text in --text or --muted on the ground; the sign panels and strips set --ground on --text, so both themes keep the page's own contrast.
  • The checklist's box, the leaders and the patch are drawn and hidden from screen readers. The patch says nothing the page does not say beside it.
  • The arrows on the signs are generated content with an empty alternative, so a sign is read as its words. In forced colors they are drawn in LinkText.
  • In forced colors the sign panels, the running-head sign and the direction strip keep a border, as their dark fill is dropped, and the layout grid is not drawn.
  • The annunciator's tiles set --on-sign on the sign panel, mixed with the status color when lit; the state is a word on every tile, so the color is never alone. The holding marking is drawn; on an hr it is a separator, elsewhere it is hidden.
  • The direction strip's page you are on sets --on-sign-here on --sign-here, checked at 7:1 (AAA) by palette.mjs. The roll blocks, the livery and the layout grid are drawn and say nothing the page does not say in words.