sitelisted

# Project Site Generator Create and build a static HTML site for a research project. ## Arguments - `/site` -- create site scaffold + build for the current project - `/site [project-slug]` -- target a specific project ## What the site contains - **Index page** -- landing page with paper/talk hero cards and docs grouped by category - **Doc pages** -- each `docs/*.md` file rendered as HTML with a table of contents linking to h2/h3 sections, image lightbox, anchor linking, Hypothes.is annotation layer - **Paper page** -- LaTeX paper converted to HTML via make4ht, with inline footnote tooltips, MathJax, Hypothes.is annotation layer - **Talk page** -- beamer slides converted to HTML via make4ht ## Step-by-step ### 1. Locate project Find workspace root by searching upward for `CLAUDE.md` next to `projects/` and `pipelines/`. Resolve the project: `$ROOT/projects/{slug}/`. Read the project's `CLAUDE.md` to get the project title and short description. ### 2. Check if site already exists If `source/site/build_all.py` already exists: - Ask the user if they want to rebuild only (run the existing script) or regenerate the scaffold. - If rebuild only: skip to step 5. ### 3. Create site scaffold Create the following files using the canonical templates below. #### Directory structure ``` source/site/ build_all.py # main generator script templates/ index.html # landing page doc.html # docs page (markdown rendered) paper.html