Dean’s Award — Supporting Documents

Two A4 PDFs for the 2026 Dean’s Award for Excellence in Research by a Research Fellow, generated from editable YAML so you can change wording without touching HTML/CSS.

Output (in `build/`)	What it is
`Yuefeng_Yin_MSE_EiR_2026.pdf`	The 2-page CV — submit this (required filename).
`Yuefeng_Yin_MSE_EiR_2026_Statement.pdf`	“What makes me a strong candidate” statement.

The CV filename follows the required format FirstName_Surname_Dept_EiR_2026.pdf. MSE = Materials Science & Engineering — change award.filename_base in data/profile.yaml if your department uses a different abbreviation.

Edit the content

All wording lives in three files — edit these, nothing else:

data/profile.yaml     # name, role, contact, award title, output filename (shared by both docs)
data/statement.yaml   # the supporting statement (lead + sections/blocks)
data/cv.yaml          # the 2-page CV (metrics, appointments, funding, publications, …)

Formatting inside any text field:

Markdown: **bold**, *italic*.
Inline HTML is allowed too: 2, Nature, muted text.
A blank line starts a new paragraph (statement bodies).

Layout/look (fonts, colours, margins) lives in templates/*.css; structure in templates/*.j2.

Compile

One-time setup (uses the repo’s .venv):

.venv/bin/pip install -r 2-page-cv/requirements.txt

Build both documents (HTML → PDF):

cd 2-page-cv
../.venv/bin/python build.py            # both docs
../.venv/bin/python build.py cv         # CV only
../.venv/bin/python build.py statement  # statement only
../.venv/bin/python build.py --no-pdf   # HTML only (skip PDF step)

Outputs land in build/. The script prints each PDF’s page count and warns if the CV is not exactly 2 pages — if it overflows, trim a publication or shorten a body in data/cv.yaml and rebuild.

How it works

data/*.yaml  +  templates/*.j2 (+ *.css)
        │  Jinja2 + Markdown
        ▼
build/*.html
        │  headless Google Chrome  (--print-to-pdf, A4 via @page)
        ▼
build/*.pdf

PDF rendering uses headless Google Chrome (auto-detected on macOS/Linux). To use a different browser binary:

CHROME_BIN="/path/to/chrome-or-chromium" ../.venv/bin/python build.py

No Chrome? build.py still writes the HTML; open it in any browser and use Print → Save as PDF (paper size A4, margins Default, uncheck Headers and footers).