As an enhancement, it might be interesting to use the businesscard-qrcode to integrate an optional business card in the CV generation (lust like we already optionally generate a cover letter) that is stylistically conformant and reuses contact information saved in the main CV tex document

I haven't gotten around to working on the integrations yes, just mucking around a bit with the business card package

Constructive input and code contributions are very welcome

Currently building our template (or any other document using moderncv) raises a warning: Underfull \hbox (badness 10000) in paragraph at lines 93--93. This happens in \makecvtitle. I have no idea where exactly that underfull hbox is supposed to be, but let's track this issue, as it might confuse users.

Would it be possible to add discord to the list of social links?

Is it possible to remove the full stop that is inserted after each item?

Currently moderncv depends on both fontawesome5 and academicons. In the style selection files (e.g. moderncvstyleclassic.cls) the engine is tested, and when XeTeX or LuaTeX are used, the icons are loaded via moderncviconsawesome.sty, and when not, marvosym is used.

But doesn't fontawesome5 work with pdflatex? If the icon loading logic just loads fontawesome5 in all cases and ONLY loads academicons when Xe/LuaTeX is used, this will reduce the amount of maintenance required. But this will require splitting the moderncviconsawesome.sty file into two separate one, one loading fontawesome5 in all cases and one loading academicons depending on engine.

Something like xdanaux#77, maybe requires changes for 8d55439.

Hi!
I'm sorry to be asking here, and it's probably just my own ignorance (I'm just coming back to LaTeX, I've forgotten a lot!), but I see that this package is now in version 2.1, but my local install seem to only be pulling the 2.0 version.
I assume I can just clone the repo locally and force it to use that but it's less than ideal.

What am I missing?
Thanks
Alexis

❯ latex --version
pdfTeX 3.14159265-2.6-1.40.21 (TeX Live 2020)
kpathsea version 6.3.2
Copyright 2020 Han The Thanh (pdfTeX) et al.
There is NO warranty.  Redistribution of this software is
covered by the terms of both the pdfTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the pdfTeX source.
Primary author of pdfTeX: Han The Thanh (pdfTeX) et al.
Compiled with libpng 1.6.37; using libpng 1.6.37
Compiled with zlib 1.2.11; using zlib 1.2.11
Compiled with xpdf version 4.02

Version 2.3.0 has been installed on CTAN, I got the following feedback:

Feedback: Please remember that the uploded moderncv-vx.x.x.tar.gz should contain a top-level directory "moderncv/", cf. examples on https://ctan.org/help/upload-pkg . Thanks!

Since iirc I got this already before, I opened this issue to remind us to do this before the next release. Will do when I have time.

Please see https://github.com/xdanaux/moderncv/pull/71

These would be extremely convenient for providing research links

On a system with the packages required installed as well as the moderncv package, on a folder with just the following files:

• template.tex
• publications.bib
• picture.eps
• picture.jpg

When trying to generate a pdf with the command:
latexmk -pdf template.tex

it fails due to the \born command:

! Undefined control sequence.
l.29 \born
          {4 July 1776}                                 % optional, remove /...

full output in file born-error-output.txt
malformatted pdf output in file born-error-output.pdf

Commenting out L29 seems to do the trick.

successful output in file success-output.txt
successful pdf in file success-output.pdf

PS: I'm not compiling the template.tex example inside the moderncv repo as stated in the beggining, the moderncv was installed using tlmgr.

$ tlmgr info moderncv
package:     moderncv
category:    Package
shortdesc:   A modern curriculum vitae class
longdesc:    The class provides facilities for typesetting modern curriculums vitae, both in a classic and in a casual style. It is fairly customizable, allowing you to define your own style by changing the colours, the fonts, etc. The template.tex file can be used as an example.
installed:   Yes
revision:    57496
sizes:       doc: 465k, run: 325k
relocatable: No
cat-version: 2.1.0
cat-license: lppl1.3c
cat-topics:  cv class
cat-contact-repository: https://github.com/moderncv/moderncv.git
cat-contact-home: https://github.com/moderncv/moderncv
cat-contact-development: https://github.com/moderncv
cat-contact-bugs: https://github.com/moderncv/moderncv/issues
collection:  collection-latexextra

