Skip to content

Skrive v0.2.4 — Document outline rail

Choose a tag to compare

View all tags
@github-actions github-actions released this 21 May 13:48
· 199 commits to main since this release
v0.2.4
7ec730f

The outline rail: a fast way to see a document's shape and move around inside it, right where you read it.

What's new

Outline rail

In Preview (⌘3), any document with two or more headings gets a slim rail of section ticks down the right edge:

  • It tracks where you are. The tick for the section you're currently reading stays highlighted as you scroll.
  • Click a tick to jump to that heading.
  • Hover or focus the rail to expand a labeled outline — every heading, indented by level, the current one marked. Click a row to jump.
  • Drag the rail to scrub the whole document, like a scrollbar that knows your structure.
  • Tick width tapers by heading depth, so the shape of the rail echoes the shape of the document.

Toggle it in Settings → General → Outline rail (on by default). The rail lives on the rendered preview — a reading-and-navigating aid — so the writing canvas stays clean.

In-document links

Headings now carry anchor ids, so [jump to a section](#heading-name) links resolve inside the preview. Ids use the same GitHub-style slug rule a published copy would (lowercase, spaces to hyphens, punctuation dropped), and repeats disambiguate the way GitHub does (-1, -2). A bare # link scrolls back to the top.

Under the hood

  • Keyboard-complete: Tab to the rail, then ↑/↓/Home/End to move, Enter to jump, Esc to close. The rail is a single focus stop (a listbox with aria-activedescendant), and motion respects prefers-reduced-motion.
  • The rail reads heading positions from the rendered output, so it stays accurate through line wrapping, images, and reflow.
  • Slugging and active-section logic are unit-tested — 23 new tests.

Notes

  • The rail is preview-only: it navigates the rendered document, not the editor, and it's deliberately an ambient affordance rather than another docked panel. It's hidden in raw and split layouts, and on documents with fewer than two headings.

Install

  • macOS arm64 — Skrive-0.2.4-arm64.dmg, drag Skrive to Applications. Signed and notarized. Already on v0.2.3? The in-app updater will offer this one automatically.
  • Windows — Skrive-0.2.4-Setup.exe. SmartScreen warns (unsigned); click "More info" → "Run anyway."
Assets 12
Loading