A Quarto template for generating a CV in pdf format. The template is based entirely on Steven Miller's R Markdown templates.
System Requirements:
- quarto >= 1.4
- latex
quarto install extension mps9506/quarto-cvThis will install the template for use with existing Quarto projects or documents.
or To install the extension and create an example qmd file and project (easiest way to start):
quarto use template mps9506/quarto-cvIf you need to use an old version of quarto, install a previous quarto-cv release:
quarto install extension mps9506/[email protected]To use with with quarto in the cli:
quarto render your_cv.qmd --to quarto-cv.pdfor specify in the document yaml:
format:
quarto-cv-pdf: defaultThe contact block at the top of the CV is rendered using the following metadata:
author: First Name Last Name
address: Street, City, State, Country
# The following are optional
phone: your contact number
email: [email protected]
github: github account
orcid: orcid identfier
osf: five character osf id
twitter: twitter handle
web: web address (no `https://`)The template includes a lua filter to easily incorporate multiple bibliographies using .bib files if you choose to manage publications this way.
This is a good option for separating out book/chapter, journal articles, white papers, datasets, and software.
In the document yaml header simply point to your .bib files and provide a unique name:
bibliography:
peer: peer.bib
reports: reports.bib
books: books.bib
software: software.bib
validate-yaml: falseNote, that the validate-yaml key must be false in quarto because it expects
a character value when it vaildates the yaml header.
Now create different bibliographies for each one:
# Journal Articles
::: {#refs-peer}
:::
# Software
::: {#refs-software}
:::
You can specify the bibliographic style using the csl variable. By default it points to an APA style sorted by descending date. Other styles can be found here.
The default font is EB Garamond.
There are two primary methods for changing the font used.
First you can use fonts provided through various LaTeX font packages using the fontfamily: yaml key.
The fontfamilyoptions: can optionally be used in conjunction to set the LaTeX font package option.
This is probably the easiest method if there is a package with the font you want to use.
fontfamily: electrum
fontfamilyoptions: lfThe second option is to point the mainfont: yaml key to a locally installed font.
mainfont: UbuntuNote that fontfamily: will override mainfont: so specify just one.
Support for Chinese, Japanese, and other Asian language characters are provided through the xeCJK package. The pdf will have to be rendered using xelatex instead of the default luatex:
title: CV
format:
quarto-cv-pdf:
pdf-engine: xelatex
CJKmainfont: Noto Sans CJK JPThe CJKmainfont: yaml key should point to a locally installed font.
Here is the source code for a minimal sample document: template.qmd.
The template is based entirely
on Steven Miller's R Markdown templates
licensed under GPL-2. A copy of the pandoc
multibib lua filter
licensed under MIT is included as part of this template.
- add support for fontawesome5 (thanks to @fecet #16).
- Update tex template for changes to citeproc in pandoc >=3.1.8 (Fixes #4).
- Requires quarto >1.4.
- Add support for
xeCJK(Fixes #9).
- Add user specified fonts (Fixes #7).
- Properly embed pandoc-ext
multibibextension (Fixes #2). - Add CI test for pull requests on main.
- Add .quartoignore to avoid copying extra files.
- Fix README.md install instructions (@anielsen001) (#1).
- Initial Release