When generating a PDF without setting \title{...} but only setting \name{Max}{Mustermann}, the title metadata of the PDF is set to Max Mustermann – , even though /usr/share/texmf-dist/tex/latex/moderncv/moderncv.cls uses \hypersetup{pdftitle = {\@firstname{}~\@lastname{}\notblank{\@title}{ -- \@title}{}}} and I would thus expect the title to be Max Mustermann only.

Minimal example:

\documentclass{moderncv}

\name{Max}{Mustermann}

\begin{document}
Text
\end{document}

❯ pdfinfo resume.pdf | grep -E '^Title:'
Title:           Max Mustermann – 

I use latexmk 4.70b and moderncv 2.1.0 from TeXLive 2021 to produce the PDF with following latexmkrc:

$pdf_mode = 4;

❯ grep Provides /usr/share/texmf-dist/tex/latex/moderncv/moderncv.cls
\ProvidesClass{moderncv}[2021/01/21 v2.1.0 modern curriculum vitae and letter document class]

❯ latexmk --version

Latexmk, John Collins, 29 September 2020. Version 4.70b

Per #97 (comment) and #97 (comment):

The links generated are completely broken with special characters: \social[twitter]{shadowmitia} gives https://twitter.com/shadowmitia \social[twitter]{jdoe_doé"o} gives https://twitter.com/jdoe_do\Uffffffff
Different sets of special characters seem to give the same result each time.

Stackoverflow allows special characters in usernames, which would break any social link pointing to a profile.
I'm guessing more websites allow more than just ASCII.
I'm guessing we would have issues with other alphabets (I'm thinking Asia alphabets, but Cyrillic would probably cause issues too, and so would others).

Note: The issue seems to have been fixed with the latest commit , but posting it for book keeping.

Hello,

I have downloaded the repo at the commit a2183b7 and uploaded the zip to Overleaf. It complied and generated the PDF for casual style. I changed the style to classic and there were errors. All the other styles worked without any issue.

The errors from overleaf were:

The problem is related to the line "\moderncvhead[\moderncvstyleheadoptions]{1}" in classic.sty. If 2 was passed instead of 1 it worked.

As discussed in #88, there was the idea to add an additional communication platform besides GitHub. One suggestion was to use a matrix.org channel.

This issue is for discussing this idea.

I wonder if anyone is using the cover letter feature, as template.tex puts it after the CV, and I believe it should be before the CV in the PDF. This can easily be solved by moving things around (I can send a PR for the template.tex if you like).

But for me, it would be necessary to be able to specify a subject line. There are a couple of suggestions floating around, on launchpad and stackexchange. What do you think?

Hello,

Thanks for taking this back into development. I realized there were updates after compiling my CV and seeing that some stuff were not working. i don't think is related with moderncv but probably the other packages I use.

Anyway, I spent weeks a few years ago tinkering with the class and adding some modifications that, in my opinion, extended its functionality. Among the stuff I did

• Added an extra parameter to the \section macro, to print a symbol from awesomefonts before the text. Like \faIndustry before Experience, \faGraduationCap before Education, etc
• Removed that symbol from the content placed in the outline of the output document
• Changed almost all macros to improve the text-only output from the PDF. I used pdftotext conversion for testing.

That last item took the bulk of my time. The goal was to improve the machine readability of the document. When people apply to a position, the HR system gets the PDF, converts it into pdf, and match it with the words contained in the job offer. When this score is high, the HR person might actually open the document. Otherwise, it's basically forgotten.

I was getting different scores using a CV evaluation tool, when the input was text only compared with the PDF generated by LaTeX. I uploaded a PDF generated with MS Word and the score was the same as the text only. It turns out that LaTeX ligatures and other formatting tricks makes it beautiful to the eye, but almost impossible to read to a dumb conversion script. For example, if they're looking for someone proficient with "MS Office", the LaTeX output will be "MS Office". The latter case has a ligature in the double ff, which will not match the job posting.

