On this page
  1. The idea
  2. Grid
  3. Type
  4. Color
  5. Palette
  6. Rules
  7. Status
  8. Details from the history of the terminal
  9. The paper tape
  10. The cursor
  11. Access

This page defines how the site looks: its grid, its type, its colors, and the details it takes from the history of the terminal. The stylesheet site/assets/css/site.css implements it. Where the two disagree, this page governs.

The idea

The whole is plain and the detail is local. Three decisions carry the design.

  • One grid. The page is a screen, measured in characters. Its widths are the widths of the terminals that came before it.
  • Two voices. Prose is set in a sans-serif face. Labels, metadata, navigation and code are set in a monospace face. A person speaks, and the machine labels.
  • Two colors. Blue marks where you can go. Rose marks where you are, and what needs you.

A line is drawn only where it says something: the status line, the rules of a table, the mark at the end of a page. There is no rule under the header and none above the footer.

Grid

One column is the width of one character of code.

Part Columns Least width Why
Text 80 36 rem The width of the VT100 screen. A line of 80 characters of code fits without scrolling.
Navigation 24 12 rem
Contents of the page 20 10 rem
Gutter, twice 4 2 rem
Whole page 132 The wide mode of the VT100.
  • The least widths keep the page readable when the reader’s code font is narrow. They hold nearly the same proportions.
  • A code block hangs two columns into each margin. Its text lines up with the prose, and its 80 columns stay whole.
  • A screen too narrow for three parts folds the contents of the page into a line above the text. A narrower one moves the navigation below the text.
  • A table wider than the text scrolls sideways inside its own box.

Type

  • Faces. The reader’s own system fonts, sans-serif and monospace. No font is downloaded.
  • Size. Body text is 17 px.
  • Scale. Each step multiplies by the square root of the golden ratio, about 1.272. Two steps multiply by the golden ratio.
Step Size Used for
−1 0.786 rem Labels, metadata, code
0 1 rem Body text
1 1.272 rem Third-level headings
2 1.618 rem Second-level headings
3 2.058 rem The title of a page
4 2.618 rem The height of the paper tape
6 4.236 rem The name on the home page
  • Rhythm. A line of body text is 1.618 rem high. This is a row. The space between paragraphs is a row divided by the golden ratio, which is 1 rem. Smaller spaces divide again: 0.618 rem and 0.382 rem. Larger ones are whole rows.

Color

Palette

The light theme is Paper and the dark theme is Glass. The page follows the setting of the reader’s system.

Token Paper Glass Used for
--paper #ffffff #070b18 The page
--surface #f3f5fb #0f1528 Code blocks, inline code, keys
--ink #0a0f1f #eef1fa Text
--ink-2 #454e69 #a9b2cc Secondary text
--ink-3 #5e6781 #7f89a6 Labels, marks, the edge of a field
--rule #d3d9e8 #27304d Hairlines. Never the only sign of anything
--blue #0047ff #7aa5ff Links, structure, settled status
--rose #db0a6c #ff6ba6 Text and fills that ask for attention
--rose-signal #ff1f7a #ff5c9d Marks only: the current place, the focus ring, the name

Contrast against the page, by the WCAG 2 formula:

Token Paper Glass Least allowed
--ink 19.1 17.4 7
--ink-2 8.3 9.3 7
--ink-3 5.6 5.6 4.5
--blue 6.3 8.1 4.5
--rose 4.9 7.4 4.5
--rose-signal 3.7 6.8 3

The same floors hold against --surface. A check reads the stylesheet and fails when a token falls below its floor, or when the stylesheet and the palette table above differ.

Rules

  1. Blue marks where you can go. Links, the mark under a heading, the data holes of the tape, a status that is settled.
  2. Rose marks where you are and what needs you. The current section and page, the heading being read in the contents of the page, the focus ring, a status that waits for a decision, a match in the search results, the edge of a quotation.
  3. Rose is rationed. Attention is scarce, so the color that asks for it is scarce. A view holds more blue than rose, and far more ink than either.
  4. No third hue. There is no green for good and no red for bad. A status is told by its word and by its shape, never by its color alone.
  5. --rose-signal is for marks. It does not reach the contrast that small text needs on Paper. It is used for shapes, and for the name, which is large and bold.
  6. Tints are mixed, not added. A highlight is a token mixed into the page at a fixed share. No new color enters the palette.

Status

Status Color Shape
draft, planning Rose Outline
discussion, active Rose Filled
accepted Blue Outline
implemented, shipped Blue Filled
rejected, withdrawn, superseded Ink Dashed outline, struck through

An outline is the earlier state and a fill is the later one. A filled status is set in reverse video.

Details from the history of the terminal

Detail Where What it comes from
Paper tape Under the title of every page The teletype read and punched eight-level paper tape.
The name in two colors Header, home page, footer cotty is co + tty, and tty is short for teletype.
Block cursor After the name The cursor of the video terminal.
Underline cursor Under each second-level heading The other cursor shape of the VT100.
Reverse video Filled statuses, selected text The attribute a video terminal uses to make text stand out.
80 and 132 columns The grid The two widths of the VT100 screen.
Paper and Glass The names of the themes A teletype printed on paper. The first video terminals were called glass teletypes.
EOT The end of every page End of transmission, the control character 04 of ASCII.
The / key Search The search command of ed, and later of vi and less.
A shell session The page for an address that does not exist The message a shell prints for a file that does not exist.

The paper tape

  • The tape under a title is that title, in UTF-8, one column of holes for each byte.
  • The least significant bit is at the top. Three data tracks lie above the feed track and five below it, as on real tape.
  • The proportions are those of real tape: tracks and columns 0.1 inch apart, data holes 0.072 inch across, feed holes 0.046 inch.
  • Data holes are blue. The feed holes, which mark time, are rose.
  • A title longer than 64 bytes is cut at 64.
  • The tape is decoration. It is hidden from screen readers.

The cursor

The cursor blinks four times and then rests. Nothing on a page moves for more than five seconds. It does not blink at all for a reader who has asked for reduced motion.

Access

  • Text meets the contrast floors in the tables above.
  • Every control shows a rose ring when the keyboard reaches it.
  • The first link on a page skips to the text.
  • A link that leaves the site carries an arrow.
  • Printed pages drop the navigation and print the addresses of links.