Skip to content

Migrate academic website from org-mode to Quarto#9

Open
spencerahill wants to merge 1 commit intomasterfrom
claude/migrate-academic-website-C6WkT
Open

Migrate academic website from org-mode to Quarto#9
spencerahill wants to merge 1 commit intomasterfrom
claude/migrate-academic-website-C6WkT

Conversation

@spencerahill
Copy link
Copy Markdown
Owner

Summary

Migrates the academic website from an Emacs org-mode based setup to Quarto, a modern static site generator. The new site is deployed to GitHub Pages via GitHub Actions.

Key Changes

  • New site structure: Converted all content to Quarto markdown (.qmd) files:

    • Core pages: index.qmd, group.qmd, opportunities.qmd, publications.qmd, teaching.qmd, resources.qmd, about.qmd
    • Blog: blog/index.qmd with dated posts in blog/posts/
  • Styling: Implemented a Tufte-inspired theme with:

    • Custom SCSS variables and rules in styles.scss (using et-book font)
    • Additional CSS refinements in styles.css for typography, links, blockquotes, and responsive sidenotes
  • Configuration: Added _quarto.yml with:

    • Site metadata and navigation bar
    • HTML format settings (Cosmo theme base with custom styling)
    • Output directory and resource configuration
  • Deployment: Added GitHub Actions workflow (.github/workflows/publish.yml) to automatically build and deploy to GitHub Pages on pushes to main

  • Documentation: Updated README.md with instructions for local development and site structure

  • Gitignore: Added entries for Quarto build artifacts (_site/, .quarto/)

Notable Implementation Details

  • The site maintains all existing content (publications list, group member bios, resources, etc.) with improved formatting
  • Interactive demo template included (teaching-interactive-demo.qmd) showing Observable JS integration for pedagogical tools
  • Blog includes RSS feed support via Quarto's listing configuration
  • Site uses GitHub Pages with custom domain support (CNAME file preserved)
  • Responsive design with sidebar and margin notes that adapt for smaller screens

https://claude.ai/code/session_01VKkRLxjcXpiyf5rAcfiRzW

Replaces the org-mode + Emacs publish pipeline with a Quarto project that
builds a static site deployable to GitHub Pages. All pages from the legacy
site (index, group, opportunities, publications, teaching, resources, about)
are converted to .qmd. Adds a blog scaffold with a listing page and RSS, an
Observable JS interactive-demo template for pedagogical use, a Tufte-inspired
stylesheet using ET Book typography, and a GitHub Actions workflow that
renders and publishes to Pages.

Legacy org/, public_html/, and css/ directories are retained untouched for
archival reference.
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.

2 participants