paigenorth.github.io
Academic homepage of Paige Randall North, built as a custom Jekyll template on GitHub Pages (no local build step; GitHub builds on push).
Architecture
README.mdis the homepage content. GitHub Pages’jekyll-readme-indexplugin serves it at/. This is deliberate: Paige edits only README.md for routine updates (news items, papers, talks). Never rename it or add anindex.md/index.htmlthat would shadow it._layouts/default.html— the single layout: sticky header, nav, theme toggle, footer. The “About me” heading and portrait are injected only whenpage.url == "/"(sub-pages likemidwest/index.mdmust not get them).assets/css/style.css— all styling. Light/dark themes are CSS custom properties on:root; dark applies viaprefers-color-schemeand via[data-theme]set by the toggle (the attribute must win in both directions).htmlandbodyboth carrybackground— removing thehtmlone reintroduces a white flash on anchor jumps.assets/js/main.js— builds the nav from the page’s own headings: each# H1becomes a top-level item, each### H3under it becomes a dropdown entry. Nothing to update when sections change. Also: theme toggle (persisted inlocalStorage, follows OS preference until the user chooses), mobile hamburger, scrollspy highlighting.assets/fonts/— self-hosted STIX Two Text (regular + italic woff2, variable weight 400–600). Body/content serif; headings and nav use the system sans stack. Do not swap in a CDN link.
Gotchas
titles_from_headingsis disabled in_config.ymlon purpose:logic-seminar-2025.mdstarts with “# Algebraic theories.” which would otherwise become its browser-tab title.logic-seminar-2025.mdhas apermalink: /teaching/logic-seminar-2025.htmlbecause README links to it at that path.- Old standalone pages (
ross/,hottseminar/,old-index.html) are static HTML served verbatim — intentionally untouched archives. - No Gemfile: the machine’s Ruby (2.6) is too old for modern Jekyll. To preview locally, render README.md with kramdown and splice it into the layout manually (resolve the Liquid by hand), or just rely on GitHub Pages.
Owner preferences (from the redesign session, July 2026)
- Serious, pared-down look; STIX Two Text chosen for its math-publishing feel.
- Headings sans-serif, body serif; wide content column (65rem) on desktop.
- Design must work in both themes and on phones — verify both before pushing.