DOCSEARCHbyAlgolia
Submit Docs

AltaCV Documentation

repository·main·Indexed 23 days ago

https://github.com/liantze/altacv

A LaTeX class for creating modern CVs and résumés featuring a flexible two-column layout via the paracol package, custom information fields, and built-in icon integration. Includes guides on compilation requirements for pdflatex, xelatex, and lualatex, as well as instructions for customizing colors, fonts, and ATS-friendly replacement text.

Tokens
1.2K
Snippets
4
Records
6
Agent score
32%

What's inside AltaCV

  1. Make AltaCV ATS-friendly

    main

    AltaCV uses the accsupp package to provide replacement text for icons. This means that when a user copies text from a PDF (e.g., a GitHub icon), the clipboard will contain the actual text (e.g., \faGithub) instead of an unreadable symbol.

    To ensure your CV is readable by ATS, you can customize the replacement text for locations and dates, which is useful for non-English CVs:

    \renewcommand{\locationname}{Ubicación}
\renewcommand{\datename}{Fecha}

  2. How to use the two-column layout with paracol

    main

    The modern AltaCV template uses the paracol package to manage a left and right column that can automatically break across pages. You can control the width ratio using \columnratio{ratio} (where ratio is the left column width). Use \begin{paracol}{2} to start the layout, \cvsection{...} to add content to the current column, and \switchcolumn to move to the next column.

    Note: You do not need the fullwidth environment or optional arguments in \cvsection when using this layout.

    %% Set the left/right column width ratio to 6:4.
\columnratio{0.6}

% Start a 2-column paracol. Both the left and right columns will automatically
% break across pages if things get too long.
\begin{paracol}{2}
\cvsection{Experience}
...
... END OF LEFT COLUMN CONTENTS ...

% Now switch to the right column.
\switchcolumn
\cvsection{Education}
...
...END OF RIGHT COLUMN CONTENTS ...
\end{paracol}

  3. Requirements and Compilation for AltaCV

    main

    To use AltaCV, ensure your LaTeX environment meets these requirements:

    • Packages: Requires fontawesome5 (≥ v5.12.0) and simpleicons (≥ v9.9.0) for icons like \xtwitter.
    • Compilation:
      • To generate a list of publications, run: pdflatex $\rightarrow$ biber $\rightarrow$ pdflatex (or use xelatex/lualatex).
      • XeLaTeX specific: Use the following command to enable shell escape and correct output drivers: xelatex -shell-escape -output-driver="xdvipdfmx -z 0" sample.tex.

    Useful Class Options:

    • normalphoto: Produces non-circular photos.
    • ragged2e: Activates hyphenation while keeping text left-justified for better aesthetics.
    • withhyper: Makes personal info fields clickable hyperlinks (requires hyperref, which is always loaded).
    xelatex -shell-escape -output-driver="xdvipdfmx -z 0" sample.tex

  4. Configure clickable info fields with withhyper

    main

    When the withhyper document class option is enabled, personal info fields become clickable. By default, \homepage{foobar.com} generates a link using the \homepagehyperprefix (defaulting to https://).

    You can customize the prefix or the icon used for these fields:

    \renewcommand{\homepagehyperprefix}{http://}
\renewcommand{\homepagesymbol}{\faLink}
    \renewcommand{\homepagehyperprefix}{http://}
\renewcommand{\homepagesymbol}{\faLink}

  5. Create custom information fields

    main

    AltaCV allows you to define and use arbitrary information fields for social media or personal details. There are three ways to do this:

    1. Directly with \printinfo: Best for one-off fields. \printinfo{symbol}{detail}[optional hyperlink prefix]

    2. Defining a standard field: Best for reusable fields with a fixed prefix. \NewInfoField{fieldname}{symbol}[optional hyperlink prefix]

    3. Defining a starred field (\NewInfoField*): Best for platforms where the link isn't a simple prefix (e.g., Mastodon). This allows you to pass the full URL as a second argument to the command.

    Examples:

    % Method 1: Direct
\printinfo{\faPaw}{Hey ho!}
\printinfo{\faGitLab}{your-handle}[https://gitlab.com/]

% Method 2: Defined field
\NewInfoField{gitlab}{\faGitlab}[https://gitlab.com/]
\gitlab{your_id}

% Method 3: Starred field for complex URLs
\NewInfoField*{mastodon}{\faMastodon}
\mastodon{@username@instance}{https://instance.url/@username}
    \printinfo{\faPaw}{Hey ho!}
\printinfo{\faGitLab}{your-handle}[https://gitlab.com/]

\NewInfoField{gitlab}{\faGitlab}[https://gitlab.com/]
\gitlab{your_id}

\NewInfoField*{mastodon}{\faMastodon}
\mastodon{@username@instance}{https://instance.url/@username}

  6. Customize AltaCV colors, fonts, and icons

    main

    You can customize the visual style of your CV in the preamble using standard LaTeX commands.

    Colors (use \colorlet or \definecolor):

    • accent, emphasis, heading, headingrule, subheading, body, name, tagline

    Fonts (use \renewcommand):

    • \namefont, \taglinefont, \personalinfofont, \cvsectionfont, \cvsubsectionfont

    Icons (use \renewcommand):

    • \cvItemMarker (bullets for itemize)
    • \cvRatingMarker (for \cvskill)
    • \cvDateMarker (for date in \cvevent)
    • \cvLocationMarker (for location in \cvevent and \location)