Skip to content

rendercv.themes.classic

EntryAreaMarginsForClassic

Bases: EntryAreaMargins

This class is a data model for the entry area margins.

Source code in rendercv/themes/classic/__init__.py 
13
14
15
16
17
18
19
20
21
22
23
class EntryAreaMarginsForClassic(EntryAreaMargins):
    """This class is a data model for the entry area margins."""

    education_degree_width: LaTeXDimension = pydantic.Field(
        default="1 cm",
        title="Date and Location Column Width",
        description=(
            "The width of the degree column in EducationEntry. The default value is"
            " 1 cm."
        ),
    )

MarginsForClassic

Bases: Margins

This class is a data model for the margins.

Source code in rendercv/themes/classic/__init__.py 
26
27
28
29
30
31
32
33
class MarginsForClassic(Margins):
    """This class is a data model for the margins."""

    entry_area: EntryAreaMarginsForClassic = pydantic.Field(
        default=EntryAreaMarginsForClassic(),
        title="Entry Area Margins",
        description="Entry area margins.",
    )

ClassicThemeOptions

Bases: ThemeOptions

This class is the data model of the theme options for the classic theme.

Source code in rendercv/themes/classic/__init__.py 
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
class ClassicThemeOptions(ThemeOptions):
    """This class is the data model of the theme options for the `classic` theme."""

    theme: Literal["classic"]
    font: Literal[
        "Latin Modern Serif",
        "Latin Modern Sans Serif",
        "Latin Modern Mono",
        "Source Sans 3",
        "Charter",
    ] = pydantic.Field(
        default="Source Sans 3",
        title="Font",
        description="The font family of the CV. The default value is Source Sans 3.",
    )
    show_timespan_in: list[str] = pydantic.Field(
        default=[],
        title="Show Time Span in These Sections",
        description=(
            "The time span will be shown in the date and location column in these"
            " sections. The input should be a list of section titles as strings"
            " (case-sensitive). The default value is [] (no section will show the time"
            " span)."
        ),
    )
    margins: MarginsForClassic = pydantic.Field(
        default=MarginsForClassic(),
        title="Margins",
        description="Page, section title, entry field, and highlights field margins.",
    )

Jinja Templates

Preamble.j2.tex

\documentclass[<<design.font_size>>, <<design.page_size>>]{article}

