Skip to content

Anyone's personal resume pipeline; edit one markdown file and produce a release with a PDF and docx and publish the resulting HTML as a GitHub Page - powered by GitHub Actions.

thomascrha/resume

Repository files navigation

resume

Anyone's personal resume pipeline. Inspired by many but my favourite is this one credit to sdsawtelle.

usage

pssst you can just run make docker and have it all be done inside a container

  1. Fork this repo.
  2. Edit resume.md to your liking. Please for the love of god don't use my resume - it's awful.
  3. Run make convert to generate the various versions of your resume. This way you can fine tune the output locally. BTW the sudo access is to install pandoc and wkhtmltopdf.
  4. You need to enable Pages via Action in Settings->Pages->Source. Make sure you enable write access to your GitHub Actions Settings->Actions->General->Workflow Permissions
  5. Now create a tag that starts with v and push it to GitHub. This will trigger a GitHub action that will generate a release with the various versions of your resume as assets.
  6. Now you can download the various versions of your resume from the release page and access your resume at https://<your-github-username>.github.io/resume - note if you forked it into doperesume it would be /doperesume instead of /resume.

dependencies

Linux is the only supported OS. For other OSes you'll use make docker.

You'll need the following installed:

These are installed by the Makefile WARNING: they may require dependencies that aren't documented here. It works in the GitHub action so it should work on your machine.

goals

  • Use a single source of truth for my resume i.e. a markdown file.
  • Generate a PDF, HTML, plain-text and DOCX version of my resume.
  • Automate the process of updating my resume i.e. using GitHub actions to Generate a new version of my resume and create a GitHub release with the new version as assets.
  • Have a simple Makefile that setup the environment and run the pipeline - allowing me to easily generate things locally if I choose.
  • Publish the resulting HTML and CSS to a GitHub page.

css hints

I've never liked CSS. The mental model IMO is hard - especially for my grug brain.

So the css file was bastardised from the project above. The main thing that you'll probably want to know is you can set custom HTML tags line by line inside the markdown source of truth. that pandoc will respect. For example {#under-heading} putting this at the end of any line will apply the styles associated with the class name.

About

Anyone's personal resume pipeline; edit one markdown file and produce a release with a PDF and docx and publish the resulting HTML as a GitHub Page - powered by GitHub Actions.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published