# Materials folder

Put **solved homework PDFs**, optional **condensed slide exports**, and original handouts here. Topic pages under `topics/` link to these files with **URL-encoded** paths (spaces and punctuation become `%20`, `%2C`, etc.) so long WebAssign filenames work in every browser.

**Linked set (Spring 2026 MATH 151):** syllabus `MathSyl.pdf`, Appendix J homework, §2.2–§4.9 WebAssign exports, and `MATH 151 Review 1–3`. Chapter §5.1–§5.5 exports are not in the folder yet — add when you have them.

## Naming convention (recommended)

Use lowercase, hyphens, and predictable prefixes:

| Pattern | Example |
| --- | --- |
| Solved homework | `hw-<topic>-<nn>-solutions.pdf` |
| Condensed slides | `slides-<topic>-condensed.pdf` |
| Raw slide deck (optional) | `deck-<topic>.pptx` — keep only if you are sure hosting is OK |

Rename your semester files to match the placeholders already linked from `topics/*.html` and `map.html`, **or** edit those HTML tables to match your filenames.

## PPTX → PDF (condensed slides)

Browsers do not reliably preview `.pptx`. Export a short PDF for inline teaching:

**LibreOffice (headless, Linux):**

```bash
soffice --headless --convert-to pdf --outdir /path/to/teachmath/materials /path/to/lesson.pptx
```

**GUI:** open in PowerPoint / LibreOffice Impress → **Export as PDF** → choose slide range for the “condensed” version only.

## Large PDFs

If a scan is huge, compress before upload (e.g. `ghostscript`, or your PDF viewer’s “reduce file size”). Prefer **linking** from topic pages rather than embedding multi‑MB files in an `<iframe>`.

## Git

Binary PDFs are tracked like any other file. If the repo should stay small, use Git LFS or keep large originals elsewhere and only commit compressed copies.