summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/europasscv/europasscv.tex
blob: 8c5d64d33653aeb269571859d3323708705a0d5a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
\documentclass[a4paper,nodocument,nologo,notitle,black,12pt]{europasscv}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{tikz}
\usepackage{tabu}
\usepackage{metalogo}

\ifpdf
\hypersetup{
     colorlinks   = true
}
\fi

% \usepackage{showframe}

\date{October 31, 2020}

\author{Giacomo Mazzamuto\\
        {\href{mailto:gmazzamuto+ctan@gmail.com}{\texttt{gmazzamuto+ctan@gmail.com}}}\\}
\title{ Documentation of the \LaTeX\ class\\
		\Large{\textbf{\texttt{europasscv.cls}}}\\
		\normalsize{\href{https://www.devrandom.it/software/europasscv}{\texttt{https://www.devrandom.it/software/europasscv}}}\\
		\vspace{0.2cm} Version 2020-10-31
}

\newcommand{\bs}{\textbackslash}


\begin{document}
\maketitle
\clearpage

\begin{abstract}
This paper describes how to use europasscv.cls, a \LaTeX\ document class for typesetting a curriculum vitae according to the Europass initiative of the European Commission. This is an unofficial implementation of that format, featuring the major style updates that came out in 2013.

\end{abstract}

\tableofcontents

\section{Introduction}
This class is an unofficial \LaTeX\ implementation of the the \emph{Europass~CV\/}, the standard model for curriculum vitae as recommended by the European Commission. The Europass~CV replaces the European CV, launched in~2002. In 2013 a major revision of the Europass~CV came out, featuring a neater, more compact and somewhat fancier layout. This class is an implementation of the 2013 version of that layout and is based on the \textsf{europecv}\footnote{\url{https://ctan.org/pkg/europecv}} class (which is an implementation of the previous layout).

The Europass~CV defines both the content and the layout of a curriculum vitae. The \textsf{europasscv} class provides support for the latter, and for the former as far as personal information, spoken languages and digital competences are concerned. If you want to know how the content of a Europass~CV is structured, refer to the documentation provided by the Europass website\footnote{\url{https://europass.cedefop.europa.eu/en/documents/curriculum-vitae/templates-instructions}.}.

This class tries to be as close as possible to the standard model without sacrificing flexibility. Although it is primarily intended for users in the European Union, the class can be used for any kind of curriculum vitae (possibly with the options \texttt{notitle} and \texttt{nologo}, see below), or even for other kinds of documents.

\section{Tutorial}
Let's start with a minimal (empty) curriculum vitae:
\begin{verbatim}
\documentclass[english,a4paper]{europasscv}
\begin{document}
  \begin{europasscv}
  \end{europasscv}
\end{document}
\end{verbatim}

Now you can start writing your CV by entering first of all your personal information and then adding sections and items as described below.

For a complete list of usable class options see section \ref{sec:classOptions}.

% \enlargethispage{2\baselineskip}

\subsection{Personal information}
\ecvname{Name Surname}
\ecvtelephone{(+555) 555 555\newline}
\ecvworkphone{(+555) 123 456}
\ecvmobile{(+555) 340 123}
\ecvaddress{rue Wiertz, B-1047 Brussels}
\hypersetup{urlcolor=black}
\ecvemail{smith@kotmail.com another@email.com}
\ecvhomepage{www.myhomepage.com www.another.com}
\ecvgitpage{https://www.git.example.org/}
\ecvgithubpage{https://github.com/smith}
\ecvgitlabpage{https://gitlab.com/smith}
\ecvlinkedinpage{https://www.linkedin.com/in/smith}
\ecvorcid[label, link]{0000-0000-0000-0000}
\ecvim{AOL Messenger}{betty.smith}
\ecvim{Google Talk}{bsmith}
\ecvdateofbirth{1 January 1970}
\ecvnationality{English}
\ecvgender{Female}
\hspace*{-6cm}
\ecvLeftColumnWidth{90mm}
\ecvColSep{10pt}
\begin{minipage}{21cm}
  \begin{europasscv}
    \ecvpersonalinfo
  \end{europasscv}
\end{minipage}

\bigskip
\noindent
The \emph{Personal information} section shown above is specified with the commands:
\begin{verbatim}
\ecvname{Name Surname}
\ecvaddress{rue Wiertz, B-1047 Brussels}
\ecvtelephone{(+555) 555 555}
\ecvmobile{(+555) 340 123}
\ecvworkphone{(+555) 123 456}
\ecvemail{smith@kotmail.com another@email.com}
\ecvhomepage{www.myhomepage.com www.another.com}
\ecvgitpage{https://www.git.example.org/}
\ecvgithubpage{https://github.com/smith}
\ecvgitlabpage{https://gitlab.com/smith}
\ecvlinkedinpage{https://www.linkedin.com/in/smith}
\ecvorcid[label, link]{0000-0000-0000-0000}
\ecvim{AOL Messenger}{betty.smith}
\ecvim{Google Talk}{bsmith}
\ecvdateofbirth{1 January 1970}
\ecvnationality{English}
\ecvgender{Female}
\end{verbatim}
and then typeset inside the \texttt{europasscv} environment with:
\begin{description}
\item[\texttt{\bs ecvpersonalinfo}]
\end{description}
Photos can be added with the following commands:
\begin{description}
\item[\texttt{\bs ecvpictureleft[\textit{options}]\{\textit{filename}\}}]
\item[\texttt{\bs ecvpictureright[\textit{options}]\{\textit{filename}\}}]
\end{description}
where options are passed to \texttt{\bs includegraphics}. The command \texttt{\bs ecvpicture} is an alias for \texttt{\bs ecvpictureleft}.

\hypersetup{urlcolor=magenta}

\subsection{Sectioning and item commands}
Sectioning commands should be used inside the \texttt{europasscv} environment. All of them have an optional argument that specifies how much vertical space to leave \emph{before} that command. Note that this is the opposite of what happened in the old \texttt{europecv} class.

Use the following simple commands to add items and sections to your CV:\\
\ecvLeftColumnWidth{50mm}
\hspace*{-6.4cm}
\ecvLeftColumnWidth{90mm}
\ecvColSep{10pt}
\begin{minipage}{20cm}
  \begin{europasscv}
    \ecvbigitem{Job applied for}{ecvbigitem}

    \ecvsection{ecvsection}
    \ecvtitle{apr 2012 -- apr 2014}{ecvtitle}
    \ecvitem{}{ecvitem: this is the standard CV item. This is some \ecvhighlight{highlighted} text.}
    \ecvitem{ecvitemize}{
    \begin{ecvitemize}
	\item this is a list item
	\item this is a list item
	    \begin{ecvitemize}
		\item this is a list item
		\item this is a list item
	    \end{ecvitemize}
    \end{ecvitemize}
    }
    \ecvblueitem{blue left text}{ecvblueitem}
    \ecvtitlelevel{apr 2012 -- apr 2014}{ecvtitlelevel}{ISCED 6}
    \ecvitem{ecvitem}{Item description}
    \ecvitem{ecvitem}{\ecvhighlightcell{highlighted cell}}
  \end{europasscv}
\end{minipage}

\begin{description}
\item[\texttt{\bs ecvsection[\textit{vspace}]\{\textit{title}\}}] Start a new section with the given \textit{title}.
\item[\texttt{\bs ecvitem[\textit{vspace}]\{\textit{left}\}\{\textit{right}\}}] Put \textit{left} text on the left part and \textit{right} text on the right part of the page. This is a standard CV item. Note that, in the 2013 version of the Europass CV, text on the left part is much less used than before. Still, it can be sometimes useful to put some text on the left.
\item[\texttt{\bs ecvtitle[\textit{vspace}]\{\textit{left}\}\{\textit{right}\}}] As above, but the text is typeset in blue and with a larger font on the right. This is used to highlight a block in your CV related to a same job or degree, with dates typically going on the left and job description or degree type on the right.
\item[\texttt{\bs ecvtitlelevel[\textit{vspace}]\{\textit{left}\}\{\textit{right}\}\{\textit{degree level}\}}] Allows to specify a national or international level for the awarded degree.
\item[\texttt{\bs ecvblueitem[\textit{vspace}]\{\textit{left}\}\{\textit{right}\}}] As a standard CV item, but text on the left is typeset in blue. This is mainly used in the second part of the CV.
\item[\texttt{\bs ecvbigitem[\textit{vspace}]\{\textit{left}\}\{\textit{right}\}}] As above, but typeset the left text in capital blue letters and the right text in a bigger font. This is rarely used.
\end{description}

If you want to highlight some text using the highlight color of the Europass CV palette (section \ref{sec:colors}), you may find this convenience command useful:
\begin{description}
 \item[\texttt{\bs ecvhighlight\{\textit{some text}\}}]
\end{description}
To hihghlight the background of a cell, use this command instead:
\begin{description}
 \item[\texttt{\bs ecvhighlightcell\{\textit{some text}\}}]
\end{description}
For example:
\begin{description}
 \item[\texttt{\bs ecvitem\{\textit{left}\}\{\texttt{\bs ecvhighlightcell\{\textit{some text}\}\}}}]
\end{description}

Finally, if you want to put lists in one CV entry, use the \texttt{ecvitemize} and \texttt{ecvenumerate} environments for a better alignment with the text in the left column:
\begin{verbatim}
\ecvitem{left text}{
  \begin{ecvitemize}
    \item this is a list item
    \item this is a list item
  \end{ecvitemize}
}
\end{verbatim}
\enlargethispage{\baselineskip}


\subsection{Language skills}
The language skills table is usually found at the beginning of the ``Personal skills'' section of the Europass CV. The commands needed to typeset the language table are fully highlighted by the following example:

\begin{verbatim}
\ecvmothertongue{English}
\ecvlanguageheader
\ecvlanguage{French}{C1}{C2}{B2}{C1}{C2}
\ecvlanguagecertificate{Diplôme d'études en langue française (DELF) B1}
\ecvlastlanguage{German}{A2}{A2}{A2}{A2}{A2}
\ecvlanguagefooter
\end{verbatim}
which is typeset like this:

\vspace{0.5cm}
\hspace*{-7cm}
\ecvLeftColumnWidth{80mm}
\ecvColSep{10pt}
\begin{minipage}{21cm}
  \begin{europasscv}
      \ecvmothertongue{English}
      \ecvlanguageheader
      \ecvlanguage{French}{C1}{C2}{B2}{C1}{C2}
      \ecvlanguagecertificate{Diplôme d'études en langue française (DELF) B1}
      \ecvlastlanguage{German}{A2}{A2}{A2}{A2}{A2}
      \ecvlanguagefooter
  \end{europasscv}
\end{minipage}

\subsection{Digital competences}

This one is another self-assessment grid which allows to present digital competences.
It is divided into five categories.
For each of these, there are three competence levels available.
To create a self-assessment grid, a single command will suffice.
Additionally, convenient string definitions are provided to describe each level.
In the following, an example code snippet and the resulting CV entry is presented:

\begin{verbatim}
\ecvdigitalcompetence
    {\ecvBasic}
    {\ecvIndependent}
    {\ecvProficient}
    {\ecvIndependent}
    {\ecvBasic}
\end{verbatim}

\vspace{0.5cm}
\hspace*{-6.5cm}
\begin{minipage}{21cm}
	\begin{europasscv}
		\ecvdigitalcompetence
			{\ecvBasic}
			{\ecvIndependent}
			{\ecvProficient}
			{\ecvIndependent}
			{\ecvBasic}
	\end{europasscv}
\end{minipage}

\subsection{Cover letter}
The package provides some convenience commands to typeset an accompanying cover letter in the same style of the CV. These commands start with \texttt{\bs ecl} and are analogous to those seen previously. Here follows a simple example on how to produce a cover letter; please refer to the full example available on GitHub.
\begin{verbatim}
    \thispagestyle{empty}
    \eclpersonalinfo

    \ecladdressee{Contact person}
                 {Name of organization}
                 {Address of organization}
                 {City}

    \eclcitydatesubject{City}
                       {\today}
                       {Subject of this cover letter}

    \eclopeningsalutation{Dear Sir}
    \eclmaincontent
    {Opening salutation.\bigskip}

    {This is the main content.}

    {Closing salutation.}

    \eclclosingsalutation{Yours sincerely}

    \eclsignature
%     \eclsignature[signature.jpg]
%     \eclsignature[signature.jpg][Dr. Katie Smith]

    \pagebreak \setcounter{page}{1}
\end{verbatim}

\section{Advanced usage}
\subsection{Bibliography}
Printing bibliography using \texttt{biblatex} is supported. Please refer to the provided source file for a working example of how to integrate \texttt{biblatex} with \texttt{europasscv}. Basically, in your preamble you need to use the \texttt{biblatex} package followed by
\begin{verbatim}
\usepackage{europasscv-bibliography}
\end{verbatim}
and then you can specify the bibliography source file as usual.

To print the bibliography, use the following commands:
\begin{verbatim}
  \renewcommand{\section}[2]{\ecvsection{#2}}
  \printbibtabular[title=Publications]
\end{verbatim}
where the first command is used to specify which kind of heading you want to use for the bibliography section. Finally, the following commands are defined in the \texttt{europasscv-bibliography} package:
\begin{description}
 \item[\texttt{\bs ecvbibhighlight\{\textit{last name}\}\{\textit{first name}\}\{\textit{first name initial}\}}] mark the given name to be highlighted in bold in the bibliography
\end{description}

\subsection{Class options}
\label{sec:classOptions}
\subsubsection{Appearance options}
\begin{description}
 \item[\texttt{black}] Typeset CV entries in black instead of \texttt{ecvtextcolor} (see \ref{sec:colors}).
 \item[\texttt{nodocument}] Do not apply the class settings (i.e.\ margins, headers and footers) at \texttt{\bs begin\{document\}}.
 \item[\texttt{nologo}] Do not draw the Europass logo.
 \item[\texttt{notitle}] Do not typeset the title ``Curriculum vitae''.
 \item[\texttt{nototpages}] Do not typeset total page count in the footer.
  \end{description}
  
 The following options affect the font used:
\begin{description}
 \item[\texttt{narrow}] Use the Condensed Helvetica font instead of Helvetica.
 \item[\texttt{bigfont}] Use a sligtly bigger font than the one found in the official Europass CV.
\end{description}
\subsubsection{Language options}
The options hereby described are not related to babel. The choice of the language only affects the appearance of labels appearing e.g.\ in the personal information section, the spoken language table and the footer.
% In some cases, it may affect the used alphabet (e.g. in Bulgarian).
If you want to use the hyphenation patterns for the language(s) of your choice, you must include the \textsf{babel} package in your document.
% The use of \textsf{babel} is mandatory for Greek (see the Greek language option above).

The following language options are currently supported:
\texttt{catalan}, \texttt{danish}, \texttt{english}, \texttt{czech}, \texttt{french}, \texttt{german}, \texttt{greek}\footnote{Requires \XeLaTeX\ or \LuaLaTeX.}, \texttt{hungarian}, \texttt{italian}, \texttt{norsk} (Norwegian Bokmål), \texttt{polish}, \texttt{portuguese}, \texttt{slovak}, \texttt{slo\-venian}, \texttt{spanish}, \texttt{turkish}.

If you need a different language, you must create a new \texttt{.def} file and add the corresponding \texttt{\textbackslash DeclareOption} in the class file. Please contribute your \texttt{.def} files so that they can be included in future updates. The \texttt{.def} files in the \texttt{europecv}\footnote{\url{https://ctan.org/pkg/europecv}} package are a good starting point.

\subsubsection{Fonts}
When using \LaTeX, the default font is \texttt{phv} or Helvetica. To override, use the \texttt{\bs ecvfont} command:
\begin{verbatim}
 \ecvfont{lmr}
\end{verbatim}
When using \XeLaTeX\ or \LuaLaTeX, the default font is TeX Gyre Heros. To override, use:
\begin{verbatim}
 \setmainfont{TeX Gyre Pagella}
\end{verbatim}

\subsubsection{Debugging}
If you are editing the class file you may find the \texttt{debug} option useful: if this option is specified, debug messages are printed on the terminal, the boxes making up the structure of the CV are highlighted with background colors, and the package \texttt{showframe} is loaded.

\subsection{Color palette}
\label{sec:colors}
The following colors are defined in the package:
{%

\newcommand{\colpic}[1]{\tikz \draw[fill=#1,ultra thick,#1] (0,0) rectangle (0.5,0.5);}
\newcommand{\colrow}[1]{\texttt{#1} & \colpic{#1} & \extractcolorspecs{#1}{\model}{\mycolor}%
    \convertcolorspec{\model}{\mycolor}{HTML}\tmp\texttt{\tmp}}
    
\renewcommand{\arraystretch}{1.5}
\newcommand{\mc}[2]{\multicolumn{#1}{#2}}
\begin{center}
  \begin{tabu} {X[1,r,m] X[0.3,c,m] X[1,l,m]}
    color name & sample & HTML code\\
    \hline
    \colrow{ecvrulecolor}\\
    \colrow{ecvsectioncolor}\\
    \colrow{ecvhighlightcolor}\\
    \colrow{ecvhighlightcellcolor}\\
    \colrow{ecvtablebordercolor}\\
    \colrow{ecvlanglinkcolor}\\
    \colrow{ecvtextcolor}\\
    \tabuphantomline
  \end{tabu}
\end{center}
}%
You can use these colors wherever you want in your document like this
\begin{verbatim}
\textcolor{colorname}{ Some text }
\end{verbatim} 
There is also a convenience command \texttt{\bs ecvhighlight\{ Some text \}} which typesets text in \texttt{ecvhighlightcolor}.

\subsection{Deprecated commands}
Using \texttt{\textbackslash ecvtelephone[\textit{mobile number}]\{\textit{number}\}} with the optional argument is deprecated. Please use \texttt{\textbackslash ecvmobile\{\textit{number}\}} and \texttt{\textbackslash ecvtelephone\{\textit{number}\}} instead.

\section{Copyright and license}
Europass and the Europass logo are copyright of the European Union.\footnote{See \url{https://europass.cedefop.europa.eu} for more information.} The \texttt{europasscv} class is released under The \LaTeX\ Project Public License version 1.3.\footnote{\url{https://ctan.org/license/lppl1.3}.}

\section{Acknowledgements}
Special thanks to \LaTeX\ enthusiast Francesco Biccari whom I had the pleasure to meet at LENS in Sesto Fiorentino and who provided useful comments and suggestions.

The following people contributed language definition files: Peter Fink (German); Nuno Vieira (Portuguese), Henry Ajquejay, Gast\'{o}n Simone and Pablo Rodriguez (Spanish); Ale\v s Zadravec (Slovenian); Jan Koprnick\'{y} (Czech); Lennart Jern (Swedish), Daniel Østergaard Andreasen (Danish), Roger Bassons Renart (Catalan); Andrei Troie (Romanian); Tümay Çeber (Turkish); Martin Štefaňák (Slovak).

The following people contributed code changes: Stanley Foerster, Andrzej \'{S}liwi\'{n}ski
\end{document}