The automatic scores of my CV improved a lot with my changes, but the formatting was not perfect, mostly because the HR software don't use pdftotext. Instead, they have tools that basically open the PDF, select and copy the whole content, and dump it into a variable, formatted to who knows which encoding (probably ASCII, so screw my accents), and performs the comparison.

If you guys want my modifications for the fancy/cute sections, I could give them to you. No big deal, just a couple of lines. Not sure on what's the best way to do it. Never done a single git pull or commit in my life. The machine readability issue, I can share my progress, but is not fully working to my taste, because of the conversion issue mentioned previously. And I stopped the search for suitable options when I got my current job.

Thanks again for keeping this package alive

You've defined \link as

\newcommand*{\link}[2][]{%
  \ifthenelse{\equal{#1}{}}%
    {\href{#2}{#2}}%
    {\href{#2}{\detokenize{#1}}}}

Similar for all other commands, that internally use \href.

With this, something like:

\newcommand*{\test}{This is an often used text.}
\link[\test]{http://some.link.invalid}

is not possible (or would result in the not expected string \test in the output).

Moreover with pdfLaTeX all non US-ASCII-characters will break and even TeX commands for accents umlauts etc. break, e.g.

\documentclass[a4paper,11pt]{moderncv}
\moderncvstyle{casual}
\moderncvcolor{blue}

\usepackage[ngerman]{babel}
\usepackage[T1]{fontenc}
\usepackage{inputenc}
\usepackage[paper=a4paper,left=20mm,right=10mm,top=10mm,bottom=20mm]{geometry}
\firstname{John}
\familyname{Doe}

\begin{document}
\cvitem{10/2020 03/2021}{\textbf{Hilfreiche Links} \newline
\httplink[Göögle.com]{www.google.com} \newline
\httplink[Sehr hilfreich für Probleme]{golatex.de} \newline
\httplink[Sehr hilfreich f{\"u}r Probleme]{golatex.de} \newline
}
\end{document}

results in broken Umlauts like:

GÃűÃűgle.com
Sehr hilfreich fÃijr Probleme
Sehr hilfreich f{\"u}r Probleme

instead of the expected:

Göögle.com
Sehr hilfreich für Probleme
Sehr hilfreich für Probleme

IMO here the \detokenize does not make much sense, because the user would expect more, that commands work than that an underscore can be given by _ instead of the usual LaTeX underscore character command \_.

Moreover, it makes no sense, that \httplink[john_doe]{somewhere.invalid} should work but \httplink{somehwere.invalid/john_doe} doesn`t.

So please remove all these \detokenize. They break more than they help.

BTW: Can you please add some explicit information to the manual, that the mandatory argument of \httplink, \httpslink etc. should be without the prefix http:// etc. Because currently this information is only implicit from the example. Furthermore the command \weblink shown in the manual is not defined. Instead this is \link, which is not documented in the manual.

BTW: @ethuleau has already reported the issue here. But you've closed the whole issue without fixing it. So I've opened a new one.

The spacing between the marker and text is a bit tight for the cvlistitem. (I wanted the spacing to match the list Upon looking more into it, it looks like there's no canned way to handle this in the command itself. I accomplished what I wanted to by putting

\renewcommand{\cvlistitem}[2][.5ex]{\cvitem[#1]{}{\listitemsymbol\hspace{0.03in}\begin{minipage}[t]{\listitemcolumnwidth - 0.03in}#2\end{minipage}}}

in the preamble of my CV. Can this functionality be added to cvlistitem? (Ideally with the \hspace as a user defined argument with a default value) Thanks!!

If I try \moderncvstyle{fancy}, it tells me, that a } at the \cventry is too much, (which is wrong).
All other styles are working.

After upgrade from moderncv 2.1.0 to 2.2.0 I'm getting a lot of errors. Document was working without a problem with version 2.1.0.

xelatex can't find Latin Modern font family, despite it is installed (packages lm and lm-math):

[~]$ tlmgr install lm lm-math
tlmgr: package repository https://anorien.csc.warwick.ac.uk/mirrors/CTAN/systems/texlive/tlnet (verified)
tlmgr install: package already present: lm
tlmgr install: package already present: lm-math

Please consider the following MWE:

\documentclass{moderncv}
\moderncvstyle{casual}
\moderncvcolor{blue}

\firstname{First}
\lastname{Last}
\phone[mobile]{Mobile}
\phone[fixed]{Fixed}
\email{Email}
\social[github]{GitHub}

\usepackage[english]{babel}
% \renewcommand*{\footsymbol}{~~~{\textbullet}~~~}  % moderncvfooti.sty

\begin{document}
\makecvtitle
\section{Section}
\end{document}

Using an up-to-date TeX Live 2021, the code works as expected. However, it fails to compile if we change the language from English to Spanish, and the output includes some garbage with the text bullets in the footer.

Curiously, uncommenting the \renewcommand line fixes the issue. This line removes a \rmfamily from the command definition, and as a side effect, it prints the text bullets in italic.

I add the following line

\social[orcid]{xxxx-xxxx-xxxx-xxxx}

The id numbers show up, but no icon is in front.
Do I miss some dependency, or the icon hasn't been implement?

Thanks.

When recompiling a cv from the beginning of the year and after updating moderncv to version 2021/01/21 v2.1.0 I got the following error message:

LaTeX Error: Option clash for package inputenc.

Because I have a the following line in my code:
\usepackage[latin1]{inputenc}

After I commented the line 115 in moderncv.cls
\RequirePackage[utf8]{inputenc}
everything worked as before without a mistake.

The current fontawesome package seems to be unmaintained and starting to be out of date.

I'm suggesting to move over to fontawesome5 to gain access to newer icons and updates.

It's not a straightforward move, there have been changes to Font Awesome which makes things potentially tricky/annoying.
The free tier of fontawesome has all icons filled in, as opposed to what we have currently, where you see the background inside icons.
Because there are so many icons, I think we can even safely remove academicons in favor of fontawesome5 and have one package that controls everything (and would have the same appearance).

This is the new version of the icons by default

For comparion, this is what we have on master currently (apologies for the missing academic icons, I have an issue with that).

As far as I can tell, having a similar appearance to the old icons with the new package requires the Pro version of Font Awesome.

I don't think the new icons are that bad. But I'm wondering what other people think.

As a summary :

PROS:

• easy transition
• maintained package
• much more icons to use
• (optional) I think we can remove the academicons package in favour of just using fontawesome5.
• Other?

CONS

• Getting the previous style of icons requires PRO version of Font Awesome
• Adding PRO fonts support probably
• Other?

Tried to compile this sample code on my machine using xelatex (W10, new installation of miktex).

It gave an error " LaTeX Error: Command `\eth' already defined".

Here is the code:
\documentclass[english,12pt,a4paper,roman]{moderncv}

%% math and physics packages:
\usepackage{amsmath}
\usepackage{amssymb}

\usepackage[english]{babel}

%\usepackage{mathspec} % conflicts with 'unicode-math'
%\usepackage{fontspec} % is loaded automatically by 'unicode-math'

\RequirePackage{unicode-math}
\setmainfont{Calibri}
\setmathfont{Latin Modern Math}

\begin{document}
Hello World.
\end{document}

(Pretty sure it's moderncv's fault here, because when I change to article, everything works)

Changelog mentions addition of \moderncvhead, \moderncvbody, \moderncvfoot and \moderncvicons, but I can't seem to find usage instructions for them. Without much tex knowledge I didn't know where to put them and had to try at random to see what works.

Identify social icons which are only available with awesome (and by extension Xe/Lua(La)Tex) and add alternatives to marvosym

The first time it is defined at

And then later the exact same code can be found at

For example something like xdanaux#87.

Similar as twitter or github icon/link, should be interest modercv support a Google Scholar icon/link.
As example:

\social[scholar]{1bEOmkUAAAAJ}

In such examples, it produces following icon and link:

http://scholar.google.com.br/citations?user=1bEOmkUAAAAJ

Pagebreaks can happen immediately after a (sub)section header.
Reported as an issue on the original project here and here, and on StackOverflow.

Not sure if this is helpful, or if you plan on "importing" all the issues from the original project (if that's even possible).
I opened this because every time I change my CV, it messes up the pagebreaks again, but feel free to close it if this isn't helpful.

Thanks for reviving this project!!

Screenshot of the issue:

MWE:

\documentclass{moderncv}
\moderncvstyle{fancy}

\name{Foo}{Foo}

\begin{document}

\section{This, That and Those}
\cvlistitem{This is some text.}
\cvlistitem{This is some text.}
\cvlistitem{This is some text.}

\end{document}

This seems to happen with subsections too.

With v2.0 the icon of a social item like \social[github]{username} is not part of the link and thus not clickable. It would be better if it was part of the link.

It should behave less like

\extrainfo{\small\faGithub~\href{https://github.com/username}{username}}

and more like:

\extrainfo{\href{https://github.com/username}{\small\faGithub~username}}

To find trailing whitespaces and tabs instead of spaces.

I downloaded the package from https://ctan.org/pkg/moderncv?lang=en but when I try to run in TeXStudio on my macOS Big Sur, I get the error shown in the attached image. Will be glad if you assist.

On Debian sid/unstable with texlive-latex-base 2020.20210113-1,

$ pdflatex --version
pdfTeX 3.14159265-2.6-1.40.21 (TeX Live 2020/Debian)
kpathsea version 6.3.2
Copyright 2020 Han The Thanh (pdfTeX) et al.
There is NO warranty.  Redistribution of this software is
covered by the terms of both the pdfTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the pdfTeX source.
Primary author of pdfTeX: Han The Thanh (pdfTeX) et al.
Compiled with libpng 1.6.37; using libpng 1.6.37
Compiled with zlib 1.2.11; using zlib 1.2.11
Compiled with xpdf version 4.02

running pdflatex template.tex gives the error below.

[…]
ackage fancyhdr Warning: \footskip is too small (30.0pt): 
(fancyhdr)                Make it at least 95.20003pt, for example:
(fancyhdr)                \setlength{\footskip}{95.20003pt}.

[1{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map} <./picture.jpg>]
Overfull \hbox (0.79999pt too wide) in paragraph at lines 143--143
[][] 

Package fancyhdr Warning: \footskip is too small (30.0pt): 
(fancyhdr)                Make it at least 95.20003pt, for example:
(fancyhdr)                \setlength{\footskip}{95.20003pt}.

[2
! pdfTeX error (font expansion): auto expansion is only possible with scalable 
fonts.
<argument> ...shipout:D \box_use:N \l_shipout_box 
                                                  
l.181 \section{Extra 2}
                       
!  ==> Fatal error occurred, no output PDF file produced!
Transcript written on template.log.

On my CV and on compiling the template in the current repo, academic icons properly display except for the Researcher ID symbol.
I can load the academicons package on my system and compile with XeLaTeX to display it using the corrected call (pull request #28 - also verified the old call was wrong).

Can anyone reproduce this?

How add a table of contents at the beginning of a moderncv document?
The \tableofcontents command is not recognized by the class.

I work around the issue using the following code from internet[1].

% For issuing \makecvtitle more than once
\patchcmd{\makecvtitle}{\newlength{\makecvtitledetailswidth}}{\let\makecvtitledetailswidth\relax\newlength{\makecvtitledetailswidth}}{}{}
\patchcmd{\makecvtitle}{\newlength{\makecvtitlepicturewidth}}{\let\makecvtitlepicturewidth\relax\newlength{\makecvtitlepicturewidth}}{}{}

\newcommand{\part}[1]{%
% \phantomsection%
\addcontentsline{toc}{part}{#1}%
}

\makeatletter
\newcommand\@pnumwidth{1.55em}
\newcommand\@tocrmarg{2.55em}
\newcommand\@dotsep{8}
\newcommand\contentsname{Contents}
\setlength\columnsep{20pt}
\setcounter{tocdepth}{0}
\newcommand\tableofcontents{%
  \addtocontents{toc}{\protect\setcounter{tocdepth}{0}}
  \newbox{\makecvtitlenamebox}
  \savebox{\makecvtitlenamebox}{%
    \namestyle{\@firstname\ \@lastname}%
  }
  \section*{\contentsname}
  \@starttoc{toc}%
}
\usepackage{titletoc}
\titlecontents*{section}[0pt]
  {}{}{\textbullet}
  {\ \thecontentspage}[\\][]
\titlecontents{part}[0pt]
  {}{}{
    % \hspace*{5em}\normalsize
  }
  {\leaders\hbox{\normalfont$\m@th\mkern \@dotsep mu\hbox{.}\mkern \@dotsep mu$}\hfill\normalsize\thecontentspage
  % \hspace*{2em}
  }[]
\renewcommand\l@subsection[2]{}
\makeatother

[1] https://tex.stackexchange.com/questions/320193/class-moderncv-renewcommand-makecvtitle-results-in-undefined-control-sequence-e

I have a *.bib file, where the field with the year is date and not year, which results in the date not being displayed.

I read that the newer field date should get used since years.

Which is silently loaded by default (see line 115 of moderncv.cls). Why is that so? Why is it that the documentation makes no mention of this and even hints one can choose the proper encoding (see p. 2 top and the example in section 2.1)?

Hello, thanks for maintaining the moderncv package. I was updating from an old version and noticed a small issue with the \social command.

Some of my social accounts have an underscore, and to be able to compile the document, I had to escape the _ character like that:

\social[twitter]{my\_user}

However, this breaks the URL, which now points to https://twitter.com/my/protect%20_user

I solved it by changing the httpslink command to:

{\href{https://#2}{\detokenize{#1}}}}

And by not escaping the underscore:

\social[twitter]{my_user}

Not sure if that's the best solution, but it's working for now ;)

Cheers,
Bruno

It would be great to push a new updated version to the CTAN. Hopefully with the StackOverflow \social command included! 😇

Also the repository link at CTAN still points to Launchpad.

When using both natbib and multibib, the \bibliography does not appear as a subsection.
More precisely, the following code from moderncv.cls not work when using natbib.

\newcommand*{\bibliographyhead}[1]{\section{#1}}
 \AtEndPreamble{\@ifpackageloaded{multibib}{\renewcommand*{\bibliographyhead}[1]{\subsection{#1}}}{}}

I found this workaround:

\renewcommand{\bibsection}{\subsection{\bibname}}

For #37.

FontAwesome issue for Matrix: FortAwesome/Font-Awesome#12808
FontAwesome issue for Signal: FortAwesome/Font-Awesome#7434

Review and test xdanaux#66.

We should really rework the documentation.

See work in #58.

Hi all and thank you very much for your work to continue to support this nice package.

Lately, I was working on my curriculum and noticed the change from fontawesome to fontawesome5 (as a tex package maintainer myself, I see no problem there and agree the need to depend on well maintained packages).

However, as noticed in #20 and the related issue #19 that change push solid-looking icon where previously we add shape only ones. After a quick test on my own, I would like to suggest the following changes to make the switch to fontawesome5 almost invisible (i.e. use regular style when possible):

\renewcommand*{\labelitemi}{\strut\textcolor{color1}{\tiny\faCircle[regular]}}
\renewcommand*{\emailsymbol}{{\small\faEnvelope[regular]}~}
\renewcommand*{\homepagesymbol}{{\small\faGlobeAmerica}~} % alternative: \faGlobeEurope, \faGlobeAsia…
\renewcommand*{\mobilephonesymbol}{{\small\faMobile*}~}
\renewcommand*{\linkedinsocialsymbol}{{\small\faLinkedinIn}~}

Here is the rendering without my adjustements:

And after my proposal, how it looks like:

For memory purpose, here is the same snippet, as it appear on an old generated pdf (before switch to fontawesome5):

What do you think?

I want to use textbf to highligt different parts in the CV however this is ignored in the most recent version of Tex Live

This seems to be the case only for tex live distribution 2021 and not 2020.

I've tried to add telegram to socials, but I'm failed. Please, add it to icons