% Packages:
\usepackage[
    ignoreheadfoot, % set margins without considering header and footer
    top=<<design.margins.page.top>>, % seperation between body and page edge from the top
    bottom=<<design.margins.page.bottom>>, % seperation between body and page edge from the bottom
    left=<<design.margins.page.left>>, % seperation between body and page edge from the left
    right=<<design.margins.page.right>>, % seperation between body and page edge from the right
    footskip=<<design.margins.page.bottom|divide_length_by(2)>>, % seperation between body and footer
    % showframe % for debugging 
]{geometry} % for adjusting page geometry
\usepackage[explicit]{titlesec} % for customizing section titles
\usepackage{tabularx} % for making tables with fixed width columns
\usepackage{array} % tabularx requires this
\usepackage[dvipsnames]{xcolor} % for coloring text
\definecolor{primaryColor}{RGB}{<<design.color.as_rgb_tuple()|join(", ")>>} % define primary color
\usepackage{enumitem} % for customizing lists
\usepackage{fontawesome5} % for using icons
\usepackage{amsmath} % for math
\usepackage[
    pdftitle={<<cv.name>>'s CV},
    pdfauthor={<<cv.name>>},
    pdfcreator={LaTeX with RenderCV},
    colorlinks=true,
    urlcolor=primaryColor
]{hyperref} % for links, metadata and bookmarks
\usepackage[pscoord]{eso-pic} % for floating text on the page
\usepackage{calc} % for calculating lengths
\usepackage{bookmark} % for bookmarks
\usepackage{lastpage} % for getting the total number of pages
\usepackage{changepage} % for one column entries (adjustwidth environment)
\usepackage{paracol} % for two and three column entries
\usepackage{ifthen} % for conditional statements
\usepackage{needspace} % for avoiding page brake right after the section title
\usepackage{iftex} % check if engine is pdflatex, xetex or luatex

% Ensure that generate pdf is machine readable/ATS parsable:
\ifPDFTeX
    \input{glyphtounicode}
    \pdfgentounicode=1
    \usepackage[T1]{fontenc}
    \usepackage[utf8]{inputenc}
    \usepackage{lmodern}
\fi

((* if design.font == "Latin Modern Serif" *))

((* elif design.font == "Latin Modern Sans Serif" *))
\renewcommand{\familydefault}{\sfdefault}
((* elif design.font == "Latin Modern Mono" *))
\renewcommand{\familydefault}{\ttdefault}
((* elif design.font == "Source Sans 3" *))
\usepackage[default, type1]{sourcesanspro} 
((* elif design.font == "Charter" *))
\usepackage{charter}
((* endif *))

% Some settings:
((* if design.text_alignment == "justified-with-no-hyphenation" *))
\usepackage[none]{hyphenat}
\sloppy
((* elif design.text_alignment == "left-aligned" *))
\raggedright
((* endif *))
\AtBeginEnvironment{adjustwidth}{\partopsep0pt} % remove space before adjustwidth environment
\pagestyle{empty} % no header or footer
\setcounter{secnumdepth}{0} % no section numbering
\setlength{\parindent}{0pt} % no indentation
\setlength{\topskip}{0pt} % no top skip
\setlength{\columnsep}{0.15cm} % set column seperation
((* if design.disable_page_numbering *))
\pagenumbering{gobble} % no page numbering
((* else *))
((* set page_numbering_style_placeholders = {
    "NAME": cv.name,
    "PAGE_NUMBER": "\\thepage{}",
    "TOTAL_PAGES": "\pageref*{LastPage}",
    "TODAY": today
} *))
\makeatletter
\let\ps@customFooterStyle\ps@plain % Copy the plain style to customFooterStyle
\patchcmd{\ps@customFooterStyle}{\thepage}{
    \color{gray}\textit{\small <<design.page_numbering_style|replace_placeholders_with_actual_values(page_numbering_style_placeholders)>>}
}{}{} % replace number by desired string
\makeatother
\pagestyle{customFooterStyle}
((* endif *))

\titleformat{\section}{
    % avoid page braking right after the section title
    \needspace{4\baselineskip}
    % make the font size of the section title large and color it with the primary color
    \Large\color{primaryColor}
}{
}{
}{
    % print bold title, give 0.15 cm space and draw a line of 0.8 pt thickness
    % from the end of the title to the end of the body
    \textbf{#1}\hspace{0.15cm}\titlerule[0.8pt]\hspace{-0.1cm}
}[] % section title formatting

\titlespacing{\section}{
    % left space:
    -1pt
}{
    % top space:
    <<design.margins.section_title.top>>
}{
    % bottom space:
    <<design.margins.section_title.bottom>>
} % section title spacing

% \renewcommand\labelitemi{$\vcenter{\hbox{\small$\bullet$}}$} % custom bullet points
\newenvironment{highlights}{
    \begin{itemize}[
        topsep=<<design.margins.highlights_area.top>>,
        parsep=<<design.margins.highlights_area.vertical_between_bullet_points>>,
        partopsep=0pt,
        itemsep=0pt,
        leftmargin=<<design.margins.highlights_area.left>> + 10pt
    ]
}{
    \end{itemize}
} % new environment for highlights

\newenvironment{highlightsforbulletentries}{
    \begin{itemize}[
        topsep=<<design.margins.highlights_area.top>>,
        parsep=<<design.margins.highlights_area.vertical_between_bullet_points>>,
        partopsep=0pt,
        itemsep=0pt,
        leftmargin=10pt
    ]
}{
    \end{itemize}
} % new environment for highlights for bullet entries


\newenvironment{onecolentry}{
    \begin{adjustwidth}{
        <<design.margins.entry_area.left_and_right>> + 0.00001 cm
    }{
        <<design.margins.entry_area.left_and_right>> + 0.00001 cm
    }
}{
    \end{adjustwidth}
} % new environment for one column entries

\newenvironment{twocolentry}[2][]{
    \onecolentry
    \def\secondColumn{#2}
    \setcolumnwidth{\fill, <<design.margins.entry_area.date_and_location_width>>}
    \begin{paracol}{2}
}{
    \switchcolumn \raggedleft \secondColumn
    \end{paracol}
    \endonecolentry
} % new environment for two column entries

\newenvironment{threecolentry}[3][]{
    \onecolentry
    \def\thirdColumn{#3}
    \setcolumnwidth{<<design.margins.entry_area.education_degree_width>>, \fill, <<design.margins.entry_area.date_and_location_width>>}
    \begin{paracol}{3}
    {\raggedright #2} \switchcolumn
}{
    \switchcolumn \raggedleft \thirdColumn
    \end{paracol}
    \endonecolentry
} % new environment for three column entries

\newenvironment{header}{
    \setlength{\topsep}{0pt}\par\kern\topsep\centering\color{primaryColor}\linespread{1.5}
}{
    \par\kern\topsep
} % new environment for the header

((* set last_updated_date_style_placeholders = {
    "TODAY": today,
} *))
\newcommand{\placelastupdatedtext}{% \placetextbox{<horizontal pos>}{<vertical pos>}{<stuff>}
  \AddToShipoutPictureFG*{% Add <stuff> to current page foreground
    \put(
        \LenToUnit{\paperwidth-<<design.margins.page.right>>-<<design.margins.entry_area.left_and_right>>+0.05cm},
        \LenToUnit{\paperheight-<<design.margins.page.top|divide_length_by(2)>>}
    ){\vtop{{\null}\makebox[0pt][c]{
        \small\color{gray}\textit{<<design.last_updated_date_style|replace_placeholders_with_actual_values(last_updated_date_style_placeholders)>>}\hspace{\widthof{<<design.last_updated_date_style|replace_placeholders_with_actual_values(last_updated_date_style_placeholders)>>}}
    }}}%
  }%
}%

% save the original href command in a new command:
\let\hrefWithoutArrow\href

% new command for external links:
((* if not design.disable_external_link_icons *))
\renewcommand{\href}[2]{\hrefWithoutArrow{#1}{\ifthenelse{\equal{#2}{}}{ }{#2 }\raisebox{.15ex}{\footnotesize \faExternalLink*}}}
((* endif *))

Header.j2.tex

\newcommand{\AND}{\unskip
    \cleaders\copy\ANDbox\hskip\wd\ANDbox
    \ignorespaces
}
\newsavebox\ANDbox
\sbox\ANDbox{<<design.seperator_between_connections>>}

((* if not design.disable_last_updated_date *))
\placelastupdatedtext
((* endif *))
((* if cv.name is not none *))
\begin{header}
    \fontsize{<<design.header_font_size>>}{<<design.header_font_size>>}
    \textbf{<<cv.name>>}

    \vspace{<<design.margins.header.vertical_between_name_and_connections>>}

    \normalsize
    ((* for connection in cv.connections *))
        ((* if design.use_icons_for_connections *))
    \mbox{((*- if connection["url"] -*))
        \hrefWithoutArrow{<<connection["url"]>>}{{\footnotesize<<connection["latex_icon"]>>}\hspace*{0.13cm}<<connection["placeholder"]|escape_latex_characters>>}
        ((*- else -*))
        {\footnotesize<<connection["latex_icon"]>>}\hspace*{0.13cm}<<connection["placeholder"]|escape_latex_characters>>
        ((*- endif -*))}%
        ((* else *))
    \mbox{((*- if connection["url"] -*))
        \hrefWithoutArrow{<<connection["url"]>>}{<<connection["clean_url"]|escape_latex_characters>>}
        ((*- else -*))
        <<connection["placeholder"]|escape_latex_characters>>
        ((*- endif -*))}%
        ((* endif *))
        ((* if not loop.last *))
    \kern <<design.margins.header.horizontal_between_connections|divide_length_by(2)>>%
    \AND%
    \kern <<design.margins.header.horizontal_between_connections|divide_length_by(2)>>%
        ((* endif *))
    ((* endfor *))
\end{header}

\vspace{<<design.margins.header.bottom>> - <<design.margins.section_title.top>>}
((* endif *))

SectionBeginning.j2.tex

\section{<<section_title>>}

((* if entry_type == "BulletEntry" *))
\begin{onecolentry}
    \begin{highlightsforbulletentries}
((* endif *))

SectionEnding.j2.tex

((* if entry_type == "BulletEntry" *))
    \end{highlightsforbulletentries}
\end{onecolentry}
((* endif *))

TextEntry.j2.tex

((* if not is_first_entry *))
\vspace{<<design.margins.entry_area.vertical_between>>}
((* endif *))

\begin{onecolentry}
    <<entry>>
\end{onecolentry}

BulletEntry.j2.tex

\item <<entry.bullet>>

OneLineEntry.j2.tex

((* if not is_first_entry *))
\vspace{<<design.margins.entry_area.vertical_between>>}
((* endif *))

\begin{onecolentry}
    \textbf{<<entry.label>>:} <<entry.details>>
\end{onecolentry}

EducationEntry.j2.tex

((* if section_title in design.show_timespan_in *))
    ((* set date_and_location_strings = [entry.location, entry.date_string, entry.time_span_string]|select("!=", "") *))
((* else *))
    ((* set date_and_location_strings = [entry.location, entry.date_string]|select("!=", "") *))
((* endif *))
((* if not is_first_entry *))
\vspace{<<design.margins.entry_area.vertical_between>>}
((* endif *))

\begin{threecolentry}{\textbf{<<entry.degree>>}}{
    <<date_and_location_strings|join("\n\n")>>
}
    \textbf{<<entry.institution>>}, <<entry.area>>
((* for item in entry.highlights *))
    ((* if loop.first *))
    \begin{highlights}
    ((* endif *))
        \item <<item>>
    ((* if loop.last *))
    \end{highlights}
    ((* endif *))
((* endfor *))
\end{threecolentry}

ExperienceEntry.j2.tex

((* if section_title in design.show_timespan_in *))
    ((* set date_and_location_strings = [entry.location, entry.date_string, entry.time_span_string]|select("!=", "") *))
((* else *))
    ((* set date_and_location_strings = [entry.location, entry.date_string]|select("!=", "") *))
((* endif *))
((* if not is_first_entry *))
\vspace{<<design.margins.entry_area.vertical_between>>}
((* endif *))

((* if entry.date_string or entry.location *))
\begin{twocolentry}{
    <<date_and_location_strings|join("\n\n")>>
}
    \textbf{<<entry.company>>}, <<entry.position>>
    ((* for item in entry.highlights *))
        ((* if loop.first *))
    \begin{highlights}
        ((* endif *))
        \item <<item>>
        ((* if loop.last *))
    \end{highlights}
        ((* endif *))
    ((* endfor *))
\end{twocolentry}
((* else *))
\begin{onecolentry}
    \textbf{<<entry.company>>}, <<entry.position>>
    ((* for item in entry.highlights *))
        ((* if loop.first *))
    \begin{highlights}
        ((* endif *))
        \item <<item>>
        ((* if loop.last *))
    \end{highlights}
        ((* endif *))
    ((* endfor *))
\end{onecolentry}
((* endif *))

NormalEntry.j2.tex

((* if section_title in design.show_timespan_in *))
    ((* set date_and_location_strings = [entry.location, entry.date_string, entry.time_span_string]|select("!=", "") *))
((* else *))
    ((* set date_and_location_strings = [entry.location, entry.date_string]|select("!=", "") *))
((* endif *))
((* if not is_first_entry *))
\vspace{<<design.margins.entry_area.vertical_between>>}
((* endif *))

((* if entry.date_string or entry.location *))
\begin{twocolentry}{
    <<date_and_location_strings|join("\n\n")>>
}
    \textbf{<<entry.name>>}
    ((* for item in entry.highlights *))
        ((* if loop.first *))
    \begin{highlights}
        ((* endif *))
        \item <<item>>
        ((* if loop.last *))
    \end{highlights}
        ((* endif *))
    ((* endfor *))
\end{twocolentry}
((* else *))
\begin{onecolentry}
    \textbf{<<entry.name>>}
    ((* for item in entry.highlights *))
        ((* if loop.first *))
    \begin{highlights}
        ((* endif *))
        \item <<item>>
        ((* if loop.last *))
    \end{highlights}
        ((* endif *))
    ((* endfor *))
\end{onecolentry}
((* endif *))

PublicationEntry.j2.tex

((* if not is_first_entry *))
\vspace{<<design.margins.entry_area.vertical_between>>}
((* endif *))

\begin{samepage}
    ((* if entry.date_string *))
    \begin{twocolentry}{
        <<entry.date_string>>
    }
    ((* else *))
    \begin{onecolentry}
    ((* endif *))
        \textbf{<<entry.title>>}

        \vspace{<<design.margins.highlights_area.top>>}

        <<entry.authors|map("make_it_nolinebreak")|join(", ")>>
        ((* if entry.doi or entry.journal or entry.url *))
        \vspace{<<design.margins.highlights_area.vertical_between_bullet_points>>}

        ((* endif *))
        ((* if entry.doi -*))
        \href{<<entry.doi_url>>}{<<entry.doi|escape_latex_characters>>}
        ((* elif entry.url -*))
        \href{<<entry.url>>}{<<entry.clean_url>>}
        ((*- endif -*))
        ((*- if (entry.doi or entry.url) and entry.journal *)) (((* endif -*))
        ((*- if entry.journal -*))
        <<entry.journal>>
        ((*- endif -*))
        ((*- if (entry.doi or entry.url) and entry.journal *)))((* endif *))
    ((* if entry.date_string *))
    \end{twocolentry}
    ((* else *))
    \end{onecolentry}
    ((* endif *))
\end{samepage}