lalbrow.github.io

Personal academic website for Leah Albrow. Built with Hugo + PaperMod, hosted on GitHub Pages. Deploys automatically on every push to main.

---

Local development

# Install Hugo (once)
brew install hugo

# Preview with live reload at http://localhost:1313
hugo server

---

How to update common things

Bio text

Edit config.yml → params.profileMode.subtitle. The text supports Markdown (links, <br> for line breaks).

Profile photo

Replace static/telescope_me.jpeg. Keep the filename, or update params.profileMode.imageUrl in config.yml to match the new name.

CV

Replace static/academic_cv.pdf. The CV icon in the social links picks it up automatically.

Social links (CV, email, Scholar, GitHub, ORCID)

Edit the params.socialIcons list in config.yml. Each entry needs a name (matches the SVG icon library) and a url.

---

Adding a new paper

1. Create a folder: content/papers/yourpaper/
2. Add an index.md inside it — copy archetypes/paper.md as a starting point
3. Put the cover figure in the same folder (e.g. figure.png)

Minimal front matter:

---
title: "Your Paper Title"
date: 2025-01-15
author: ["Author One", "Author Two"]
description: "One sentence shown on the homepage card."
cover:
    image: "figure.png"
    relative: true
editPost:
    URL: "https://doi.org/10.xxxx/xxxxx"
    Text: "Journal Name"
arxiv: ""   # optional: "https://arxiv.org/abs/2501.XXXXX"
code: ""    # optional: "https://github.com/lalbrow/repo"
---

The paper appears on the homepage grid automatically on next build. No template edits needed.

To hide a paper from the homepage grid without deleting it, add hiddenInHomeList: true to its front matter.

Editing paper detail content

The full paper page (abstract, citation, BibTeX, figures) lives in the body of content/papers/yourpaper/index.md below the --- front matter block. It supports Markdown and LaTeX math ($...$ inline, $$...$$ display).

---

Outreach section

Edit content/outreach.md. Standard Markdown — links, #### subheadings, --- horizontal rules.

---

Design system

All visual tokens live in assets/css/core/theme-vars.css.

Variable	Purpose
--darkcolor	Accent green (#1a5c38 light / #4db377 dark)
--main-width	Max content width (960px)
--font-heading	EB Garamond (loaded from Google Fonts)
--font-body	Inter (loaded from Google Fonts)
--gap	Base spacing unit (20px)

Light mode background is pure white (#ffffff). Dark mode is near-black with a green tint (#0c100c). The dark/light toggle is a floating circle button in the top-right corner.

Where CSS lives

File	Controls
assets/css/core/theme-vars.css	All color/font/size tokens
assets/css/common/profile-mode.css	Hero (bio + photo layout)
assets/css/common/research-cards.css	Research grid + outreach section
assets/css/extended/dark-academia.css	Font assignments, theme toggle button

The PaperMod theme is in themes/PaperMod/. Never edit files there — Hugo always prefers the root layouts/ and assets/ directories, so override there instead.

---

Deployment

Push to main → GitHub Actions builds with hugo --minify and deploys to GitHub Pages. Takes ~1 minute. The workflow is in .github/workflows/hugo.yml.

git add .
git commit -m "your message"
git push

---

File map (the parts you'll actually touch)

config.yml                        ← bio, social links, site title
static/
  telescope_me.jpeg               ← profile photo
  academic_cv.pdf                 ← CV download
content/
  outreach.md                     ← outreach section text
  papers/
    paper1/
      index.md                    ← paper metadata + detail page
      paper.png                   ← cover figure
assets/css/core/theme-vars.css    ← colors, fonts, spacing