commit 4f90e78815e2e66dac91765e1f3941675a4323d3 parent 94aa9b648dd8fb80185de24322b93e3339be540b Author: Chris Roberts <chris.roberts@learningunix.net> Date: Sun, 7 Jun 2026 07:30:49 -0500 updated readme Diffstat:
| M | README.md | | | 49 | +++++++++++++++++++++++++++++++++++++++++++++++++ |
1 file changed, 49 insertions(+), 0 deletions(-)
diff --git a/README.md b/README.md @@ -0,0 +1,49 @@ +# Resume and Cover Letter Build System + +Resumes and cover letters are written in Markdown and rendered to PDF using pandoc and weasyprint. + +## Required Packages + +```bash +sudo pacman -S pandoc python-weasyprint +``` + +## Directory Structure + +``` +resume/ +├── Chris_Roberts_Resume.md # Master resume — never edit this +├── resume.css # Stylesheet for resume PDFs +├── cover_letters/ +│ ├── cover_letter.css # Stylesheet for cover letter PDFs +│ └── Rogers_DataEngineer_CoverLetter.md +└── [tailored resumes per application] +``` + +## Generating a Resume PDF + +```bash +pandoc YourResume.md -o YourResume.pdf --pdf-engine=weasyprint --css=resume.css +``` + +## Generating a Cover Letter PDF + +Run from inside the `cover_letters/` directory: + +```bash +pandoc YourCoverLetter.md -o YourCoverLetter.pdf --pdf-engine=weasyprint --css=cover_letter.css +``` + +## Workflow + +1. Copy `Chris_Roberts_Resume.md` to a new file named for the target role (e.g. `Chris_Roberts_Resume_RoleName.md`) +2. Tailor the copy — never modify the master +3. Write a matching cover letter in `cover_letters/` +4. Generate both PDFs using the commands above + +## Notes + +- The `--pdf-engine=weasyprint` flag is required; pandoc's default LaTeX engine does not use CSS +- weasyprint will emit warnings about unsupported CSS properties — these are harmless +- Use two trailing spaces at the end of a line to force a line break within a paragraph (standard markdown hard break) +- Cover letter CSS is set to 10.5pt Georgia, 1in margins to fit content on one page