Site design
On this page
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
- Blue marks where you can go. Links, the mark under a heading, the data holes of the tape, a status that is settled.
- 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.
- 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.
- 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.
--rose-signalis 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.- 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.