Prose
Rosetta Stone: Prose & Reading Measure
Inside .prose, paragraphs, headings, and lists are automatically constrained to the comfortable reading measure (var(--prose-width), default 42rem) and centered within var(--page-max-width). Child blocks can break out into wider columns using .wide or .full.
| Intention | HTML Class / Frontmatter | CSS Token (var(...)) |
|---|---|---|
| Long-form editorial container | <article class="prose"> |
Reads --prose-width and --page-max-width |
| Flush-left editorial column | <main class="prose left"> |
Zeroes auto horizontal margins |
Constrain box to reading width (outside .prose) |
.max-w-prose / .max-w-line |
max-width: var(--prose-width) |
| Narrow callout / aside column | .narrow |
max-width: var(--prose-narrow) |
| Wide figure / table breakout | .wide / .max-w-wide |
Expands beyond --prose-width by --prose-wide |
| Edge-to-edge full bleed | .full / .full-bleed |
Spans full viewport/container width |
Prose Layout System
Layout
Prose-focused layout system for optimal reading experience with proper line lengths based on typography research (60-75 characters). Uses CSS Grid with responsive content columns for sidebars, accents, and featured content. Inspired by fine-art typography and classical book design principles.
| Name | Description |
|---|---|
.prose |
Main article/content grid container for readable prose with named tracks. |
.prose.left |
Left-aligned prose variant hugging the left edge. |
.narrow |
Inset element narrower than prose reading column (var(--prose-inset)). |
.wide |
Breakout column extending past prose reading column (var(--prose-wide)). |
.full |
Full container width breakout track spanning to --page-max-width. |
.full-bleed |
Full viewport width breakout track (100vw). |
--prose-width |
Active reading column measure. |
--page-max-width |
Overall page max-width constraint (1400px). |
.hero |
Alias of .full: a hero block on the full-width track. |
.stnd-screen-break |
A short centred rule that separates sections; add .screen-full for a full-screen pause. |
.stnd-screen-section |
A section spanning every column; add .screen-full for a full-screen one. |
.no-grid |
Turns the prose grid off on that container (and the image-gallery layout with it). |
.scroll |
A scrolling box; one holding a table takes the wide track. |
.mermaid |
Container for a rendered Mermaid diagram. |
// Standard article with proper reading width
<article class="prose">
<h1>Article Title</h1>
<p>Content here stays within optimal reading width...</p>
</article>
// Narrow sidebar content
<div class="prose small">
<p>Short form content</p>
</div>
// Featured content with emphasis
<section class="prose feature">
<blockquote>Important quote with extra space</blockquote>
</section>
Tracks: narrow, the reading column, wide and full
<div class="prose">
<p>A paragraph on the reading column, set to <code>--prose-width</code>.</p>
<div class="narrow bg-background border rounded-sm p-half">narrow: inset from the reading column</div>
<div class="wide bg-background border rounded-sm p-half">wide: breaks out of the reading column</div>
<div class="full bg-background border rounded-sm p-half">full: spans to <code>--page-max-width</code></div>
</div>
Live
A paragraph on the reading column, set to --prose-width.
--page-max-widthLeft-aligned prose hugs the left edge
<div class="prose left">
<p>The reading column starts at the left edge of the container instead of being centred.</p>
</div>
Live
The reading column starts at the left edge of the container instead of being centred.
A section break, and a hero image on the full track
<div class="prose">
<p>Text before the break.</p>
<hr class="stnd-screen-break">
<p>Text after it: the break is a short rule with generous space around it.</p>
<div class="hero bg-background border rounded-sm p-half">hero: spans to the page shell, like .full</div>
</div>
Live
Text before the break.
Text after it: the break is a short rule with generous space around it.
Full-bleed spans the whole viewport (shown as code: it would overflow this page)
<img class="full-bleed" src="photo.jpg" alt="">
Links to another note, and prose with the grid turned off
<p>The long version lives in <a class="mycelial-link" href="#">another note</a>, linked with a dotted underline.</p>
<div class="prose no-grid">
<p>A <code>.no-grid</code> container is plain flow: no tracks, so <code>.wide</code> and <code>.full</code> do nothing here.</p>
</div>
Live
The long version lives in another note, linked with a dotted underline.
A .no-grid container is plain flow: no tracks, so .wide and .full do nothing here.
since 0.1.0 · see https://www.rsub.com/blog/how-long-should-a-line-of-text-be/
All classes
Other
| Class | Declares |
|---|---|
.stnd-doc-live |
box-shadow: var(--shadow-border) |