However, now that I have a personal website, I do not really need a html version of my CV; I would much prefer a nicely formatted pdf. Ideally, I would like to,
I thought about making a theme for JSON Resume but now that I use Org-mode for writing all of my LaTeX documents, writing my CV in Org-mode was all to appealing. There are loads of great LaTeX CV templates out there which I want to be able use, for example, [[https://www.overleaf.com/latex/templates/altacv-template/trgqjpwnmtgv][this AltaCV template]]. I have managed a LaTeX CV in the past and it ended up very messy. Luckily, writing LaTeX documents in Org-mode is much easier and also provides all the extra features of Org-mode, e.g. code folding, TODOs, running source code, tagging sections and much, much more! In this post I want to show how any LaTeX CV template can easily be set up in org-mode and I will achieve this via an example, [[https://www.overleaf.com/latex/templates/altacv-template/trgqjpwnmtgv][this AltaCV template]].
{{% toc %}}
** Structuring the Org Document Before we dive into the details of configuring and writing our Org-mode CV, I want to show how the org-mode document can be structured to make it easy to manage content.
The =:noexport:= tag allows trees and/or sub-trees to not be exported into the pdf. I tag all of my configuration subtrees with =:noexport:= and all of the content that I do not want to export for a particular job. For example, I might not want to export a particular project or I might not want to export the publications section.
The =:ignore:= tag allows the contents of a tree or sub-tree to be exported without exporting the heading. This is useful for giving the org-mode document good structure so that it is easy to work with the file. For example, I have a tree with the heading =Backmatter= and all that it contains is the end column and end document commands (=\end{paracol}= and =\end{document}=). I do not like it when the end document tag comes under the previous heading; what if I decide I do not want to export that section or I delete it! The =:ignore:= tag functionality is provided by the =ignore-headlines= function in the =ox-extra= package. In [[https://github.com/hlissner/doom-emacs][Doom Emacs]] I import the function and activate it with:
(after! org (use-package! ox-extra :config (ox-extras-activate '(latex-header-blocks ignore-headlines))))
Lovely stuff! Using these tags I structure my org mode document with the following headings, subheadings and tags.
I am using [[https://www.overleaf.com/latex/templates/altacv-template/trgqjpwnmtgv][this AltaCV LaTeX template]] which utilises columns to fit more content onto a single. I separate the columns into their own trees which makes working with columns easy! At the start of the =column one= tree I add the following LaTeX export block to configure two columns:
\begin{paracol}{2}
At the start of the =column two= tree I switch to the right column by adding the following:
\switchcolumn
And in the =Backmatter= tree I end the paracol and document environments.
\end{paracol} \end{document}
Easy!
** Global Configuration for Org-Mode's LaTeX Exporter In order to export to pdf via LaTeX you need to configure org-mode's LaTeX exporter. Here is the part of my Doom Emacs config relevant to the org-mode LaTeX exporter.
(after! org ;; Import ox-latex to get org-latex-classes and other funcitonality ;; for exporting to LaTeX from org (use-package! ox-latex :init ;; code here will run immediately :config ;; code here will run after the package is loaded (setq org-latex-pdf-process '("pdflatex -interaction nonstopmode -output-directory %o %f" "bibtex %b" "pdflatex -interaction nonstopmode -output-directory %o %f" "pdflatex -interaction nonstopmode -output-directory %o %f")) (setq org-latex-with-hyperref nil) ;; stop org adding hypersetup{author..} to latex export ;; (setq org-latex-prefer-user-labels t)
;; deleted unwanted file extensions after latexMK
(setq org-latex-logfiles-extensions
(quote ("lof" "lot" "tex~" "aux" "idx" "log" "out" "toc" "nav" "snm" "vrb" "dvi" "fdb_latexmk" "blg" "brf" "fls" "entoc" "ps" "spl" "bbl" "xmpi" "run.xml" "bcf" "acn" "acr" "alg" "glg" "gls" "ist")))
(unless (boundp 'org-latex-classes)
(setq org-latex-classes nil)))** Local Configuration for Org-Mode CV File Exporting an org file to LaTeX requires a LaTeX class to be defined in you Emacs config. In particular, you need to append a template to =org-latex-classes=. I copied the LaTeX preamble (everything before =\begin{document}=) from [[https://www.overleaf.com/latex/templates/altacv-template/trgqjpwnmtgv][this AltaCV template]] and removed all of the package imports (=\usepackage{}=). I do no want this LaTeX class to always be globally available through my Emacs config as I will only be using it in this org file. So instead of adding it in my Emacs config, I add it inside a source block in my resume file (=resume.org=), under the =Config= heading; as source blocks allows us to run =emacs-lisp= code inside the org file. I use the following source block inside my =resume.org= file to append the LaTeX class to the =org-latex-classes= variable:
;; #+BEGIN_SRC emacs-lisp :exports none :results none :eval always (add-to-list 'org-latex-classes '("altacv" "\documentclass[10pt,a4paper,ragged2e,withhyper]{altacv}
% Change the page layout if you need to \geometry{left=1.25cm,right=1.25cm,top=1.5cm,bottom=1.5cm,columnsep=1.2cm}
% Use roboto and lato for fonts \renewcommand{\familydefault}{\sfdefault}
% Change the colours if you want to \definecolor{SlateGrey}{HTML}{2E2E2E} \definecolor{LightGrey}{HTML}{666666} \definecolor{DarkPastelRed}{HTML}{450808} \definecolor{PastelRed}{HTML}{8F0D0D} \definecolor{GoldenEarth}{HTML}{E7D192} \colorlet{name}{black} \colorlet{tagline}{PastelRed} \colorlet{heading}{DarkPastelRed} \colorlet{headingrule}{GoldenEarth} \colorlet{subheading}{PastelRed} \colorlet{accent}{PastelRed} \colorlet{emphasis}{SlateGrey} \colorlet{body}{LightGrey}
% Change some fonts, if necessary \renewcommand{\namefont}{\Huge\rmfamily\bfseries} \renewcommand{\personalinfofont}{\footnotesize} \renewcommand{\cvsectionfont}{\LARGE\rmfamily\bfseries} \renewcommand{\cvsubsectionfont}{\large\bfseries}
% Change the bullets for itemize and rating marker % for \cvskill if you want to \renewcommand{\itemmarker}{{\small\textbullet}} \renewcommand{\ratingmarker}{\faCircle} "
("\\cvsection{%s}" . "\\cvsection*{%s}")));; #+END_SRC
I have had to comment the begin/end source blocks so remember to uncomment them! I run the source block with =Ctrl-c Ctrl-c= when I want to work on my CV. It only needs to be done once for each Emacs session.
The =altacv= LaTeX class is now added to the list of templates. I've named the class =altacv= so the LaTeX class is used by adding the following line to the org file:
*** Export Org-Mode Headings as Macros The [[https://www.overleaf.com/latex/templates/altacv-template/trgqjpwnmtgv][AltaCV LaTeX template]] defines a macro for a cv section so I set org headings to be exported as a =cvsection= (in the previous source block) with the following,
("\cvsection{%s}" . "\cvsection*{%s}")))
Now any =org-mode= heading, e.g.
*Experience
will be exported to LaTeX as:
\cvsection{Experience}
*** LaTeX Packages Whilst I was on a roll with emacs-lisp source blocks I decided to import the LaTeX packages via the exporter. I did this by setting them in the latex exporter's =org-latex-default-packages-alist= variable with:
;; #+BEGIN_SRC emacs-lisp :exports none :results none :eval always (setq org-latex-packages-alist 'nil) (setq org-latex-default-packages-alist '(("rm" "roboto" t) ("defaultsans" "lato" t) ("" "paracol" t) )) ;; #+END_SRC
Again, I had to comment the begin/end source blocks so remember to uncomment them! I run the source block with =Ctrl-c Ctrl-c= when I want to work on my CV. It only needs to be done once for each Emacs session.
The packages we need will now be added by the latex exporter.
*** Org Export Settings I configure my name and the export file name by adding the following lines to the =Config= tree:
I also ensure the exporter does not generate a table of contents (toc), doesn't export a title and sets the number of headline levels to export to 1:
*** LaTeX Preamble I add the bibliography file containing my publications with the following
[[https://www.overleaf.com/latex/templates/altacv-template/trgqjpwnmtgv][The AltaCV LaTeX template]] splits the content into two columns using =\columnratio= so I also add the following latex header:
I put all of this configuration in the =Config= tree in my Org file.
*** Macros The [[https://www.overleaf.com/latex/templates/altacv-template/trgqjpwnmtgv][AltaCV LaTeX template]] defines four macros that I wanted to use. These are for formatting the =cvevent=, =cvachievement=, =cvtag= and =divider= (horizontal dashed line). I convert the LaTeX macros to [[https://orgmode.org/manual/Macro-Replacement.html][org-mode macros]] by adding the following lines:
An org-mode macro can be used with three curly braces, the macro name and comma separated arguments, e.g:
{{{cvevent(PhD Researcher, University of Bristol,Sept 2018 -- Ongoing, Bristol\, UK)}}}
This macro has 4 arguments and the comma in the location =Bristol, UK= has been escaped using a backslash.
**** cvevent I use the =cvevent= macro to format the title/organisation/date/location of each entry of my work experience, projects, volunteering and education. For example:
{{{cvevent(PhD Researcher, University of Bristol,Sept 2018 -- Ongoing, Bristol\, UK)}}}
**** cvtag I use the =cvtag= macro to add nicely formatted tags at the bottom of each experience/project etc. For example:
{{{cvtag(Probabilistic modelling)}}} {{{cvtag(Gaussian processes)}}} {{{cvtag(Variational inference)}}}
**** cvachievement I use the =cvachievement= macro to add each achievement, for example:
{{{cvachievement(\faTrophy, Full Sporting Colours, Awarded full colours for outstanding achievements in snowboarding.)}}}
**** divider I use the =divider= macro to insert a horizontal dashed line between separate entries, for example:
{{{cvachievement(\faTrophy, Full Sporting Colours, Awarded full colours for outstanding achievements in snowboarding.)}}}
{{{divider}}}
{{{cvachievement(\faCertificate, Starting To Teach, Acquired the knowledge and skills to establish myself as a confident\, enthusiastic and effective teacher who is able to engage\, encourage and develop students' learning.)}}}
Woop, that is all our configuring done! ** Content I use LaTeX export blocks to configure parts of the [[https://www.overleaf.com/latex/templates/altacv-template/trgqjpwnmtgv][AltaCV LaTeX template]] that I will only be using once, in particular, the CV header. *** Photo & Tagline I set my name, tag line and photo with the following LaTeX export block.
#+begin_export latex
\name{Aidan Scannell}
\photoR{2.8cm}{aidan_portrait.jpeg}
\tagline{PhD Researcher}
#+end_export*** Personal Info I configure my personal info and links with the following LaTeX export block.
#+begin_export latex
\personalinfo{%
\homepage{www.aidanscannell.com}
\email{scannell.aidan@gmail.com}
\phone{+44 787 558 3912}
\location{Bristol, UK}
\github{aidanscannell}
\linkedin{aidan-scannell-82522789/}
}
\makecvheader
#+end_export*** Publications In the publications section I use the following source block to format the publications in my bib file:
\nocite{} \printbibliography[heading=pubtype,title={\printinfo{\faBook}{Books}},type=book] \divider \printbibliography[heading=pubtype,title={\printinfo{\faFile[regular]}{Journal Articles}},type=article] \divider \printbibliography[heading=pubtype,title={\printinfo{\faUsers}{Conference Proceedings}},type=inproceedings]
** Conclusion I have tried to show how any LaTeX template can easily be set up in org-mode in order to reap the benefits of noexport/ignore tags, tree/sub-tree folding, running source code etc. I covered the majority of the configuration and showed how each part can be used to write content. Of particular importance are the LaTeX macros as they govern the majority of the pretty formatting. I showed how to convert LaTeX macros into org-mode macros and then how to use them. Check out my [[https://github.com/aidanscannell/my-org-resume][CV org file]] to see everything put together (and any topics I forgot to mention).
I am really happy with how easy it was to take a LaTeX template and set it up in Org-mode. I already think that managing this Org-mode CV is going to be much easier than my previous JSON Resume/HackMyResume workflow. You can see my CV [[https://github.com/aidanscannell/my-org-resume][source files here]] and a pdf generated from the source files [[./resume.pdf][here]].