Skip to content

fix(docs): readable type, at the sizes the theme meant, and the new logo in the menu bar - #43

Merged
devlato merged 1 commit into
mainfrom
fix/docs-type
Oct 19, 2026
Merged

devlato merged 1 commit into
mainfrom
fix/docs-type

Conversation

@devlato

@devlato devlato commented Oct 19, 2026

Copy link
Copy Markdown
Owner

The docs' text was tiny.

The theme's sizes were written in rem as if 1rem were 16 px, but mdBook sets the root's font size to 62.5%, so 1rem is 10 px. Every size came out at 62.5% of what was meant. Measured on claudius.devlato.com and on this branch, in Chromium:

live this branch
body text 10.6 px 17 px
sidebar 9.2 px 15 px
code blocks 8.4 px 14 px
menu title 11.5 px 18 px
  • The eight sizes in docs/theme/claudius.css are now in mdBook's rem, with a note saying why.
  • The menu bar shows the new mark (/assets/mark-ripples.svg, the site's) instead of the old bars, and the book's title is "Claudius".

How I checked it

  • I measured the sizes above and took screenshots of the live page and this branch's build.
  • cargo xtask site and lychee, the site's Playwright tests, typos.

@devlato
devlato enabled auto-merge (squash) October 19, 2026 23:46
@devlato
devlato merged commit 17d0847 into main Oct 19, 2026
26 checks passed
@devlato
devlato deleted the fix/docs-type branch October 19, 2026 23:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant