%% moderncv_userguide.tex as shipped with 2021/01/21 v2.1.0 modern curriculum vitae and letter document class (moderncv) % 2021 David Seus, cryptointerest@posteo.de % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License version 1.3c, % available at http://www.latex-project.org/lppl/. \documentclass[a4paper,11pt]{article} \title{\texttt{moderncv} User Guide\\{\small Package version v2.1.0}} \author{Package by Xavier Danaux \\ \begin{small}Documentation by Cristina Sambo, David Seus \end{small}} \date{\today} %language and encoding options \usepackage[english]{babel} \usepackage{ifxetex,ifluatex} \newif\ifxetexorluatex \ifxetex \xetexorluatextrue \else \ifluatex \xetexorluatextrue \else \xetexorluatexfalse \fi \fi %%%% PDFLaTeX or LUALaTeX/XeLaTeX %%%%%%% \ifxetexorluatex %\usepackage{luatextra} % \usepackage{lualatex-math} \usepackage{shellesc} % fix a bug for lualatex shellescape % \usepackage{unicode-math} % \setmathfont{xits-math.otf} \else %% if pdflatex is used uncomment the following packages. If lualatex is used comment them. \usepackage[utf8]{inputenx} %additions for utf8 \input{ix-utf8enc.dfu} %% if pdflatex is used uncomment above packages. If lualatex is used comment them. \fi \PassOptionsToPackage{T1}{fontenc} % T2A for cyrillics \usepackage[T1]{fontenc} %font options \usepackage{txfonts} \usepackage{marvosym} \usepackage{pifont} %margins, spacing and page layout \PassOptionsToPackage{dvipsnames*,svgnames,table}{xcolor} % \usepackage{geometry} % \geometry{top=2.5cm, bottom=3cm} \setlength{\parindent}{0pt} %(to suppress indentation when starting a new paragraph) \frenchspacing %(to suppress additional space after a full stop) %packages \usepackage{graphicx} \usepackage{xcolor} \usepackage[labelfont=sl,font=small,width=0.9\textwidth]{caption} \usepackage{marvosym} \usepackage{latexsym} \usepackage{url} \usepackage{scrhack} % Fix warnings when using KOMA with listings package \usepackage{xspace} % To get the spacing after macros right \usepackage{mparhack} % To get marginpar right \usepackage{microtype} %**************************************************************************************************** % Setup code listings % **************************************************************************************************** \usepackage{listings} %\lstset{emph={trueIndex,root},emphstyle=\color{BlueViolet}}%\underbar} % for special keywords \lstset{language=[LaTeX]Tex,%C++, morekeywords={PassOptionsToPackage,selectlanguage}, keywordstyle=\color{cvblue},%\bfseries, basicstyle=\small\ttfamily, %identifierstyle=\color{NavyBlue}, commentstyle=\color{gray}\ttfamily, stringstyle=\rmfamily, numbers=none,%left,% numberstyle=\scriptsize,%\tiny stepnumber=5, numbersep=8pt, showstringspaces=false, breaklines=true, %frameround=ftff, %frame=single, belowcaptionskip=.75\baselineskip, % frame=L, emph={cvitem,cventry,cvdoubleentry,cvdoubleitem,moderncvstyle,moderncvcolor,% cvskill,cvskilllegend,cvskillplainlegend,cvskillhead,cvskillentry,nopagenumbers,% name,address,email,link,social,phone,homepage,extrainfo,photo,quote},% emphstyle={\color{cvblue}},% emph={[2]familydefault,sfdefault,rmdefault,inputenc,moderncv,document,bibliographyitemlabel,% addresssymbol,mobilephonesymbol,fixedphonesymbol,faxphonesymbol,emailsymbol,homepagesymbol,linkedinsocialsymbol,% xingsocialsymbol,twittersocialsymbol,githubsocialsymbol,gitlabsocialsymbol,% stackoverflowsocialsymbol,bitbucketsocialsymbol,skypesocialsymbol,orcidsocialsymbol,researchgatesocialsymbol,% researcheridsocialsymbol,telegramsocialsymbol,googlescholarsocialsymbol},% emphstyle={[2]\color{cvblue!60!cvgrey}\bfseries}, } \usepackage{hyperref} \hypersetup{% unicode=true, % draft, % hyperref's draft mode, for printing see below colorlinks=true, linktocpage=true, pdfstartpage=3, pdfstartview=FitV,% % uncomment the following line if you want to have black links (e.g., for printing) %colorlinks=false, linktocpage=false, pdfstartpage=3, pdfstartview=FitV, pdfborder={0 0 0},% breaklinks=true, pageanchor=true,% pdfpagemode=UseNone, % % pdfpagemode=UseOutlines,% plainpages=false, bookmarksnumbered, bookmarksopen=true, bookmarksopenlevel=1,% hypertexnames=true, pdfhighlight=/O,%nesting=true,%frenchlinks,% urlcolor=cvblue, linkcolor=cvblue, citecolor=cvblue, %pagecolor=RoyalBlue,% %urlcolor=Black, linkcolor=Black, citecolor=Black, %pagecolor=Black,% % pdfborder={0 0 1}, % width of pdf link border 0 0 1, 0 0 0 = colorlinks % linkbordercolor=gray!15, % citebordercolor=green!15, } %my commands \definecolor{cvblue}{rgb}{0.22,0.45,0.70} \definecolor{cvgreen}{rgb}{0.35,0.70,0.30} \definecolor{cvred}{rgb}{0.95,0.20,0.20} \definecolor{cvorange}{rgb}{0.95,0.55,0.15} \definecolor{cvgrey}{rgb}{0.75,0.75,0.75} \definecolor{cvburgundy}{rgb}{0.596078,0,0}% burgundy: 139/255 (0.545098) or 152/255 (0.596078) \definecolor{cvgrey}{rgb}{0.55,0.55,0.55} \definecolor{cvpurple}{rgb}{0.50,0.33,0.80}% purple \newcommand{\todo}[1]{\marginpar{\textcolor{red}{[\textbf{TODO:} #1]}}} \newcommand{\todox}[1]{\textcolor{red}{[\textbf{TODO:} #1]}} % macros % \newcommand{\code}[1]{\texttt{#1}} % \newcommand{\Code}[1]{\texttt{#1} } \newcommand{\code}[1]{\lstinline!#1!} \newcommand{\Code}[1]{\lstinline!#1!~} %\lstinline!#1! \newcommand{\moderncv}{\code{moderncv}} \newcommand{\Moderncv}{\Code{moderncv}} \newcommand{\github}{GitHub} \newcommand{\Github}{GitHub~} \newcommand{\ctan}{CTAN} \newcommand{\Ctan}{CTAN~} \newcommand{\cvtemplate}{\code{template.tex}} \newcommand{\Cvtemplate}{\code{template.tex}~} \newcommand{\latex}{\LaTeX} \newcommand{\Latex}{\LaTeX\~} \newcommand{\biblatex}{BibLaTeX} \newcommand{\Biblatex}{BibLaTeX~} \newcommand{\cvdoccolorbox}[1]{{\color{#1}\rule{4ex}{2ex}}} % current Code repository. \newcommand{\moderncvGithub}{\url{https://github.com/moderncv/moderncv}} \newcommand{\moderncvCtan}{\url{https://ctan.org/pkg/moderncv}} %================== % DOCUMENT BEGINNING %================== \begin{document} \maketitle \begin{abstract} \noindent \Moderncv provides a document class for typesetting modern curriculum vit\ae~ and corresponding cover letters for applications in various styles. Five predefined styles are available and each of the styles can be adjusted through options adjusting headings and colors. It is fairly customizable, allowing the user to adjust the look and feel of each style to their liking. \todox{add mention of skill matrix feature once it is accepted} \end{abstract} \tableofcontents \section{Getting started} \subsection{How to read this manual} This manual is organized as follows. The present section contains information on how to get started with the \Moderncv package, i.e. how to install required packages to your system. % % \emph{Note, that it is assumed, that you know how to install \LaTeX\ packages in case some are missing}. % Section \ref{section:moderncvTemplate} provides a step by step guide of the \Moderncv template file and how to work with it. % Section \ref{section:customization} discusses details of the customizations that can be done by the user: The different styles, their options, colors and tips and tricks. % Section \ref{section:implementationDetails} contains information about the packages being used by \moderncv, known problems and possible solutions that have been found. \subsection{Installation instructions} If the \Moderncv package does not ship with your \LaTeX\ distribution, or the installed version is too old, grab the \Moderncv code from \Ctan or \github: \medskip \begin{tabular}{l} \moderncvCtan \\%[.5ex] \moderncvGithub \end{tabular} \paragraph{Note.} Depending on your \LaTeX\ distribution some additional packages might have to be installed. Section \ref{section:implementationDetails:requiredPackages} lists all packages that \Moderncv requires to be installed on your system. \section{The \texttt{moderncv} template step by step.} This section is meant as a quick reference to the \Moderncv package and should contain enough information to get a first working curriculum vit\ae~ typeset. \label{section:moderncvTemplate} The easiest way to get started with \Moderncv is to adjust the template that comes with the package. In case the \Moderncv package is part of your \LaTeX\ distribution, search for the folder \Moderncv on your system containing all files of the package. In this folder, there should be a file called \cvtemplate. In case you downloaded the package from \Github or \Ctan move into the folder of the newly downloaded (and possibly extracted) package to find the file \Cvtemplate there. \paragraph{Note.} If you downloaded \Moderncv from \Github or \Ctan and you move the \Cvtemplate to another folder make sure to adjust the \Code{TEXINPUTS} variable to find the newly downloaded package. Otherwise either the old package version gets used or \LaTeX\ throws an error if there is no other version installed. Test your setup by compiling \Cvtemplate and have a look at the result. \paragraph{Note.} The \Moderncv packages should compile fine with \Code{pdflatex}, \Code{lualatex} and \Code{xelatex}. However, when using \Code{pdflatex} not all icons are available so using either \Code{lualatex} or \Code{xelatex} \emph{is strongly recommended}. \subsection{Basic setup} A document using the \Moderncv document class gets set up as any other document class. We go through the template step by step. \subsubsection*{Configuring document class options} The \Moderncv document class is loaded as per usual, by \begin{lstlisting} \documentclass[]{moderncv} \end{lstlisting} where up to one of each category of the following options \smallskip \begingroup \renewcommand{\arraystretch}{1.1} \begin{tabular}{r@{\hspace{2ex}}p{0.52\textwidth}} {\bfseries \code{paper}:} & \code{a4paper}, \code{a5paper}, \code{b5paper}, \code{letterpaper}, \code{legalpaper}, \code{executivepaper}, \code{landscape} \\ {\bfseries \code{font family:}} & \code{sans}, \code{roman} \\ {\bfseries \code{font size:}} & \code{10pt}, \code{11pt}, \code{12pt} \\ {\bfseries \code{draft/final:}} & \code{draft}, \code{final} \end{tabular} \endgroup \smallskip \noindent can be passed to the document class. By default, the \Moderncv document class uses \code{a4paper}, \code{11pt}, \code{final}. \subsubsection*{Configuring \texttt{moderncv} style and color} Choose a \Moderncv style and color by adjusting the commands \begin{lstlisting} \moderncvstyle{