This project keeps CV content in simple Markdown files and renders them into LaTeX (for PDF) and HTML (for web) via a small build pipeline.
sections/— Source content for CV sections (Markdown). This is the primary place to edit content.generated/— Generated LaTeX and Markdown, rebuilt on every render. Gitignored; do not edit by hand.publications/— BibTeX files for publications.scripts/— Build helpers and live-metrics updater.cv-*.qmd— Quarto entry points (PDF + HTML where relevant).
scripts/build_sections.pyparses the Markdown insections/and generates:generated/tex/*.texfor LaTeX.
scripts/update_metrics.py(optional) fetches Google Scholar stats and parses BibTeX counts intodata/stats.*.- Quarto renders QMD files to PDF/HTML using the generated LaTeX sections.
scripts/clean_artifacts.pyremoves LaTeX artifacts after rendering.
Quarto runs steps 1, 2, and 4 automatically via _quarto.yml (pre-render and post-render).
Edit the Markdown in sections/.
<!--
type: dated
-->
## Teaching
### Institution
- Fall 2025 | Course title<!--
type: enumerated
date_position: end
-->
## Invited Conference Talks
- May 2017 | Talk title. Venue<!--
type: grants
-->
## Grants Awarded
- September 2024 -- December 2026 | \$472,000 | _Grant title_ (Agency). Role: Co-PI (50\%).The ## Heading is required — it is what the Quarto filter keys on to find the
section and map it to its generated .tex file. Escape LaTeX specials (\$, \%,
\&). Add tex: <path> to the metadata comment when the source filename differs
from the slugified heading (e.g. teaching_condensed.md → ## Teaching).
Quarto entry points:
cv.qmd— Canonical CV entry point. The body is pure section includes; a format-specific filter turns that into the HTML template or PDFcurve/\makerubricoutput.cv-odu.qmd— Full CV for ODU workflow (PDF).cv-1p.qmd— 1-page CV (PDF).cv-2p.qmd— 2-page CV (PDF).cv-3p.qmd— 3-page CV (PDF).cv-full.qmd— PDF-only wrapper using the same pure section-include body pattern.cv-web.qmd— HTML-only wrapper using the same pure section-include body pattern.
Render a single target:
quarto render cv.qmd --to pdf
quarto render cv.qmd --to htmlRender all QMD files:
quarto renderLegacy LaTeX workflows are still supported:
make full
make web
make 3p
make 2p
make 1pThe Makefile runs scripts/build_sections.py first to keep LaTeX sections up to date.
update_metrics.py reads BibTeX counts and fetches Google Scholar stats using scholarly.
Environment variables:
CV_SCHOLAR_USER(default:lnh9kdIAAAAJ)CV_SCHOLAR_REFRESH(1/true/yesforces refresh)CV_SCHOLAR_TTL_HOURS(cache TTL, default 168)CV_SCHOLAR_TIMEOUT_SECONDS(default 20)CV_SCHOLAR_DISABLE(1/true/yesto skip scholar fetch)
Cache location: data/gs_cache.json
Create the virtual environment:
uv venv .venvInstall required packages:
uv pip install scholarly- Quarto (for
.qmdrendering) - TeX Live (for PDF builds) with
latexmk
- Markdown supports
*italic*and**bold**inline formatting. - Use
|to separate date and text in dated sections. - Section metadata lives in a top HTML comment:
<!-- type: dated date_position: end -->
- For LaTeX-specific symbols in Markdown, keep the LaTeX escapes (e.g.,
\%,\&,\$).