8000 GitHub - quinfer/resume · GitHub
[go: up one dir, main page]

Skip to content
quinferPublic

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Prof. Barry Quinn - Resume Website

This repository contains Prof. Barry Quinn's CV website and source files. The complete CV (index.qmd) is the canonical published version.

🌐 Website

The main resume website is generated from index.qmd and provides access to all CV versions.

Live Website: Open index.html in a browser after building.

📄 CV Versions

File Purpose Published
index.qmd Complete CV / website Yes (HTML + Typst PDF)
cv_academic.qmd Academic extract No (build with --all)
cv_industry.qmd Industry extract No (build with --all)
cv_grants.qmd Grants extract No (build with --all)

🔧 Building the CVs

Quick Build (Choose your preferred method)

Python (Recommended)

python3 scripts/build_cvs.py          # Complete CV only
python3 scripts/build_cvs.py --all    # Include tailored extracts

Bash

./scripts/build_all_cvs.sh

Manual Build

# Build individual versions (from project root)
quarto render src/index.qmd --output-dir dist
quarto render src/cv_academic.qmd --output-dir dist
quarto render src/cv_industry.qmd --output-dir dist
quarto render src/cv_grants.qmd --output-dir dist

Development Builds (Fast HTML-only for testing)

Quick build all HTML versions

python3 scripts/dev_build.py

Build specific file for testing

python3 scripts/dev_build.py index           # Builds src/index.qmd → dist/index.html
python3 scripts/dev_build.py cv_academic     # Builds src/cv_academic.qmd → dist/cv_academic.html

Manual development builds

# Build just HTML for quick preview
quarto render src/index.qmd --to html --output-dir dist

# Build specific version to PDF
quarto render src/cv_academic.qmd --to pdf --output-dir dist

📁 File Structure

resume/
├── src/                   # Source files
│   ├── index.qmd          # Main resume website
│   ├── cv_academic.qmd    # Academic version (4 pages)
│   ├── cv_industry.qmd    # Industry version (2 pages)
│   └── cv_grants.qmd      # Grant application version (5 pages)
├── scripts/               # Build automation
│   ├── build_cvs.py       # Main build script (Python)
│   ├── build_all_cvs.sh   # Build script (Bash)
│   ├── dev_build.py       # Development build script (HTML only)
│   └── deploy_local.py    # GitHub Pages local deployment
├── assets/                # Templates and styling
│   ├── custom-template.html
│   ├── custom-styles.css
│   └── img/
│       └── head_shot.png
├── data/                  # Data files
│   ├── bqpubs.bib         # Bibliography
│   └── Grant_income.csv   # Grant data
├── dist/                  # Generated outputs (HTML, PDF, assets)
│   ├── index.html         # Built website
│   ├── *.pdf              # All PDF versions
│   └── *_files/           # Quarto generated assets
├── .github/workflows/     # GitHub Actions
│   └── publish.yml        # Auto-deploy to GitHub Pages
├── archive/               # Old/unused files
├── index.html             # GitHub Pages file (copied by deploy script)
├── index_files/           # GitHub Pages assets (copied by deploy script)
├── README.md              # This file
└── .gitignore            # Git ignore patterns

🎯 Usage Guidelines

Share the website link or index.pdf — the complete CV covers research, teaching, grants, and service.

Tailored extracts (cv_academic, cv_industry, cv_grants) remain in src/ for internal use. Build locally with python3 scripts/build_cvs.py --all when needed.

🔄 Development Workflow

For Quick Edits and Testing

  1. Edit the relevant .qmd file(s) in src/
  2. Run python3 scripts/dev_build.py for fast HTML preview
  3. Open dist/index.html in browser to review changes
  4. Iterate until satisfied

For Final Production Build

  1. Run python3 scripts/build_cvs.py to generate the website and index.pdf (Typst)
  2. Test the download link on the website
  3. Commit and push changes

Typical Development Session

# Edit files in your editor (src/*.qmd)
# Quick test build
python3 scripts/dev_build.py index

# Preview in browser
open dist/index.html

# Final build when ready
python3 scripts/build_cvs.py

🌐 GitHub Pages Deployment

Automatic Deployment (Recommended)

The repository includes GitHub Actions that automatically build and deploy to GitHub Pages on every push to main branch. The workflow:

  1. Builds the complete CV using our Python build system
  2. Deploys the dist/ folder contents to GitHub Pages

Manual Local Deployment

For local GitHub Pages testing or manual deployment:

# Build and copy files to root directory for GitHub Pages
python3 scripts/deploy_local.py

This script:

  • Builds the complete CV website
  • Copies index.html, index_files/, img/, and index.pdf to root directory
  • Removes previously published variant CV files from the root directory

📋 Dependencies

  • Quarto (includes R runtime for executing R code blocks)
  • Python 3 (for build scripts)
  • Typst (for the complete CV PDF; bundled with Quarto 1.4+)
  • LaTeX distribution (only needed for optional variant PDFs via --all)

R Packages (automatically managed by Quarto):

  • tidyverse, knitr, kableExtra (loaded in .qmd files as needed)

📞 Contact

Prof. Barry Quinn
Email: b.quinn1@ulster.ac.uk
GitHub: quinfer

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

0