Skip to content

CLAUDE.md

Latest commit

 

History

History
86 lines (61 loc) · 3.02 KB

CLAUDE.md

File metadata and controls

86 lines (61 loc) · 3.02 KB

aneeshcs.github.io — Claude Code Instructions

Site overview

Hugo Blox academic site deployed to GitHub Pages via GitHub Actions (master branch → deploy).

  • Source: content/ (Hugo markdown), static/ (copied as-is), notebooks/ (marimo .py files)
  • Build: Hugo + marimo WASM export runs in CI (.github/workflows/deploy.yml)
  • Live: https://aneeshcs.github.io

Marimo notebooks

Notebook sources live in notebooks/. The deploy workflow exports them to static/gfd/ using:

uvx marimo export html-wasm --sandbox --mode edit notebooks/<name>.py -o static/gfd/<name>.html

To preview a notebook locally:

cd /Users/ansu6268/github/GeophysicalFluidDynamics
marimo edit twodnavierstokes.py

Monthly: new publication check

A GitHub Actions cron job runs on the 1st of each month (.github/workflows/check-publications.yml). It queries Semantic Scholar author ID 47680095 (Aneesh C. Subramanian) for papers not yet in content/publication/ or publications.bib, fetches their bibtex from doi.org, and opens a PR titled "📚 N new publication(s) found — please review" on the publications/monthly-update branch.

To review the PR:

  1. Open the PR — the body lists every new paper with title, venue, year, and DOI
  2. Edit publications.bib in the PR branch to correct or remove any entries
  3. Merge to add the papers to the site (triggers Hugo page generation automatically)
  4. Close without merging to skip all papers this month

To manually trigger the check:

Go to Actions → "Monthly publication check" → Run workflow.

To add a paper immediately (outside the monthly cycle):

# 1. Append its bibtex to publications.bib
# 2. Run the import locally to generate Hugo pages
pip install "academic>=0.10.0"
academic import publications.bib content/publication/ --compact
# 3. Commit and push
git add publications.bib content/publication/ && git commit -m "publications: add <slug>"
git push

Notes:

  • Semantic Scholar may not index a paper for weeks after publication — check manually if needed
  • Set up Google Scholar email alerts at https://scholar.google.com/scholar_alerts as a faster notification layer
  • The script ignores papers with no DOI on Semantic Scholar; add those manually

Monthly: check for broken references

Run a broken-link check against the live site on the first of each month.

Command:

uvx linkchecker https://aneeshcs.github.io --check-extern \
  --ignore-url "linkedin\." \
  --ignore-url "twitter\." \
  --ignore-url "x\.com" \
  --output failures

What to look for:

  • Internal 404s (missing pages, moved content, renamed files)
  • Broken href or src attributes in Hugo shortcodes or raw HTML blocks
  • Dead DOI or publication links in content/publication/
  • Iframe src paths to marimo notebooks that no longer exist

If broken links are found:

  1. Fix the source in content/ or static/
  2. For moved Hugo pages, add an aliases: entry in the front matter
  3. Commit and push — the deploy workflow handles the rest