summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/europasscv/europasscv.tex
blob: 7cc8b831e89b9d273d6e70b1ffd5e756d2dd96f0 (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
\documentclass[a4paper,nodocument,nologo,notitle,black,12pt]{europasscv}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{tikz}
\ifpdf
\hypersetup{
     colorlinks   = true
}
\fi

% \usepackage{showframe}

\author{\small Giacomo Mazzamuto\\
        \href{mailto:gmazzamuto+ctan@gmail.com}{\texttt{gmazzamuto+ctan@gmail.com}}\\}
\title{\small Documentation of the \LaTeX\ class\\
		\Large \textbf{\texttt{europasscv.cls}}\\
		\small \vspace{0.2cm} Version 0.1, 2015-03-05
}

\newcommand{\bs}{\textbackslash}


\begin{document}
\maketitle


\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, following the major restylings that came out in 2013.

\end{abstract}

\tableofcontents

\clearpage

\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{http://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 and spoken languages 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 of 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.

The main differences compared to the official model are the use of Helvetica (which should be in any standard \LaTeX\ distribution) instead of Arial, and the use of vector images instead of low-resolution bitmaps.

\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}.

\subsection{Personal information}
\ecvname{Name Surname}
\ecvtelephone[(+555) 340 123]{(+555) 555 555}
\hypersetup{urlcolor=black}
\ecvemail{myemailaddress@gmail.com}
\ecvhomepage{www.myhomepage.com}
\ecvaddress{rue Wiertz, B-1047 Brussels}
\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}{20cm}
  \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) 340 123]{(+555) 555 555}
\ecvemail{myemailaddress@gmail.com}
\ecvhomepage{www.myhomepage.com}
\ecvim{AOL Messenger}{betty.smith}
\ecvim{Google Talk}{bsmith}
\ecvdateofbirth{1 January 1970}
\ecvnationality{English}
\ecvgender{Female}
\end{verbatim}
and typeset with:
\begin{verbatim}
\ecvpersonalinfo
\end{verbatim}


\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}
    \makeatletter
    \@ecvitemskiptrue
    \makeatother
    \ecvbigitem{Job applied for}{ecvbigitem}

    \ecvsection{ecvsection}
    \ecvtitle{apr 2012 -- apr 2014}{ecvtitle}
    \ecvitem{}{ecvitem: this is the standard CV item}
    \ecvitem{}{ecvitem with some \ecvhighlight{highlighted} text}
    \ecvitem{ecvitemize}{
    \begin{ecvitemize}
	\item this is a list item
	\item this is a list item
    \end{ecvitemize}
    }
    \ecvblueitem{blue left text}{ecvblueitem}
    \ecvtitlelevel{apr 2012 -- apr 2014}{ecvtitlelevel}{ISCED 6}
    \ecvitem{}{ecvitem}
  \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}

Finally, if you want to put an itemize list in one CV entry, use the \texttt{ecvitemize} environment for a better alignment with the left text:
\begin{verbatim}
\ecvitem{left text}{
  \begin{ecvitemize}
    \item this is a list item
    \item this is a list item
  \end{ecvitemize}
}
\end{verbatim}


\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}
\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}{20cm}
  \begin{europasscv}
      \ecvmothertongue{English}
      \ecvlanguageheader
      \ecvlanguage{French}{C1}{C2}{B2}{C1}{C2}
      \ecvlastlanguage{German}{A2}{A2}{A2}{A2}{A2}
      \ecvlanguagefooter
  \end{europasscv}
\end{minipage}

\section{Advanced usage}

\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''.
  \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{english}, \texttt{italian}.

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.

\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{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}.

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

\section{Acknowledgements}
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.
\end{document}