In looking for a good way to manage my resume, in a way that's easy to write up, as well as easy to render to PDF and a website, I created this repo which utilizes Pandoc, GPP, and Chromium.
Example:
| Input Markdown | Output HTML | Output PDF |
|---|
Create a resume.md with desired content and then run build.sh on a system with pandoc, gpp, and chromium-browser installed.
./build.shThe main web template is template.html. The web stylesheet is style.css which is to be deployed alongside the rendered website.
The PDF template is template-pdf.html. It uses the pdf.css stylesheet to render out to web, after which chromium-browser is invoked to print to a pdf based on the visible HTML. The CSS specifies a special print attribute as well to define thinner margins and page breaking behavior.
Note: I had initially tried using
wkhtmltopdf, but given the project is now archived and is lacking a lot of modern CSS features support such as flexbox, I opted to just make a sane print CSS template and then use Chrome itself to print. This may make the PDF a little less useful in terms of metadata and so on. This is something that should be investigated and improved if necessary.
The resume itself is not standard markdown. It makes use of Pandoc extensions as well as GPP preprocessor macros to allow for the same document to both house the "public" and "private" variants of the resume simultaneously.
Sections of the resume are broken up using raw HTML (previously Pandoc fenced_divs were used). Pandoc's bracket_spans are also used to help organize subtext (although, it could be done with raw HTML at this point as well).
Most of the heavy lifting is taken care of by the CSS and HTML.
See resume.md to see the used features and extensions.