mirror of
https://github.com/moderncv/moderncv.git
synced 2026-02-06 10:05:19 +01:00
faa35668ab
- Fixes for spelling, wording, grammar, formatting, etc. - Minor refactoring for code consistency
990 lines
42 KiB
TeX
990 lines
42 KiB
TeX
%% moderncv_userguide.tex as shipped with 2022/02/21 v2.3.1 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 v2.3.1}%
|
|
}
|
|
% Cristina Sambo,
|
|
\author{%
|
|
Package by Xavier Danaux\\
|
|
{\small Documentation by David Seus}%
|
|
}
|
|
\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 Cyrillic
|
|
\usepackage[T1]{fontenc}
|
|
|
|
% font options
|
|
\usepackage{txfonts}
|
|
\usepackage{marvosym}
|
|
\usepackage{pifont}
|
|
|
|
% margins, spacing and page layout
|
|
\usepackage[pdftex, colorlinks=true]{hyperref} % hyperref must be loaded before geometry
|
|
\usepackage[pdftex, marginparwidth=50pt]{geometry}
|
|
\geometry{top=2.5cm, bottom=3cm}
|
|
\usepackage{parskip} % replace paragraph indentation with vertical spacing
|
|
\frenchspacing % to suppress additional space after a full stop
|
|
\renewcommand{\arraystretch}{1.1}
|
|
|
|
% 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}
|
|
\usepackage{multicol} % Multicolumn text for long lists
|
|
% ****************************************************************************************************
|
|
% 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=0.75\baselineskip,
|
|
% frame=L,
|
|
emph={
|
|
cvitem, cventry, cvdoubleentry, cvdoubleitem, cvlistitem, cvlistdoubleitem, cvcolumns, moderncvstyle, moderncvcolor,
|
|
cvskill, cvskilllegend, cvskillplainlegend, cvskillhead, cvskillentry, nopagenumbers,
|
|
name, born, address, email, link, social, phone, homepage, extrainfo, photo, quote, section, subsection, setlength, NewDocumentCommand, definecolor, colorlet, cvitemwithcomment
|
|
},
|
|
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, whatsappsocialsymbol, signalsocialsymbol, matrixsocialsymbol, googlescholarsocialsymbol, cvstretchability, bornsymbol
|
|
},
|
|
emphstyle={[2]\color{cvblue!60!cvgrey}\bfseries},
|
|
literate={{é}{{\'e}}1},
|
|
}
|
|
|
|
\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
|
|
% automatically read known bugs file. works only for single lined entries
|
|
% \newread\myread% Get a file handle grip called \myread
|
|
% \newcommand{\loaditemsfromfile}[2][enumerate]{%
|
|
% % \DeclareDocumentCommand\multiLineRead{}{}
|
|
% \IfFileExists{#2}{%
|
|
% \openin\myread=#2
|
|
% % \begingroup\endlinechar=-1
|
|
% \def\matchmarco{\par}
|
|
% \begin{#1} % Use an itemize enviroment with #1 as name of the env.
|
|
% \def\multiLineRead{}
|
|
% \loop\unless\ifeof\myread%
|
|
% % \renewcommand{\multiLineRead}{}
|
|
% \read\myread to \localvariable
|
|
% \loop\unless\ifx\localvariable\matchmacro\fi% infinite loop
|
|
% \ifeof\myread
|
|
% \else
|
|
% \ifx\localvariable\matchmacro\relax
|
|
% \def\multiLineRead{}
|
|
% \else
|
|
% \edef\multiLineRead{\multiLineRead, Test} % \localvariable
|
|
% \item \multiLineRead
|
|
% \fi
|
|
% \fi
|
|
% \repeat
|
|
% \repeat
|
|
% \end{#1} % close the environment
|
|
% % \endgroup
|
|
% \closein\myread% \close the file
|
|
% }{}%
|
|
% }
|
|
% consider using datatool
|
|
% https://packages.oth-regensburg.de/ctan/macros/latex/contrib/datatool/datatool-user.pdf
|
|
% \makeatletter
|
|
% \newread\myread
|
|
% \newcommand{\loaditemsfromfile}[2][enumerate]{%
|
|
% % \DeclareDocumentCommand\multiLineRead{}{}
|
|
% \IfFileExists{#2}{%
|
|
% \def\linetomatch{\endlinechar}% \edef is not required
|
|
% \openin\myread=#2
|
|
% \begingroup\endlinechar=-1
|
|
% \begin{#1} % Use an itemize enviroment with #1 as name of the env.
|
|
% \item Test
|
|
% \@whilesw\unless\ifeof\myread\fi{%
|
|
% \read\myread to \dataline
|
|
% \noindent"\linetomatch"
|
|
% \ifx\dataline\linetomatch\relax
|
|
% \item equals
|
|
% \else
|
|
% \item does not equal "\dataline"
|
|
% \fi
|
|
% }%
|
|
% \end{#1}%
|
|
% \endgroup
|
|
% \closein\myread
|
|
% }{}%
|
|
% }%
|
|
% \makeatother
|
|
|
|
\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}
|
|
|
|
% macros
|
|
\newcommand{\todo}[1]{\marginpar{\raggedright \textcolor{red}{[\textbf{TODO:} #1]}}}
|
|
\newcommand{\todox}[1]{\textcolor{red}{[\textbf{TODO:} #1]}}
|
|
\newcommand{\code}[1]{\lstinline!#1!}
|
|
\newcommand{\moderncv}{\code{moderncv}}
|
|
\newcommand{\Moderncv}{\moderncv~}
|
|
\newcommand{\github}{GitHub}
|
|
\newcommand{\Github}{\github~}
|
|
\newcommand{\ctan}{CTAN}
|
|
\newcommand{\Ctan}{\ctan~}
|
|
\newcommand{\cvtemplate}{\code{template.tex}}
|
|
\newcommand{\Cvtemplate}{\cvtemplate~}
|
|
\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
|
|
The \Moderncv package provides a document class for typesetting modern curriculum vit\ae{} and cover letters in various styles.
|
|
Five predefined styles are available, each of which can be adjusted through various options for headings, footers and colors.
|
|
It is fairly customizable, allowing the user to adjust the look and feel of each style to their liking.
|
|
Several macros allow the user to add content to the CV and format it in a consistent way.
|
|
A letter of motivation consistent with the style is part of the template as well.
|
|
\end{abstract}
|
|
\tableofcontents
|
|
|
|
|
|
|
|
\section{Getting started}
|
|
\subsection{How to read this manual}
|
|
This manual is organized as follows.
|
|
The current section explains on how to get started with the \Moderncv package, i.e. how to install required packages.
|
|
% \emph{Note that it is assumed that you know how to install \Latex packages in case some are missing.}
|
|
Section \ref{section:moderncvTemplate} explains how to work with the \Moderncv template file step by step.
|
|
Section \ref{section:customization} details the customizations that the user can make: the different styles, their options, colors and tips and tricks.
|
|
Section \ref{section:implementationDetails} details the packages that \Moderncv uses, known problems and possible solutions to those problems.
|
|
|
|
\subsection{Installation instructions}
|
|
If the \Moderncv package does not ship with your \Latex distribution or if the installed version is too old, grab the \Moderncv code from \Ctan or \github:
|
|
|
|
\begin{tabular}{l}
|
|
\moderncvCtan \\% [.5ex]
|
|
\moderncvGithub
|
|
\end{tabular}
|
|
|
|
\paragraph{Note.}
|
|
Depending on your \Latex distribution, you may have to install some additional packages.
|
|
Section \ref{section:implementationDetails:requiredPackages} lists all the packages that \Moderncv requires to be installed on your system.
|
|
|
|
|
|
|
|
\section{The \texttt{moderncv} template step by step}
|
|
This section is meant to be a quick reference to the \Moderncv package and should contain enough information to get a first working CV typeset.
|
|
\label{section:moderncvTemplate}
|
|
The easiest way to get started with \Moderncv is to adjust the template that comes with the package.
|
|
If 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.
|
|
If you downloaded the package from \Github or \Ctan, go to 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 moved \Cvtemplate to another folder, make sure to adjust the \code{TEXINPUTS} variable to find the newly downloaded package.
|
|
Otherwise, either the package version provided by your \Latex distribution gets used or \Latex throws an error if there is no other version installed.
|
|
|
|
Test your setup by compiling \Cvtemplate and looking at the result.
|
|
|
|
\paragraph{Note.} The \Moderncv package should compile with \code{pdflatex}, \code{lualatex} and \code{xelatex}.
|
|
However, not all icons are available when using \code{pdflatex}, so using either \code{lualatex} or \code{xelatex} \emph{is highly recommended.}
|
|
|
|
\subsection{Basic setup}
|
|
A document using the \Moderncv document class gets set up as any other document class.
|
|
We will 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[<options>]{moderncv}
|
|
\end{lstlisting}
|
|
where at most one value for each option can be passed to the document class:
|
|
|
|
\begin{tabular}{r@{\hspace{2ex}}p{0.45\textwidth}}
|
|
\textbf{\code{paper}:} & \code{a4paper}, \code{a5paper}, \code{b5paper}, \code{letterpaper},
|
|
\code{legalpaper}, \code{executivepaper}, \code{landscape} \\
|
|
\textbf{\code{font family}:} & \code{sans}, \code{roman} \\
|
|
\textbf{\code{font size}:} & \code{10pt}, \code{11pt}, \code{12pt} \\
|
|
\textbf{\code{draft/final}:} & \code{draft}, \code{final}
|
|
\end{tabular}
|
|
|
|
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{<style>}
|
|
\moderncvcolor{<color>}
|
|
\end{lstlisting}
|
|
As explained in \cvtemplate, the possible values are
|
|
|
|
\begin{tabular}{r@{\hspace{2ex}}p{0.65\textwidth}}
|
|
\textbf{\code{style}:} & \code{casual} (default), \code{classic}, \code{banking}, \code{oldstyle},
|
|
\code{fancy} \\
|
|
\textbf{\code{color}:} & \code{black} \cvdoccolorbox{black}, \code{blue} \cvdoccolorbox{cvblue} (default), \code{burgundy} \cvdoccolorbox{cvburgundy}, \code{green} \cvdoccolorbox{cvgreen}, \code{grey} \cvdoccolorbox{cvgrey}, \code{orange} \cvdoccolorbox{cvorange}, \code{purple} \cvdoccolorbox{cvpurple}, \code{red} \cvdoccolorbox{cvred}
|
|
\end{tabular}
|
|
|
|
\paragraph{Note.} Some of the styles take additional options to fine-tune their appearance.
|
|
To keep this overview short, the description of these options is postponed to section \ref{section:customization:stylesAndOptions}.
|
|
|
|
\subsubsection*{Font family and page numbering}
|
|
The default font family is set by the line \code{\\renewcommand\{\\familydefault\}\{\\sfdefault\}} in \cvtemplate.
|
|
Use \code{\\sfdefault} for the default sans-serif font, \code{\\rmdefault} for the default roman font, and likewise for any \TeX{} font name.
|
|
The general syntax is
|
|
\begin{lstlisting}
|
|
\renewcommand{\familydefault}{<fontfamily>}
|
|
% \nopagenumbers{}
|
|
\end{lstlisting}
|
|
Uncommenting \code{\%\\nopagenumbers\{\}} suppresses automatic page numbering for CVs longer than one page.
|
|
|
|
\subsubsection*{Adjusting input encoding}
|
|
If you are not using \code{xelatex} or \code{lualatex}, which both use \code{utf8} encoding by default, uncomment \code{\\usepackage[utf8]\{inputenc\}} and change the encoding as needed.
|
|
\begin{lstlisting}
|
|
% \usepackage[utf8]{inputenc}
|
|
% \usepackage{CJKutf8} % for CVs in Chinese, Japanese or Korean
|
|
\end{lstlisting}
|
|
|
|
\subsubsection{Language-specific setup}
|
|
The \code{babel} package can be loaded in the preamble of your CV.
|
|
|
|
\subsection{Personal data}
|
|
Edit the personal data section to reflect your personal information.
|
|
This data will be inserted in the header of the first page of the CV and/or in the footer of every page.
|
|
This data will also appear on the cover letter.
|
|
The default template settings are
|
|
\begin{lstlisting}
|
|
\name{John}{Doe}
|
|
\title{Résumé title}
|
|
\born{4 July 1776}
|
|
\address{street and number}{postcode city}{country}
|
|
\phone[mobile]{+1~(234)~567~890}
|
|
\phone[fixed]{+2~(345)~678~901}
|
|
\phone[fax]{+3~(456)~789~012}
|
|
\email{john@doe.org}
|
|
\homepage{www.johndoe.com}
|
|
|
|
\social[linkedin]{john.doe}
|
|
\social[xing]{john\_doe}
|
|
\social[github]{jdoe}
|
|
\social[gitlab]{jdoe}
|
|
\social[codeberg]{jdoe}
|
|
\social[bitbucket]{jdoe}
|
|
\social[stackoverflow]{0000000/johndoe}
|
|
\social[skype]{jdoe}
|
|
\social[orcid]{0000-0000-000-000}
|
|
\social[researchgate]{jdoe}
|
|
\social[researcherid]{jdoe}
|
|
\social[googlescholar]{googlescholarid}
|
|
\social[twitter]{ji\_doe}
|
|
\social[mastodon]{mastodon.social/web/@user}
|
|
\social[telegram]{jdoe}
|
|
\social[whatsapp]{12345678901}
|
|
\social[signal]{12345678901}
|
|
\social[matrix]{@johndoe:matrix.org}
|
|
\social[discord]{jdoe\#0000}
|
|
\social[youtube]{c/jdoeschannel}
|
|
\social[youtube]{channel/XXXXXX}
|
|
\social[youtube]{user/jdoe}
|
|
\social[twitch]{jdoe}
|
|
\social[tiktok]{jdoe}
|
|
\social[instagram]{jdoe}
|
|
\social[soundcloud]{jdoe}
|
|
\social[steam]{jdoe}
|
|
\social[xbox]{jdoe}
|
|
\social[playstation]{jdoe}
|
|
\social[battlenet]{jdoe\#0000}
|
|
|
|
\extrainfo{additional information}
|
|
\photo[64pt][0.4pt]{picture}
|
|
\quote{Some quote}
|
|
\end{lstlisting}
|
|
\todo{explain adding pictures}
|
|
Most of these commands are optional and can be commented out if they are not needed.
|
|
The commands are pretty self-explanatory.
|
|
Try out what you like and see what you need.
|
|
|
|
\todox{Add note about how to cope with long names and long URLs. Is this handled correctly?}
|
|
|
|
\todox{explain the second optional argument of \code{\\social} command}
|
|
|
|
\paragraph{Bibliography.}
|
|
In case BibTeX is used, the bibliography settings are adjusted in the lines
|
|
\begin{lstlisting}
|
|
% to show numerical labels in the bibliography (default is to show no labels)
|
|
% \renewcommand*{\bibliographyitemlabel}{[\arabic{enumiv}]}
|
|
% \renewcommand{\refname}{Articles}
|
|
|
|
% bibliography with mutiple entries
|
|
% \usepackage{multibib}
|
|
% \newcites{book, misc}{{Books}, {Others}}
|
|
\end{lstlisting}
|
|
By default, no labels are shown for bibliography entries.
|
|
Uncommenting the line \code{\%\\renewcommand*\{\\bibliographyitemlabel\}\{[\\arabic\{enumiv\}]\}}
|
|
allows one to fine-tune the labels.
|
|
Uncommenting the line \code{\%\\renewcommand\{\\refname\}\{Articles\}} allows one to redefine the bibliography heading string ``Publications'' that is shown by default.
|
|
Finally, adjustments using the \code{multibib} package can be done in the last two lines shown here.
|
|
|
|
\paragraph{Note.} \Biblatex is currently not supported.
|
|
|
|
\subsection{Modifying CV content}
|
|
\subsubsection{Structuring the CV}
|
|
As with any other document style, the CV can be structured into sections and subsections using \code{\\section} and \code{\\subsection}.
|
|
|
|
\subsubsection{\texttt{moderncv} macros}
|
|
|
|
The \Moderncv package provides several macros to add content to your CV.
|
|
The easiest way to understand their intended use is to have a look at how they are used in the template.
|
|
Nonetheless, we list the macros here along with a short description of their intended use.
|
|
|
|
\paragraph{\code{\\cvitem}.}
|
|
Simple entry taking two arguments, a descriptor and a body.
|
|
Flexible command that can be used to list job experiences and similar.
|
|
Usage:
|
|
\begin{lstlisting}
|
|
\cvitem{<descriptor>}{<body>}
|
|
\end{lstlisting}
|
|
|
|
\paragraph{\code{\\cvdoubleitem}.}
|
|
Two-column version of \code{\\cvitem}.
|
|
Takes four arguments.
|
|
It is intended to enter skills such as computer skills or language skills in a two-column fashion.
|
|
Usage:
|
|
\begin{lstlisting}
|
|
\cvdoubleitem{<category_1>}{<descriptor_1>}{<category_2>}{<descriptor_2>}
|
|
\end{lstlisting}
|
|
|
|
\paragraph{\code{\\cvitemwithcomment}.}
|
|
Extends \code{\\cvitem} with an additional argument for a comment.
|
|
It is intended to enter skills such as computer skills or language skills.
|
|
Usage:
|
|
\begin{lstlisting}
|
|
\cvitemwithcomment{<descriptor>}{<skill_level>}{<comment>}
|
|
\end{lstlisting}
|
|
|
|
\paragraph{\code{\\cventry}.}
|
|
Command taking six arguments intended to enter education or job experience.
|
|
Arguments 3 to 6 can be left empty.
|
|
In case longer descriptions in argument 6 are not broken properly, a minipage can be used.
|
|
Alternatively, \code{\\newline\{\}} can be used to break lines.
|
|
Usage:
|
|
\begin{lstlisting}
|
|
\cventry{<year--year>}{<degree>}{<institution>}{<city>}{<grade>}{<description>}
|
|
\cventry{<year--year>}{<job_title>}{<employer>}{<city>}{}{<line_1>\newline{}<line_2>}
|
|
\end{lstlisting}
|
|
|
|
\paragraph{\code{\\cvlistitem}.}
|
|
Command taking one argument intended to enter a bullet list item.
|
|
Very long lines get broken.
|
|
Usage:
|
|
\begin{lstlisting}
|
|
\cvlistitem{<item>}
|
|
\end{lstlisting}
|
|
|
|
\paragraph{\code{\\cvlistdoubleitem}.}
|
|
Command taking two argument intended typeset a bullet list in two columns.
|
|
Usage:
|
|
\begin{lstlisting}
|
|
\cvlistdoubleitem{<item_1>}{item_2>}
|
|
\end{lstlisting}
|
|
|
|
\paragraph{\code{\\cvcolumns}.}
|
|
Environment to typeset multicolumn \code{\\cvitem}s.
|
|
This can be combined with the \code{itemize} environment.
|
|
The multicolumn environment is added with
|
|
\begin{lstlisting}
|
|
\begin{cvcolumns}
|
|
\end{cvcolumns}
|
|
\end{lstlisting}
|
|
Each column can be added with the \code{\\cvcolumn[<width>]\{<content>\}} command, where \code{<width>} is a number between 0 and 1 controling the width of the column.
|
|
Usage:
|
|
\begin{lstlisting}
|
|
\begin{cvcolumns}
|
|
\cvcolumn{<category_1>}{<content>}
|
|
\cvcolumn{<category_2>}{<content>}
|
|
\cvcolumn[0.5]{<content>}
|
|
\end{cvcolumns}
|
|
\end{lstlisting}
|
|
|
|
\paragraph{Skill matrix.}
|
|
The skill matrix is a table intended to display skills such as computer skills or project management skills graphically on a scale of 1 to 5.
|
|
The skill matrix table consists of several elements:
|
|
\begin{itemize}
|
|
\item the graphical representation of the skill on a scale from 1 to 5,
|
|
\item the legend to explain the meaning of the scale,
|
|
\item a header line to explain the meaning of the table columns and
|
|
\item the actual skill entries.
|
|
\end{itemize}
|
|
|
|
\paragraph{Skill representation.}
|
|
The graphical representation of skill can be entered with the command
|
|
\begin{lstlisting}
|
|
\cvskill{<1-5>}
|
|
\end{lstlisting}
|
|
It can be used outside of the skill matrix, too.
|
|
|
|
\paragraph{Legend.}
|
|
The standard legend can be created by the command \code{\\cvskilllegend}:
|
|
\begin{lstlisting}
|
|
\cvskilllegend
|
|
\cvskilllegend*[<post_padding>]{<descriptor>}
|
|
\end{lstlisting}
|
|
\code{\\cvskilllegend} with no arguments inserts the legend with no descriptor in its standard form without any lines.
|
|
The asterisk toggles the inclusion of a dashed line.
|
|
The optional argument \code{<post_padding>} allows one to adjust the post-padding of the legend.
|
|
\code{<post_padding>} needs to be a valid length like \code{1em} or \code{1ex}.
|
|
|
|
The most general form of the skill legend command can be used to translate the legend descriptions into other languages as well as add a name descriptor:
|
|
\begin{lstlisting}
|
|
\cvskilllegend[*][<post_padding>][<first_level>][<second_level>][<third_level>][<fourth_level>][<fifth_level>]{<name>}
|
|
% example: German translation
|
|
\cvskillplainlegend[0.2em][Grundkenntnisse][Grundkenntnisse und eigene Erfahrung in Projekten][Umfangreiche Erfahrung in Projekten][Vertiefte Expertenkenntnisse][Experte/Guru]{Legende}
|
|
\end{lstlisting}
|
|
An alternative legend style with the first three skill levels in one column is provided by
|
|
\begin{lstlisting}
|
|
\cvskillplainlegend[*][<post_padding>][<first_level>][<second_level>][<third_level>][<fourth_level>][<fifth_level>]{<name>}
|
|
\end{lstlisting}
|
|
|
|
\paragraph{Header line.}
|
|
The command \code{\\cvskillhead} adds a header line:
|
|
\begin{lstlisting}
|
|
\cvskillhead[-0.1em] % standard legend in english, adjust padding
|
|
% example german translation
|
|
\cvskillhead[0.25em][Level][F\"ahigkeit][Jahre][Bemerkung]
|
|
% general form
|
|
\cvskillhead[<post_padding>][<Level>][<Skill>][<Years>][<Comment>]
|
|
\end{lstlisting}
|
|
|
|
\paragraph{Skill matrix entry.}
|
|
The command \code{\\cvskillentry} adds a skill matrix entry:
|
|
\begin{lstlisting}
|
|
% general form
|
|
\cvskillentry[*][<post_padding>]{<skill_cathegory>}{<0-5>}{<skill_name>}{<years_of_experience>}{<comment>}
|
|
% Example usages:
|
|
\cvskillentry*{Language:}{3}{Python}{2}{I'm so experienced in Python and have realised a million projects. At least.}
|
|
\cvskillentry{}{2}{Lilypond}{14}{So much sheet music! Man, I'm the best!}
|
|
\end{lstlisting}
|
|
The asterisk toggles the inclusion of a dashed line.
|
|
Some length adjustments can be made to the skill matrix and how to do so will be explained in section \ref{section:length:skillmatrix}.
|
|
|
|
\subsection{Letter of motivation}
|
|
|
|
\todo{add short explanation of motivation letter.}
|
|
To add a subject to the letter of motivation or to close with your signature, see sections \ref{section:add:subject} and \ref{section:add:signature}, respectively.
|
|
|
|
|
|
|
|
\section{Customization}
|
|
\label{section:customization}
|
|
\subsection{Styles and their options}
|
|
\label{section:customization:stylesAndOptions}
|
|
Each style allows fine-tuning through passing options to the \code{\\moderncvstyle} command.
|
|
The general syntax
|
|
\begin{lstlisting}
|
|
\moderncvstyle[<option1>, <option2>, ...]{<style>}
|
|
\end{lstlisting}
|
|
for passing options follows the usual \Latex scheme.
|
|
Each style defines their own options, and not all options are available for each style.
|
|
Below is a list of all the options available:
|
|
|
|
\paragraph{\code{casual}.}
|
|
This style allows the following options which \emph{only} affect header and footer styles:
|
|
|
|
\begin{tabular}{r@{\hspace{2ex}}p{0.72\textwidth}}
|
|
\textbf{\code{head alignment}:} & values: \code{left}, \code{right} (default).
|
|
Sets the alignment of the title and the picture if one is included. \\
|
|
\textbf{\code{name}:} & values: \code{alternate}.
|
|
Displays the name in all lowercase.
|
|
Differentiation of the name is done by color (disabled by default).
|
|
This feature is discouraged for longer names. \\
|
|
\textbf{\code{data in head}:} & values: \code{details}, \code{nodetails} (default).
|
|
Toggles between the header and footer as the location of personal data on the page. \\
|
|
\textbf{\code{symbols}:} & values: \code{symbols} (default), \code{nosymbols}.
|
|
Toggles between inclusion of icons or text-based abbreviations for personal data.
|
|
\end{tabular}
|
|
|
|
\paragraph{\code{classic}.}
|
|
This style allows the following options which \emph{only} affect header and footer styles:
|
|
|
|
\begin{tabular}{r@{\hspace{2ex}}p{0.75\textwidth}}
|
|
\textbf{\code{alignment}:} & values: \code{left} (default), \code{right}.
|
|
Sets the alignment of the address block and the picture. \\
|
|
\textbf{\code{data in head}:} & values: \code{details}, \code{nodetails} (default).
|
|
Toggles between the header and footer as the location of personal data on the page. \\
|
|
\textbf{\code{symbols}:} & values: \code{symbols} (default), \code{nosymbols}.
|
|
Toggles between inclusion of icons or text-based abbreviations for personal data.
|
|
\end{tabular}
|
|
|
|
\paragraph{\code{banking}.}
|
|
This style allows the following options:
|
|
|
|
\begin{tabular}{r@{\hspace{2ex}}p{0.68\textwidth}}
|
|
\textbf{\code{alignment (body)}:} & values: \code{left} (default), \code{center}, \code{right}.
|
|
Sets the alignment of the entries in the style. \\
|
|
\textbf{\code{rule style}:} & values: \code{fullrules}, \code{shortrules}, \code{mixedrules} (default), \code{norules}.
|
|
Adjusts the rules used in the style. \\
|
|
\textbf{\code{data in head}:} & values: \code{details}, \code{nodetails} (default).
|
|
Toggles between the header and footer as the location of personal data on the page. \\
|
|
\textbf{\code{symbols}:} & values: \code{symbols} (default), \code{nosymbols}.
|
|
Toggles between inclusion of icons or text-based abbreviations for personal data.
|
|
\end{tabular}
|
|
|
|
\paragraph{\code{oldstyle}.}
|
|
This style allows the following options:
|
|
|
|
\begin{tabular}{r@{\hspace{2ex}}p{0.73\textwidth}}
|
|
\textbf{\code{data in head}:} & values: \code{details}, \code{nodetails} (default).
|
|
Toggles between the header and footer as the location of personal data on the page. \\
|
|
\textbf{\code{symbols}:} & values: \code{symbols} (default), \code{nosymbols}.
|
|
Toggles between inclusion of icons or text-based abbreviations for personal data.
|
|
\end{tabular}
|
|
|
|
\paragraph{\code{fancy}.}
|
|
This style allows the following options:
|
|
|
|
\begin{tabular}{r@{\hspace{2ex}}p{0.73\textwidth}}
|
|
\textbf{\code{data in head}:} & values: \code{details}, \code{nodetails} (default).
|
|
Toggles between the header and footer as the location of personal data on the page. \\
|
|
\textbf{\code{symbols}:} & values: \code{symbols} (default), \code{nosymbols}.
|
|
Toggles between inclusion of icons or text-based abbreviations for personal data.
|
|
\end{tabular}
|
|
|
|
\paragraph{Note.}
|
|
Only one option from each option category can be passed in at a time, e.g.
|
|
\begin{lstlisting}
|
|
\moderncvstyle[left, nosymbols]{casual}
|
|
\end{lstlisting}
|
|
|
|
|
|
\subsection{Adjusting colors}
|
|
The colors of each style can be adjusted.
|
|
|
|
\paragraph{Note.}
|
|
The color theme must be loaded \emph{before} \code{\\moderncvstyle}, i.e.
|
|
\begin{lstlisting}
|
|
\moderncvcolor{blue}
|
|
\moderncvstyle{casual}
|
|
\end{lstlisting}
|
|
|
|
\paragraph{Base colors.}
|
|
Each style defines three main colors: \code{color0}, \code{color1} and \code{color2}.
|
|
\code{color0} is black and the main text color.
|
|
\code{color1} is the main theme color, like blue, green, etc.
|
|
\code{color2} is a some form of grey used for the user data, etc.
|
|
These colors can be redefined by using, e.g.
|
|
\begin{lstlisting}
|
|
\definecolor{color1}{rgb}{0.55, 0.55, 0.55} % dark grey
|
|
\colorlet{color1}{black}
|
|
\end{lstlisting}
|
|
Any mechanism for naming and defining colors used by the \code{xcolor} package can be used to redefine the colors of a \Moderncv style.
|
|
|
|
\paragraph{Fine tuning.}
|
|
If an even finer control over the color scheme of the style is desired, the following colors are being used internally and can be redefined at will:
|
|
|
|
\paragraph{casual}
|
|
\begin{lstlisting}
|
|
% head and footer
|
|
\colorlet{lastnamecolor}{color1}
|
|
\colorlet{namecolor}{lastnamecolor}
|
|
\colorlet{headrulecolor}{color1}
|
|
\colorlet{firstnamecolor}{lastnamecolor!50}
|
|
\colorlet{titlecolor}{color2}
|
|
\colorlet{addresscolor}{color2}
|
|
\colorlet{quotecolor}{color1}
|
|
\colorlet{pictureframecolor}{color1}
|
|
% body
|
|
\colorlet{bodyrulecolor}{color1}
|
|
\colorlet{sectioncolor}{color1}
|
|
\colorlet{subsectioncolor}{color1}
|
|
\colorlet{hintstylecolor}{color0}
|
|
% letter
|
|
\colorlet{letterclosingcolor}{color2}
|
|
% skill matrix
|
|
\colorlet{skillmatrixfullcolor}{color1}
|
|
\colorlet{skillmatrixemptycolor}{color2!30}
|
|
\end{lstlisting}
|
|
|
|
|
|
\subsection{Modifying symbols and icons}
|
|
\subsubsection{Icons}
|
|
As stated in section \ref{section:customization:stylesAndOptions}, the use of icons is toggled by the \code{symbols} option that can be passed to \code{\\moderncvstyle}.
|
|
|
|
The icons used in the display of the personal data (phone numbers, email, fax, social media accounts, etc.) can be customized by redefining the internal commands for the symbols:
|
|
\begin{lstlisting}
|
|
\renewcommand*{<\symbolcommand>}{{\small<\symbol>}~}
|
|
\end{lstlisting}
|
|
Using \code{\\small} is optional, but the default behavior is to render all icons using \code{\\small}.
|
|
Use \code{\\small} if one merely wishes to replace an icon/symbol while keeping the size consistent with the default icons/symbols.
|
|
The tilde ensures proper spacing after the symbols and is recommended as well.
|
|
|
|
Currently \Moderncv supports the following commands as \code{<\\symbolcommand>}:
|
|
\begin{itemize}
|
|
\begin{multicols}{2}
|
|
\item \code{\\addresssymbol}
|
|
\item \code{\\mobilephonesymbol}
|
|
\item \code{\\fixedphonesymbol}
|
|
\item \code{\\faxphonesymbol}
|
|
\item \code{\\emailsymbol}
|
|
\item \code{\\homepagesymbol}
|
|
\item \code{\\linkedinsocialsymbol}
|
|
\item \code{\\xingsocialsymbol}
|
|
\item \code{\\twittersocialsymbol}
|
|
\item \code{\\githubsocialsymbol}
|
|
\item \code{\\gitlabsocialsymbol}
|
|
\item \code{\\stackoverflowsocialsymbol}
|
|
\item \code{\\googlescholarsocialsymbol}
|
|
\item \code{\\telegramsocialsymbol}
|
|
\item \code{\\whatsappsocialsymbol}
|
|
\item \code{\\signalsocialsymbol}
|
|
\item \code{\\matrixsocialsymbol}
|
|
\item \code{\\orcidsocialsymbol}
|
|
\item \code{\\researchgatesocialsymbol}
|
|
\item \code{\\researcheridsocialsymbol}
|
|
\item \code{\\bitbucketsocialsymbol}
|
|
\item \code{\\skypesocialsymbol}
|
|
\item \code{\\bornsymbol}
|
|
\end{multicols}
|
|
\end{itemize}
|
|
The possible options for \code{<\\symbol>} depend on the package that is used.
|
|
By default, the \code{marvosym} package is loaded if \code{pdflatex} is used, and the \code{academicons} and \code{fontawesome5} packages are loaded if either \code{lualatex} or \code{xelatex} is used.
|
|
Full lists of all available symbols and icons can be found in the documentation of each respective package:
|
|
|
|
\begin{tabular}{l}
|
|
\url{https://ctan.org/pkg/marvosym} \\[1ex]
|
|
\url{https://ctan.org/pkg/fontawesome5} \\[1ex]
|
|
\url{https://ctan.org/pkg/academicons}
|
|
\end{tabular}
|
|
|
|
\paragraph{Example.}
|
|
If one wanted to use the dingbat fonts to replace the default phone symbol, one should load the \code{pifont} package in the preamble and then substitute the default symbol with the dingbat symbol \ding{38}\ with
|
|
\begin{lstlisting}
|
|
\renewcommand*{\fixedphonesymbol}{\ding{38}~}
|
|
\end{lstlisting}
|
|
|
|
\subsubsection{Listing labels}
|
|
The labels used in \code{itemize} environments, \code{cvlistitem} and \code{cvlistdoubleitem} can be changed in two different ways:
|
|
|
|
\begin{itemize}
|
|
\item Redefining the internal commands \code{\\labelitemi}, \code{\\labelitemii}, \code{\\labelitemiii} and \code{\\labelitemiv} changes the labels for \code{itemize} environments as well as for \code{cvlistitem} and \code{cvlistdoubleitem}, e.g.
|
|
\begin{lstlisting}
|
|
\renewcommand{\labelitemi}{-}
|
|
\end{lstlisting}
|
|
\item Redefining \code{\\listitemsymbol} changes the labels for \code{cvlistitem} and \code{cvlistdoubleitem} but \emph{not} for \code{itemize} environments, e.g.
|
|
\begin{lstlisting}
|
|
\renewcommand{\listitemsymbol}{-}
|
|
\end{lstlisting}
|
|
\end{itemize}
|
|
|
|
\subsection{Adjusting lengths}
|
|
\todo{Add more adjustable lengths}
|
|
Some lengths in \Moderncv can be adjusted.
|
|
|
|
The hints column can be adjusted with
|
|
\begin{lstlisting}
|
|
\setlength{\hintscolumnwidth}{3cm}
|
|
\end{lstlisting}
|
|
|
|
For the \code{classic} style, the width of the space for the name can be adjusted to avoid breaks:
|
|
\begin{lstlisting}
|
|
\setlength{\makecvheadnamewidth}{10cm}
|
|
\end{lstlisting}
|
|
One should be careful though, as the length is normally calculated to avoid any overlap with the personal information.
|
|
This should be used at one's own typographical risk.
|
|
|
|
% The different lengths used by moderncv are customizable by
|
|
% \begin{lstlisting}
|
|
% \setlength{<length>}{<new_dimensions>}
|
|
% \end{lstlisting}
|
|
% where \code{<length>} are \code{quotewidth}, \code{separatorcolumnwidth}, \code{maincolumnwidth}, \code{doubleitemmaincolumnwidth}, \code{listitemsymbolwidth}, \code{listdoubleitemmaincolumnwidth},
|
|
|
|
|
|
\subsubsection{Lengths in the skillmatrix}
|
|
\label{section:length:skillmatrix}
|
|
Both the width of the skill matrix legend and the width of the skill matrix columns can be adjusted.
|
|
|
|
The width of the skill matrix legend can be adjusted as follows:
|
|
\begin{lstlisting}
|
|
\setcvskilllegendcolumns[<width>][<factor>]
|
|
%% Examples:
|
|
\setcvskilllegendcolumns[][0.45]
|
|
\setcvskilllegendcolumns[\widthof{``Legend''}][0.45]
|
|
\setcvskilllegendcolumns[0ex][0.46] % useful for the banking style
|
|
\end{lstlisting}
|
|
\code{<width>} should be a length smaller than \code{\\textwidth}, and \code{<factor>} must be between 0 and 1.
|
|
|
|
The width of the skill matrix columns can be adjusted as follows:
|
|
\begin{lstlisting}
|
|
\setcvskillcolumns[<width>][<factor>][<exp_width>]
|
|
%% Examples:
|
|
\setcvskillcolumns[5em][][] % adjust first column. Same as \setcvskillcolumns[5em]
|
|
\setcvskillcolumns[][0.45][] % adjust third (skill) column. Same as \setcvskillcolumns[][0.45]
|
|
\setcvskillcolumns[][][\widthof{``Year''}] % adjust fourth (years) column.
|
|
\setcvskillcolumns[][0.45][\widthof{``Year''}]
|
|
\setcvskillcolumns[\widthof{``Language''}][0.48][]
|
|
\setcvskillcolumns[\widthof{``Language''}]
|
|
\end{lstlisting}
|
|
\code{<width>} and \code{<exp_width>} should be lengths smaller than \code{\\textwidth}, and \code{<factor>} must be between 0 and 1.
|
|
|
|
\subsection{Page breaks and orphaned section headers}
|
|
If \Latex breaks pages just after \code{\\section} or \code{\\subsection} commands, try adjusting the stretchability of the page with \code{\\cvsectionstretchability} or \code{\\cvsubsectionstretchability}, e.g.
|
|
\begin{lstlisting}
|
|
\setlength{\cvsectionstretchability}{\baselineskip}
|
|
\setlength{\cvsubsectionstretchability}{100pt}
|
|
\end{lstlisting}
|
|
These two lengths tell \Latex how much extra length it needs after \code{\\section} and \code{\\subsection} commands.
|
|
By default, \Moderncv sets both lengths to \code{0.9\\baselineskip}.
|
|
|
|
This should solve orphaned \code{\\section} and \code{\\subsection} commands that are used alone for most users.
|
|
However, \Latex does not check for content.
|
|
For example, writing
|
|
\begin{lstlisting}
|
|
\section{blub}
|
|
\subsection{blubblub}
|
|
\end{lstlisting}
|
|
one after the other may cause \Latex to place the section and subsection headers on separate pages.
|
|
Since \Latex considers the subsection header to not be orphaned, it may place the section header at the bottom of a page if there is enough space to do so while placing the subsection header on the next page.
|
|
One solution is to increase \code{\\cvsectionstretchability} to force the break of the section header.
|
|
However, this changes the behaviour for all \code{\\section} commands in your CV and might cause unnecessary page breaks.
|
|
It is therefore recommended to force the page break manually with a \code{\\newpage} in this case.
|
|
|
|
\paragraph{Experts only:}
|
|
Internally, \Moderncv uses a custom \code{\\needspace} command:
|
|
\begin{lstlisting}
|
|
\NewDocumentCommand\@cvneedspace{m}{%
|
|
\begingroup
|
|
\setlength{\dimen@}{#1}%
|
|
\vskip\z@\@plus\dimen@
|
|
\penalty \withinstretchpenalty\vskip\z@\@plus -\dimen@
|
|
\vskip\dimen@
|
|
\penalty \poststretchpenalty%
|
|
\vskip -\dimen@
|
|
\vskip\z@skip % hide the previous |\vskip| from |\addvspace|
|
|
\endgroup
|
|
}
|
|
\end{lstlisting}
|
|
Thus, instead of setting \code{\\cvsectionstretchability} and/or \code{\\cvsubsectionstretchability}, page break behavior can be adjusted by redefining the following internal penalties:
|
|
\begin{lstlisting}
|
|
\renewcommand{\withinstretchpenalty}{<-100...9999>}
|
|
\renewcommand{\poststretchpenalty}{<-100...9999>}.
|
|
\end{lstlisting}
|
|
By default, \Moderncv sets \code{\\withinstretchpenalty} to 0 and \code{\\poststretchpenalty} to 9999.
|
|
The higher the penalties are, the less likely a page break will occur.
|
|
A good explanation of \code{\\needspace} can be found at \url{https://tex.stackexchange.com/questions/348994/understanding-needspace}.
|
|
|
|
|
|
\subsection{Tips and Tricks}
|
|
\subsubsection{Including a scanned signature in the letter of motivation}
|
|
\label{section:add:signature}
|
|
To add a scanned signature to your letter of motivation, add the following to your preamble:
|
|
%%%% redefinition of makeletterclosing without printing Name and last name but inserting
|
|
%%%% a signature png instead.
|
|
\begin{lstlisting}
|
|
\makeatletter
|
|
\renewcommand*{\makeletterclosing}{
|
|
\@closing\\[3em]%
|
|
\includegraphics[height=1.5cm, width=5.5cm]{<signature.png>}
|
|
% \textbf{\@firstname~\@lastname}%
|
|
\ifthenelse{\isundefined{\@enclosure}}{}{%
|
|
\\%
|
|
\vfill%
|
|
\textcolor{color2}{\textit{\enclname: \@enclosure}}%
|
|
}%
|
|
}
|
|
\makeatother
|
|
\end{lstlisting}
|
|
|
|
\subsubsection{Including a subject in the letter of motivation}
|
|
\label{section:add:subject}
|
|
To add a subject to your letter of motivation, add the following to your preamble:
|
|
\begin{lstlisting}
|
|
\makeatletter
|
|
\renewcommand*{\makeletterhead}{%
|
|
\recomputeletterlengths % in case we are switching from letter to resume, or vice versa
|
|
% recipient block
|
|
\begin{minipage}[t]{0.5\textwidth}
|
|
\raggedright\addressfont%
|
|
\textbf{\textup{\@recipientname}}\\%
|
|
\@recipientaddress%
|
|
\end{minipage}
|
|
% date
|
|
\hfill % US style
|
|
% \\[1em] % UK style
|
|
\@date\\[4em] % US informal style: "January 1, 1900"; UK formal style: "01/01/1900"
|
|
% opening
|
|
\raggedright%
|
|
\textbf{\subject}\\[2em]
|
|
\@opening\\[1.5em]%
|
|
% ensure no extra spacing after \makelettertitle due to a possible blank line
|
|
% \ignorespacesafterend % not working
|
|
\hspace{0pt}\par\vspace{-\baselineskip}\vspace{-\parskip}
|
|
}
|
|
\makeatother
|
|
\end{lstlisting}
|
|
Then a subject can be added to the letter of motivation with
|
|
\begin{lstlisting}
|
|
\subject{<subject_text>}
|
|
\end{lstlisting}
|
|
|
|
\subsubsection{Legal disclaimer at the end of the CV}
|
|
Some countries (e.g. Italy) require you to add a legal disclaimer authorizing the use of the personal data in your CV.
|
|
To add such a disclaimer, add the following to the bottom of your CV:%
|
|
\footnote{Example provided by Cristina Sambo}%
|
|
\begin{lstlisting}
|
|
\vfill
|
|
\begin{center}
|
|
\textit{\small Ai sensi del D. Lgs. 196/2003 ...}
|
|
\end{center}
|
|
\end{lstlisting}
|
|
|
|
|
|
|
|
\section{Implementation details}
|
|
\label{section:implementationDetails}
|
|
|
|
\subsection{Creating your own styles}
|
|
\todox{Add explanation on how to create styles and and how to recombine headers, footers, bodies etc.}
|
|
|
|
\subsection{Required packages}
|
|
\label{section:implementationDetails:requiredPackages}
|
|
In addition to the packages that \Moderncv itself provides, the following packages are loaded internally:
|
|
\begin{itemize}
|
|
\begin{multicols}{2}
|
|
\item \code{etoolbox}
|
|
\item \code{ifthen}
|
|
\item \code{xcolor}
|
|
\item \code{ifxetex} or \code{ifluatex}
|
|
\item \code{fontenc}
|
|
\item \code{url}
|
|
\item \code{hyperref}
|
|
\item \code{graphicx}
|
|
\item \code{fancyhdr}
|
|
\item \code{tweaklist}%
|
|
\footnote{The \code{tweaklist} package has been altered for the development of \Moderncv and ships with \moderncv.}
|
|
\item \code{calc}
|
|
\item \code{xparse}
|
|
\item \code{microtype}
|
|
\item \code{expl3}
|
|
\item \code{tikz}
|
|
\item \code{changepage}
|
|
\item \code{fontawesome5}
|
|
\item \code{academicons}
|
|
\item \code{tgpagella}
|
|
\item \code{ebgaramond}
|
|
\item \code{kurier}
|
|
\item \code{multirow}
|
|
\item \code{arydshln}
|
|
\end{multicols}
|
|
\end{itemize}
|
|
|
|
Most of these packages should be included in your \Latex distribution of choice.
|
|
|
|
\subsection{Known conflicts with other packages}
|
|
\begin{enumerate}
|
|
\item \Moderncv is incompatible with \code{biber}.
|
|
\item \Moderncv is incompatible with \biblatex.
|
|
\end{enumerate}
|
|
|
|
\subsection{Known bugs}
|
|
\begin{enumerate}
|
|
\item Skill matrices don't break automatically in \texttt{fancy} style.
|
|
\item Long names break the \texttt{oldstyle} style and possibly other styles (needs testing).
|
|
\item Long URLs in \texttt{classic} style can make the name break line.
|
|
Fixed width for the address part must be implemented.
|
|
\item When using the \texttt{fancy} style, undesired space is added between the bibliography head and the first entry, as well as after the last entry.
|
|
\item Footnotes generate errors, but the output seems correct when running with \code{-interaction=nonstopmode}.
|
|
\item When using CJK, the last \code{\\clearpage} required for \code{fancyhdr} to work properly kills the "lastpage" counter, hence also the page numbering.
|
|
\item \Moderncv produces the error ``\code{lonely \\item--perhaps a missing list environment}'' when used with bibentry, through the output is actually correct.
|
|
Among other things, this causes compilation by LyX to stop.
|
|
\item The space after a \code{\\cventry} gets eaten up when the last argument contains a nested itemize environment.
|
|
An ugly hack and incomplete solution was implemented by including a \code{\\strut} in every item label, but this doesn't solve the problem for multi-line items.
|
|
Ideally, the strut should end the item, but there seems to be no way to do this.
|
|
\end{enumerate}
|
|
|
|
\end{document}
|