tex/cv
1
0
Fork 0
mirror of https://github.com/prdlk/cv.git synced 2026-08-02 17:31:41 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(root): Update documentation and migrate to self-contained LaTeX resume template

Browse Source
This commit is contained in:
Prad Nukala
2026-06-25 13:46:15 -04:00
parent d29a7a565d
commit 2145a059fe
2 changed files with 32 additions and 54 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+9 -18
View File
@@ -4,39 +4,30 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
## What this is
A single-page, two-asymmetric-column LaTeX resume template (Deedy-Resume, OpenFonts variant). The content lives in one `.tex` file; styling lives in one `.cls` file; publications come from a `.bib` file via BibTeX.
A single-page, two-column LaTeX resume. All content and styling live in one file: `source.tex`. There is no class file, no bibliography, and no bundled fonts — it is a plain `article` document.
## Build
Must compile with **XeLaTeX**, not pdflatex — the template uses `fontspec` to load the bundled OTFs in `fonts/lato/` and `fonts/raleway/` by path. All commands must run from the repo root so those relative paths resolve.
Compiles with **pdflatex** (via `latexmk`). `source.tex` uses `inputenc`/`fontenc` with default Computer Modern fonts, so no XeLaTeX or external font files are needed.
```bash
make # one-shot build → dist/deedy_resume-openfont.pdf
make watch # latexmk -pvc: rebuild + live-preview on every save (dev mode)
make # one-shot build → dist/source.pdf
make watch # latexmk -pvc: rebuild + live-preview on every save
make preview # build once and open the PDF
make clean # remove LaTeX aux files, keep the PDF
make distclean # remove dist/ entirely
```
Under the hood `make` calls `latexmk -xelatex` with `-output-directory=dist`, which handles the bibtex passes for `publications.bib` automatically. There is no CI or linter — the only "test" is that the PDF compiles and stays one page (see Layout constraint below).
`make` runs `latexmk -pdf -output-directory=dist`. No CI, no linter — the only "test" is that it compiles and stays one page.
## Architecture
- **`deedy-resume-openfont.cls`** — document class. Defines colors, font face mappings (Lato + Raleway loaded from relative `fonts/` paths via `fontspec`), and the custom commands the `.tex` file calls: `\namesection`, `\runsubsection`, `\descript`, `\location`, `\sectionsep`, and the `tightemize` environment. Edit this file for styling/typography; edit the `.tex` for content.
- **`deedy_resume-openfont.tex`** — content. Note the filename uses an underscore while the class file uses a hyphen — this asymmetry is intentional, don't "fix" it. The two columns are a `minipage` pair (`0.33\textwidth` left, `0.66\textwidth` right) separated by `\hfill`.
- **`publications.bib`** — entries cited via `\nocite{*}` in the Publications section.
- **`fonts/`** — bundled OTFs. The `.cls` references them by relative path, so the working directory at build time must be the repo root.
The two columns are a [`paracol`](https://ctan.org/pkg/paracol) environment, split by `\columnratio{0.3}` (left 30% / right 70%) and divided with `\switchcolumn`. The left column holds Contact / Skills / Languages; the right holds Summary / Experience / Education / Projects. Section headers are a bold label followed by a `\rule` underline; entries use `enumitem` `itemize` lists with `nosep` to keep them tight.
## Layout constraint
The template is **single-page by design** and silently overflows to a second page if either column gets too long (documented in README "Known Issues"). When adding content, mentally budget against the existing column length and prefer trimming over adding. The `\sectionsep` (8pt) and `tightemize` (a tightened `itemize`) exist specifically to claw back vertical space.
Single-page by design — it silently overflows to a second page if a column gets too long. When adding content, budget against the existing column length and prefer trimming over adding.
## Known quirks to leave alone
## Note on history
- `deedy_resume-openfont.tex` ends with a stray `\documentclass[]{article}` *after* `\end{document}` (line 249). It's ignored by the compiler and is a long-standing artifact of the upstream template.
- `\refname` is redefined twice (once in the `.cls`, once inline in the `.tex` Publications section) — the inline redefinition is a documented workaround the upstream author couldn't get working from the `.cls` alone.
- The first bullet of column two has a hand-tuned `\vspace{\topsep}` to fix awkward spacing — don't remove it without checking the rendered output.
## Upstream
Forked from https://github.com/deedydas/Deedy-Resume (Apache 2.0). The README in this repo is the upstream README and still references the upstream author's content; treat it as template documentation rather than a description of this fork.
This was forked from the Deedy-Resume template (XeLaTeX, custom `.cls`, bundled OTFs in `fonts/`). That entire stack has been removed in favor of the self-contained `source.tex`. `README.md` is still the upstream Deedy README and describes the old template, not this fork — treat it as historical, not as a description of the current setup.