github/moderncv
1
0
Fork 0
mirror of https://github.com/moderncv/moderncv.git synced 2026-02-06 10:05:19 +01:00
Code Issues Projects Releases Packages Wiki Activity

Update user guide (#169)

Browse source 
* Rebase user guide additions onto master

Squash commits for adding user guide (#58)

merge typo fixes from github.com/ig0774/moderncv

set document encoding to utf8

move to inputenx package, remove pdflatex specific configurations to make everything compilable with lualatex

get documentation compilable with xelatex

get rough structure down and write how to read this manual

finish getting started section and give template description its own section

modify introduction to section two

get basic setup section done

add section on editing personal data

adjust code indendation of listings. Get rid of obsolete examples

rename some of the section headings to make them more consistent.

fix some typos

add version information to template and userguide

remove pdfs completely from repo

due to the new Makefile the pdf files have become obsolete in the repo.
The new release rule of the make file creates all templates and the user
guide and includes them into the tarball.
In this way even users for which the linux based Makefile does not work
can download precompiled examples and and the manual

start section on fine tuning styles

fix depricated comment explaining usage of \cvlistitem and \cvlistdoubleitem

add section explaining how to adjust symbols and itemize lables

add version information in title

fix formulations and typos

update package list with skillmatrix packages

explain previously hidden options for casual style

add bugs to known_bugs

add explanation on how to use babel to guide

add color explanation section

explain orphaned section problem

clean up old sections

refine color section

add macro descriptions of templates to user guide

add instructions how to add signature and subject

fix typo in changelog

add missing social links in section describing personal data

add missing social links in section describing how to change symbols

first user guide version

update README to latest local version

fix(moderncvheadiii.sty): remove /null at the end of the address header. (#60)

This removes the unnecesary newline there.

Move space after title into conditional

Don't break the title and quote formatting

Correct font loading

Signed-off-by: Stephan Lachnit <stephanlachnit@debian.org>

Remove baseurl in hyperref

Signed-off-by: Stephan Lachnit <stephanlachnit@debian.org>

Fix footskip for fancyhdr in template

Signed-off-by: Stephan Lachnit <stephanlachnit@debian.org>

Remove dot in cventry

Signed-off-by: Stephan Lachnit <stephanlachnit@debian.org>

CI: don't update sources

This only takes time and there aren't any relevant updates for us anyway.

Signed-off-by: Stephan Lachnit <stephanlachnit@debian.org>

CI: scan for horizontal and vertical bad boxes

Signed-off-by: Stephan Lachnit <stephanlachnit@debian.org>

Release v2.2.0

Signed-off-by: Stephan Lachnit <stephanlachnit@debian.org>

Mimic previous fontawesome look with fontawesome5 (#70)

See: https://github.com/moderncv/moderncv/issues/67

* Fix compile errors and warnings in user guide

* Remove trailing whitespace

* Overhaul README
Restructure README to remove references to the non-existent makefile

* Clean up user guide
- Fixes for spelling, wording, grammar, formatting, etc.
- Minor refactoring for code consistency

* Remove non-existent examples directory from gitignore

* Fix a space before a comma

* Update user guide PDF

* Cleaned up formatting and rewrote some sections

* Update changelog

Update changelog with changes made by all PRs merged since the last
tagged version, except for those invisible to the end user (changes to
CI workflow, changes overwritten by newer PRs, etc.)

Fixed formatting in changelog to be more consistent

Fixed grammar and punctuation in changelog

---------

Co-authored-by: David <forenkram@gmx.de>
This commit is contained in:
Tianyi Zheng 2024-04-17 16:29:57 -04:00 • committed by GitHub
commit f1fa580842
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
7 changed files with 1284 additions and 748 deletions
Download patch file Download diff file Expand all files Collapse all files

607
CHANGELOG
View file

@ -1,371 +1,385 @@
version 2.3.1 (2022-02-21) version 2.?.? (29 Jun 2023)
- Fix duplicate GitLab icon (#105) - Rewrote user guide, thanks to David Seus (#58, #169). The new user guide is
- Revert using detokenize in social links (#97) still incomplete.
- Fix broken compilation in classic style (#96) - Fixed "Underfull \hbox (badness 10000)" warning in \makecvtitle (#162).
- Fixed unnecessary academicons warning when academicons aren't used (#161).
- Fixed page counts unnecessarily linking to the last page of the PDF (#159).
- Added support for an optional signature in the cover letter (#157).
- Added support for non-ASCII characters in links (#155).
- Added option to force a homepage link to use HTTP rather than HTTPS (#154).
- Passed unicode option directly to hyperref to avoid conflicts with the
inclusion of hyperref by other packages (#148).
- Fixed the sender block on the cover letter in banking style (#146).
- Added option to classic style to align header elements at the top (#144).
- Added Twitch, YouTube, TikTok, Instagram, SoundCloud, Steam, Xbox, PlayStation
and Battle.net social icons (#131).
- Removed extra dash in PDF metadata when CV title is empty (#116).
- Added support for an optional subject line in the cover letter (#114).
- Added Discord social icon (#112).
- Replace instances of ~~~ in codebase with \hspace to be more compatible with
babel for Spanish (#109).
- Added Codeberg and Mastodon social icons (#107).
version 2.3.0 (2021-12-16) version 2.3.1 (21 Feb 2022)
- Remove font loading from class (#87) - Fix duplicate GitLab icon (#105).
- Add Matrix and Signal icon (#84) - Revert using detokenize in social links (#97).
- Improved symbol loading (#84) - Fix broken compilation in classic style (#96).
version: 2.2.0 (2021-07-28) version 2.3.0 (16 Dec 2021)
- Remove dot in cventry when using moderncvbodyi. - Remove font loading from class (#87).
- Add Matrix and Signal icon (#84).
- Improved symbol loading (#84).
version: 2.2.0 (28 Jul 2021)
- Remove dot in \cventry when using moderncvbodyi.
- Remove http baseurl in hyperref. - Remove http baseurl in hyperref.
- Change font encoding to use fontspec with Latin Modern for luatex and xetex, - Change font encoding to use fontspec with Latin Modern for LuaTeX and XeTeX,
else inputenc / fontenc / lmodern (https://tex.stackexchange.com/a/496643). else inputenc / fontenc / lmodern (https://tex.stackexchange.com/a/496643).
- Add birthdate field command. - Add birthdate field command.
- Add Social entries for WhatsApp, Signal and Matrix. - Add Social entries for WhatsApp, Signal and Matrix.
- Fix Researcher ID not showing (#29). - Fix Researcher ID not showing (#29).
- Make options 'symbols' and 'nosymbols' available to all styles to toggle whether - Make options "symbols" and "nosymbols" available to all styles to toggle
symbols should be used or not. Include symbols in oldstyle by default. whether symbols should be used or not. Include symbols in oldstyle by default.
- Migrate older newcommand syntax in moderncvcollection.sty to the xparse syntax. - Migrate older newcommand syntax in moderncvcollection.sty to xparse syntax.
- Fix resumé typo in template. Is now résumé. - Fix resumé typo in template. Is now résumé.
- Various other minor fixes. - Various other minor fixes.
version 2.1.0 (21 Jan 2021) version 2.1.0 (21 Jan 2021)
- maintainer change: now team maintained (https://github.com/moderncv), since - Maintainer change: now team maintained (https://github.com/moderncv), since
original repository is basically dead since 2016. original repository has been basically dead since 2016.
- new \social options: Xing, Skype, GitLab, Bitbucket, stack overflow, ORCID, - New \social options: Xing, Skype, GitLab, Bitbucket, stack overflow, ORCID,
ResearcherID, ResearchGate, Telegram and Google Scholar ResearcherID, ResearchGate, Telegram and Google Scholar.
- hyperlinks in phone numbers - Hyperlinks in phone numbers.
- switch from l3regex to expl3 - Switch from l3regex to expl3.
- new skill matrix feature - New skill matrix feature.
- move to fonawesome5 package - Move to fontawesome5 package.
- default to https - Default to https.
version 2.0.0 (28 Jul 2015) version 2.0.0 (28 Jul 2015)
- refactored the code into heads, body, foot and icon substyles. All styles - Refactored the code into heads, body, foot and icon substyles. All styles
(classic, casual, banking and oldstyle) are just a combination of these and (classic, casual, banking and oldstyle) are just a combination of these and
some font selection. Mixing substyles (e.g., the banking header with the some font selection. Mixing substyles (e.g., the banking header with the
classic body) is now trivial by using the \moderncvhead, \moderncvbody, classic body) is now trivial by using the \moderncvhead, \moderncvbody,
\moderncvfoot and \moderncvicons commands. Each of these take a substyle number \moderncvfoot and \moderncvicons commands. Each of these take a substyle
as argument. \moderncvcolor takes a color name as argument. number as argument. \moderncvcolor takes a color name as argument.
- added a new style, "fancy". - Added a new style: fancy.
- added an optional argument to \moderncvstyle to specify style options, i.e. - Added an optional argument to \moderncvstyle to specify style options, i.e.
\moderncvstyle[options]{style}. Below is a list of the available options per \moderncvstyle[options]{style}. Below is a list of the available options per
style: style:
* classic * classic
> to specify of one's name should appear left or right at the top: "left" > to specify where at the top one's name should appear: "left" (default) or
(default) or "right; "right;
* casual * casual
> to specify of one's name should appear left or right at the top: "left" > to specify where at the top one's name should appear: "left" (default) or
(default) or "right; "right;
* banking * banking
> to specify how the section- and subsectionrules should be set: > to specify how the section and subsection rules should be set:
"fullrules", "shortrules", "mixedrules" (default; full rules for sections, "fullrules", "shortrules", "mixedrules" (default; full rules for sections,
short rules for subsections), "centered" (fullrules with centered title) short rules for subsections), "centered" (fullrules with centered title)
and "norules" (norules, small caps font); and "norules" (norules, small caps font);
> to specify how the body should be aligned: left" (default), "center" or > to specify how the body should be aligned: left" (default), "center" or
"right"; "right";
* oldstyle & fancy * oldstyle & fancy
n/a > n/a
- added a new color variant: "burgundy". - Added a new color variant: "burgundy".
- corrected the color of \addressstyle to match the one effectively used - Corrected \addressstyle color to match the one effectively used (color2).
(color2). - Adjusted the bibliography spacing to handle entries with or without labels.
- adjusted the bibliography spacing to handle entries with or without labels. - Added a check on the emptiness of \title when setting the hyperref document
- added a check on the emptyness of \title when setting the hyperref document properties.
properties.
version 1.5.1 (29 Apr 2013) version 1.5.1 (29 Apr 2013)
- made sure that XeLaTeX or LuaLaTeX is in use before loading the awesome icon - Made sure that XeTeX or LuaTeX is in use before loading the awesome icon set
set and if not, revert to the marvosym icon set. and if not, revert to the marvosym icon set.
version 1.5.0 (23 Apr 2013) version 1.5.0 (23 Apr 2013)
- added a command to showcase social accounts in one's personal information: - Added a command to showcase social accounts in one's personal information:
\social. The command currently handles automatically LinkedIn, Twitter and \social. The command currently handles LinkedIn, Twitter and Github accounts
Github accounts, and other links can be provided explicitly. automatically, and other links can be provided explicitly.
- added a new icon set: "awesome" (using the icons from the Font Awesome font). - Added a new icon set: "awesome" (using the icons from the Font Awesome font).
- set the "awesome" icon set as the default for the "casual" and "banking" - Set the "awesome" icon set as the default for the casual and banking styles
style variants (can be changed back with \moderncvicons{marvosym}). (can be changed back with \moderncvicons{marvosym}).
- forced all the icons of the "letters" icon set to be of the same width, for - Forced all the icons of the "letters" icon set to be of the same width, for
alignment purpose. alignment purposes.
- added a letter icon ("W") for the homepage of the "letters" icon set. - Added a letter icon ("W") for the homepage of the "letters" icon set.
- forced some white space between the main text and the footer of the "casual" - Forced some whitespace between the main text and the footer of the casual
style variant. style.
- removed the rule below the headings of the cvcolumns environment. - Removed the rule below the headings of the cvcolumns environment.
version 1.4.0 (28 Mar 2013) version 1.4.0 (28 Mar 2013)
- deprecated \phone, \mobile and \fax in favour of \phone[<type>], where <type> - Deprecated \phone, \mobile and \fax in favour of \phone[<type>], where <type>
can be "fixed" (default), "mobile" or "fax". As part of the change, one can now can be "fixed" (default), "mobile" or "fax". As part of the change, one can
use each of these multiple times, to e.g. display multiple mobile phone numbers. now use each of these multiple times, e.g. to display multiple mobile phone
- deprecated \firstname and \familyname in favour of \name{<first>}{<last>}. numbers.
- added a new mechanism to select amongs different possible icon sets: - Deprecated \firstname and \familyname in favour of \name{<first>}{<last>}.
\moderncvicons{<iconsetname>}, where <iconsetname> can be "marvosym" (used by - Added a new mechanism to select amongs different possible icon sets:
default in the "banking", "casual" and "classic" style variants) or "letters" \moderncvicons{<iconsetname>}, where <iconsetname> can be "marvosym" (used by
(used by default in the "oldstyle" style variant). \moderncvicons should default in the banking, casual and classic styles) or "letters" (used by
always be called after \moderncvstyle in order to override the style variants default in the oldstyle style). \moderncvicons should always be called after
defaults. \moderncvstyle in order to override the styles' defaults.
- added a command to control the font of the page numbering: \pagenumberfont, - Added a command to control the font of the page numbering: \pagenumberfont, as
as requested by fr1a1nky (launchpad question #224496). requested by fr1a1nky (launchpad question #224496).
- removed the use of the suffix package. - Removed the use of the suffix package.
version 1.3.0 (09 Feb 2013) version 1.3.0 (09 Feb 2013)
- added a new environment to create multiple columns: cvcolumns. Each column - Added a new environment to create multiple columns: cvcolumns. Each column is
is then created by \cvcolumn[width]{header}{content}, where the optional width then created by \cvcolumn[width]{header}{content}, where the optional width is
is given as a fraction of the total width (between 0 and 1). The header and given as a fraction of the total width (between 0 and 1). The header and
content are robust and can contain any paragraph command (e.g., a nest itemize content are robust and can contain any paragraph command (e.g., a nested
environment). itemize environment).
- added a macro (\pdfpagemode) to control what is visible upon opening compiled - Added a macro (\pdfpagemode) to control what is visible upon opening compiled
pdfs (assuming pdf reader support), as suggested by U. Stöhr. PDFs (assuming PDF reader support), as suggested by U. Stöhr.
Possible values include: "UseNone" (only the document), "UseThumbs" (show Possible values include: "UseNone" (only the document), "UseThumbs" (show
thumbnails), "UseOutlines" (show bookmarks) and "FullScreen" (open in thumbnails), "UseOutlines" (show bookmarks) and "FullScreen" (open in
fullscreen mode). fullscreen mode).
- added a 3rd, fully optional (can be omitted or left blank) argument to - Added a 3rd, fully optional (can be omitted or left blank) argument to
\address to specify a country, as requested on launchpad (launchpad bug \address to specify a country, as requested on launchpad (launchpad bug
#1063995). #1063995).
- compacted list environments further. - Compacted list environments further.
- replaced the use of the xargs package by the xparse one. - Replaced the use of the xargs package by the xparse one.
version 1.2.1 (04 Dec 2012) version 1.2.1 (04 Dec 2012)
- fixed a regression bug introduced in version 1.2.0 in the header of the - Fixed a regression bug introduced in v1.2.0 in the header of the banking style
"banking" style when no title is used, as reported on tex.stackexchange when no title is used, as reported on tex.stackexchange (question #85427).
(question #85427).
version 1.2.0 (31 Oct 2012) version 1.2.0 (31 Oct 2012)
- updated the "banking" style header to include the option to show a title. - Updated the banking style header to include the option to show a title.
- set the values of \arrayrulewidth and \doublerulesep to their standard values - Set the values of \arrayrulewidth and \doublerulesep to their standard values
(0.4pt and 2pt resp.) to enable the drawing of rules in tabulars and arrays by (0.4pt and 2pt, respectively) to enable the drawing of rules in tabulars and
default. arrays by default.
- modified the code of \makecvtitle and \makelettertitle of the "casual" style - Modified the code of \makecvtitle and \makelettertitle of the casual style to
to avoid it to cause horizontal alignment issues after and before itself. avoid it causing horizontal alignment issues before and after itself.
- corrected a bug in \makelettertitle of most styles that displayed the current - Corrected a bug in \makelettertitle of most styles that displayed the current
date (\today) instead of the date given through the \date command, as reported date (\today) instead of the date given through the \date command, as reported
by B. Schlimmchen and S. Fnord. by B. Schlimmchen and S. Fnord.
- removed the need to set pdfpagelabels=false when loading hyperref, by putting - Removed the need to set pdfpagelabels=false when loading hyperref by putting
\pagenumbering{arabic} (to define \thepage) before loading hyperref, as figured \pagenumbering{arabic} (to define \thepage) before loading hyperref, as
out by J. Wolf. figured out by J. Wolf.
- corrected the line wrapping of \cvlistitem of the "banking" style. - Corrected the line wrapping of \cvlistitem of the banking style.
- corrected a bug in \makecvtitle and \makelettertitle of the "banking" style. - Corrected a bug in \makecvtitle and \makelettertitle of the banking style.
- removed an unwanted space in the footer of the "casual" style. - Removed an unwanted space in the footer of the casual style.
- moved the font style definitions to moderncv.cls for better readability - Moved the font style definitions to moderncv.cls for better readability
(moderncv.cls is meant to be a sort of header file, implementing only some (moderncv.cls is meant to be a sort of header file, implementing only some
macros shared by all styles and defining the macros that the style files need macros shared by all styles and defining the macros that the style files need
to implement). to implement).
version 1.1.3 (10 Aug 2012) version 1.1.3 (10 Aug 2012)
- corrected a longstanding issue causing hyperref to issue two warnings - Corrected a long-standing issue causing hyperref to issue two warnings about
regarding its "pdfpagelabels" option, as pointed out and solved by P. Leifeld its "pdfpagelabels" option, as pointed out and solved by P. Leifeld (launchpad
(launchpad bug #1035466). bug #1035466).
version 1.1.2 (09 Aug 2012) version 1.1.2 (09 Aug 2012)
- fixed a regression bug introduced in version 1.0.0 in the footer of the - Fixed a regression bug introduced in v1.0.0 in the footer of the casual style,
"casual" style, as discovered on tex.stackexchange (question #66316). as discovered on tex.stackexchange (question #66316).
version 1.1.1 (30 Jul 2012) version 1.1.1 (30 Jul 2012)
- fixed a compatibility issue introduced in version 1.0.0 when - Fixed a compatibility issue introduced in v1.0.0 when \maketitlenamewidth was
\maketitlenamewidth was renamed to \makecvtitlenamewidth, as reported by Peppe renamed to \makecvtitlenamewidth, as reported by Peppe on launchpad (launchpad
on launchpad (launchpad bug #1030802). The template now correctly uses bug #1030802). The template now correctly uses \makecvtitlenamewidth, and
\makecvtitlenamewidth, and \maketitlenamewidth was created as an alias for \maketitlenamewidth was created as an alias forbackward compatibility.
backward compatibility.
version 1.1.0 (29 Jul 2012) version 1.1.0 (29 Jul 2012)
- fixed the switching from letter to resume, correcting spacing errors when a - Fixed the switching from letter to resume, correcting spacing errors when a
letter is typeset before the resume, as noticed by U. Gabor. letter is typeset before the resume, as noticed by U. Gabor.
- fixed the vertical alignment of the footers, as reported by T. Homa. - Fixed the vertical alignment of the footers, as reported by T. Homa. Footers
Footers are now aligned to the bottom and the letter and cv footers are are now aligned to the bottom and the letter and CV footers are perfectly
perfectly aligned in the "casual" style. aligned in the casual style.
- prepared moderncv for fontspec font loading (still commented in code). - Prepared moderncv for fontspec font loading (still commented out in code).
- changed the handling of the "sans" and "roman" class options, to be reflected - Changed the handling of the "sans" and "roman" class options, to be reflected
at the beginning of the document and override style font choices. at the beginning of the document and override style font choices.
- turned unicode support in hyperref on by default. - Turned unicode support in hyperref on by default.
- tweaked the use of \textbullet to avoid the fall-back to Computer Modern - Tweaked the use of \textbullet to avoid a fallback to Computer Modern fonts
fonts and prepared the use of symbols from the MarVoSym font for fontspec and prepared the use of symbols from the MarVoSym font for fontspec (LuaTeX or
(LauLaTeX or XeLaTeX). XeTeX).
- tweaked the \subsectionfill of the "banking" style to distribute extra space - Tweaked the \subsectionfill of the banking style to distribute extra space
evenly between leaders. evenly between leaders.
- added two options to change the "Enclosure" string used for the letter - Added two options to change the "Enclosure" string used for the letter
enclosure: either specify another string as optional argument to \enclosure, enclosure: either specify another string as an optional argument to \enclosure
or redefine \enclname, as suggested by D. Wille. or redefine \enclname, as suggested by D. Wille.
version 1.0.0 (26 Mar 2012) version 1.0.0 (26 Mar 2012)
- added commands to generate letters for every resume style: \recipient, \date, - Added commands to generate letters for every resume style: \recipient, \date,
\opening, \closing, \enclosure, \makelettertitle and \makeletterclosing. The \opening, \closing, \enclosure, \makelettertitle and \makeletterclosing. The
old \maketitle and \makefooter commands are now deprecated and replaced by old \maketitle and \makefooter commands are now deprecated and replaced by
\makecvtitle and \makecvfooter. \makecvtitle and \makecvfooter.
- changed the alignment algorithm for the personal data display in the oldstyle - Changed the alignment algorithm for the personal data display in the oldstyle
style, as to align on the baseline of the first line with the surrounding text. style, to align on the baseline of the first line with the surrounding text.
version 0.19.0 (06 Feb 2012) version 0.19.0 (06 Feb 2012)
- reintroduced the ability to force the width reserved to display the name - Reintroduced the ability to force the width reserved to display the name in
in the resume header for the classic style (\maketitlenamewidth). the resume header for the classic style (\maketitlenamewidth).
- improved the pdf metadata, as reported by S. Wunsch (launchpad bug #922476). - Improved the PDF metadata, as reported by S. Wunsch (launchpad bug #922476).
- fixed a footersymbol bug in the casual style when no mobile number was given, - Fixed a \footersymbol bug in the casual style when no mobile number was given,
as reported by S. Wunsch (launchpad bug #922470). as reported by S. Wunsch (launchpad bug #922470).
- fixed a display bug when an address was given without postcode/city, as - Fixed a display bug when an address was given without postcode/city, as
reported by O. Shaneh (launchpad bug #670263). reported by O. Shaneh (launchpad bug #670263).
version 0.18.0 (05 Feb 2012) version 0.18.0 (05 Feb 2012)
- corrected the handling of pdf bookmarks, as suggested on stackexchange by - Corrected the handling of PDF bookmarks, as suggested on stackexchange by
U. Fischer. U. Fischer.
- improved the spacing between sections and subsections by using \addvspace - Improved the spacing between sections and subsections by using \addvspace
instead of \vspace. instead of \vspace.
- corrected the spacing between entries with nested itemize environments - Corrected the spacing between entries with nested itemize environments
(temporary solution working only for single line items). (temporary solution working only for single line items).
- added a check in the oldstyle style for an empty 4th argument in the - Added a check in the oldstyle style for an empty 4th argument in the
\cvdoubleitem definition, to avoid printing a colon without preceding label. \cvdoubleitem definition to avoid printing a colon without a preceding label.
- added a new style on top of classic, casual and oldstyle: banking. - Added a new style on top of classic, casual and oldstyle: banking.
version 0.17.0 (25 Jan 2012) version 0.17.0 (25 Jan 2012)
- changed the footer algorithm of style casual to avoid starting lines with - Changed the footer algorithm of the casual style to avoid starting lines with
the footer symbol. the footer symbol.
- aligned the space before and after the title across styles. - Aligned the space before and after the title across styles.
- added an optional title to the casual style. - Added an optional title to the casual style.
- changed the definition of the font styles to avoid undesired extra spacing. - Changed the definition of the font styles to avoid undesired extra spacing.
- added a Spanish template, kindly provided by I. Buitrón. - Added a Spanish template, kindly provided by I. Buitrón.
- corrected the vertical misalignment between the page number and the center - Corrected the vertical misalignment between the page number and the center
footer in the casual style. footer in the casual style.
version 0.16.0 (15 Jan 2012) version 0.16.0 (15 Jan 2012)
- added starred versions of \section and \subsection (that are identical to - Added starred versions of \section and \subsection that are identical to their
their non-starred version, to e.g. enable biblatex support as requested by non-starred versions (e.g. to enable BibLaTeX support) as requested by
S. Verberkt (launchpad bug #913102). S. Verberkt (launchpad bug #913102).
- corrected a misalignment of the colored rule in front of the section titles - Corrected a misalignment of the colored rule in front of the section titles in
in the classic and casual styles, as reported by P. Neidhardt (launchpad bug the classic and casual styles, as reported by P. Neidhardt (launchpad bug
#915910). #915910).
version 0.15.1 (23 December 2011) version 0.15.1 (23 December 2011)
- corrected a bug in the classic style causing the address font and color not - Corrected a bug in the classic style causing the address font and color to not
being carried over newlines, as reported by J. Smith. be carried over newlines, as reported by J. Smith.
version 0.15.0 (19 December 2011) version 0.15.0 (19 December 2011)
- corrected list spacing. - Corrected list spacing.
- corrected inconsistent use of sans serif fonts in roman layout option. - Corrected inconsistent use of sans serif fonts in roman layout option.
- the lmodern fonts are now automatically loaded only if installed on the - The lmodern fonts are now automatically loaded only if they're installed on
system. The "nolmodern" option is now therefore obsolete. the system. The "nolmodern" option is now therefore obsolete.
- complete code refactoring separating themes in separate styles and colors. - Completed code refactoring separating themes in separate styles and colors.
- renamed \cvline to \cvitem, \cvlanguage to \cvitemwithcomment and \cvcomputer - Renamed \cvline to \cvitem, \cvlanguage to \cvitemwithcomment and \cvcomputer
to \cvdoubleitem (the old command name still work and redirect to the new ones, to \cvdoubleitem (the old command names still work and redirect to the new
but are deprecated). ones, but are deprecated).
- removed the arbitrary minipage widths of skill proficiency vs comment in - Removed the arbitrary minipage widths of skill proficiency vs comment in
\cvitemwithcomments. The skill proficiency is now typeset exactly as given \cvitemwithcomments. The skill proficiency is now typeset exactly as given
(i.e. one one line if no linebreaks are implicitly given) and the comment uses (i.e. one one line if no linebreaks are implicitly given) and the comment uses
the remaining horizontal space. the remaining horizontal space.
- changed the optional argument of \cvlistitem and \cvlistdoubleitem to specify - Changed the optional argument of \cvlistitem and \cvlistdoubleitem to specify
the vertical skip after the item (as for \cvitem, cvitemwithcomments, etc). the vertical skip after the item (as for \cvitem, \cvitemwithcomments, etc).
The way to change the list symbol is to redefine \listitemsymbol. The way to change the list symbol is to redefine \listitemsymbol.
- added a new style on top of classic and casual: oldstyle. - Added a new style on top of classic and casual: oldstyle.
- loaded the microtype package to improve typography. - Loaded the microtype package to improve typography.
version 0.14.0 (04 December 2011) version 0.14.0 (04 December 2011)
- added support for CJK, thanks to the help of P. D'Apice. - Added support for CJK, thanks to the help of P. D'Apice.
- the use of \recomputelengths after modifying any length in the preamble is - The use of \recomputelengths after modifying any length in the preamble is now
now unnecessary; \recomputelength is automatically called at the start of the unnecessary; \recomputelength is automatically called at the start of the
document. document.
version 0.13.1 (11 November 2011) version 0.13.1 (11 November 2011)
- corrected a bug introduced by v0.13 in the classic style when no \photo is - Corrected a bug introduced by v0.13 in the classic style when no \photo is
used, as reported by S. Gislais (launchpad bug #888702). used, as reported by S. Gislais (launchpad bug #888702).
version 0.13.0 (06 November 2011) version 0.13.0 (06 November 2011)
- added a "black" color option to render the resume in black & white, as - Added a "black" color option to render the resume in black & white, as
suggested by F. Bicarri. suggested by F. Bicarri.
- removed the pdflatex option when loading hyperref to enable other engines - Removed the pdflatex option when loading hyperref to enable other engines
(e.g., dvips, xetex), leftover from the v 0.11 cleanup, as reported by (e.g., dvips, XeTeX), leftover from the v0.11 cleanup, as reported by
K. Amaterasu and P. Mavrogiorgos (launchpad bugs #754693 and #859834). K. Amaterasu and P. Mavrogiorgos (launchpad bugs #754693 and #859834).
- added a "purple" color option, as proposed by B. Ravel. - Added a "purple" color option, as proposed by B. Ravel.
- added a 3rd optional argument to the \photo command to control the thickness - Added a 3rd optional argument to the \photo command to control the thickness
of the framebox. Setting it to 0pt will disable the frame around the photo, as of the framebox. Setting it to 0pt will disable the frame around the photo, as
requested by T. Krennwallner (launchpad bug #664568). requested by T. Krennwallner (launchpad bug #664568).
version 0.12.0 (03 August 2010) version 0.12.0 (03 August 2010)
- prevented pagebreaks after sections and subsections (launchpad bug #409902), - Prevented pagebreaks after sections and subsections (launchpad bug #409902),
as originally reported by C. Gaspoz and fixed by launchpad user tentotwo). as originally reported by C. Gaspoz and fixed by launchpad user tentotwo.
version 0.11.0 (20 July 2010) version 0.11.0 (20 July 2010)
- removed the \ifpdf check when loading the graphicx package, as graphicx does - Removed the \ifpdf check when loading the graphicx package, as graphicx
does check internally and this was preventing proper functionning with xelatex already does this check internally. This was preventing proper functioning
and luatex, as reported by A. Trautmann. The same check was also removed with XeTeX and LuaTeX, as reported by A. Trautmann. The same check was also
everywhere else in the document (i.e. when loading the color and hyperref removed everywhere else in the document (i.e. when loading the color and
packages). hyperref packages).
version 0.10.0 (13 June 2010) version 0.10.0 (13 June 2010)
- fixed a compatibility issue with the natbib package (natbib uses \section* - Fixed a compatibility issue with the natbib package (natbib uses \section* to
to format the bibliography title, while only \section was defined by format the bibliography title, while only \section was defined by moderncv),
moderncv), as reported on launchpad (launchpad bug #393920). as reported on launchpad (launchpad bug #393920).
- fixed a compatibility issues with (any package relying on) the etoolbox - Fixed compatibility issues with (any package relying on) the etoolbox package,
package, due to the double definition of \AtEndPreamble, as reported by due to the double definition of \AtEndPreamble, as reported by D. Becker.
D. Becker.
version 0.9.0 (31 May 2010) version 0.9.0 (31 May 2010)
- added support for the itemize, enumerate and description environments. - Added support for the itemize, enumerate and description environments.
version 0.8.0 (24 May 2010) version 0.8.0 (24 May 2010)
- added support for multibib. Also modified the template to illustrate how to - Added support for multibib. Also modified the template to illustrate how to
show labels in the bibliography, as requested by Tom D. R. and Stefan K. show labels in the bibliography, as requested by Tom D. R. and Stefan K.
- added a command to indicate your personal homepage (\homepage{url}), as - Added a command to indicate your personal homepage (\homepage{url}), as
requested by J. de Jong and A. Pairet. requested by J. de Jong and A. Pairet.
- corrected an alignment bug for text following a \quote with no immediate - Corrected an alignment bug for text following a \quote with no immediate
\section, as kindly reported by J. Vermeulen and L. Saliou. \section, as kindly reported by J. Vermeulen and L. Saliou.
- corrected a spacing bug when no blank line (or \par) is left after - Corrected a spacing bug when no blank line (or \par) is left after \maketitle.
\maketitle. Thanks to A. Menzel for reporting the strange behaviour. Thanks to A. Menzel for reporting the strange behaviour.
- corrected the alignment of the extrainfo title part when no picture was - Corrected the alignment of the \extrainfo title part when no picture was used,
used, as reported by M. Bana. as reported by M. Bana.
- corrected the missplacement of pdf bookmarks as noticed by L. Fortunato. - Corrected the misplacement of PDF bookmarks as noticed by L. Fortunato.
- corrected several bugs linked to the code for checking for empty arguments - Corrected several bugs linked to the code for checking for empty arguments in
in \cventry, as reported by B. Ekran (launchpad bug #268768), L. Păncescu and \cventry, as reported by B. Ekran (launchpad bug #268768), L. Păncescu and
E. Gregorio. E. Gregorio.
version 0.7.0 (17 June 2008) version 0.7.0 (17 June 2008)
- corrected an outstanding spacing bug (space between cvlines longer - Corrected an outstanding spacing bug where the space between cvlines was
than 1 line). longer than 1 line.
- removed the need to use \closesection and \emptysection as internal - Removed the need to use \closesection and \emptysection as internal tabulars
tabulars are now always closed. This allows she use of bibliography packages are now always closed. This allows the use of bibliography packages such as
such as bibunits. Thanks to S. Busch for pointing out the incompatibility and bibunits. Thanks to S. Busch for pointing out the incompatibility and helping
helping testing out the bug correction. test out the bug correction.
- changed the definition of \photo: the first (optional) argument should - Changed the definition of \photo: the first (optional) argument should give
give the desired width of the picture, instead of its height the desired width of the picture, instead of its height
- corrected an alignment bug for \cvlistitems longer than 1 line, as - Corrected an alignment bug for \cvlistitems longer than 1 line, as reported by
reported by S. Nikolopoulos. S. Nikolopoulos.
- deprecated the commands \sethintscolumnlength and \sethintscolumntowidth. - Deprecated the commands \sethintscolumnlength and \sethintscolumntowidth.
Instead, just set \hintscolumnwidth to the desired length by using the regular Instead, just set \hintscolumnwidth to the desired length by using the regular
\setlength or \settowidth commands, and call \recomputelengths. \setlength or \settowidth commands, and call \recomputelengths.
- added the ability to control the width of the name placeholder in the - Added the ability to control the width of the name placeholder in the classic
classic theme, by setting the length \maketitlenamewidth. Again, don't forget theme, by setting the length \maketitlenamewidth. Again, don't forget to call
to call \recomputelengths afterward. \recomputelengths afterward.
version 0.6.0 (28 May 2007) version 0.6.0 (28 May 2007)
- corrected some spacing bugs and cleaned up the code. - Corrected some spacing bugs and cleaned up the code.
- corrected a bug in the bibliography file of the examples spotted by - Corrected a bug in the bibliography file of the examples spotted by U. Stöhr.
- Added color variants to the classic and casual styles, as suggested by
U. Stöhr. U. Stöhr.
- added color variants to the classic and casual style, as suggested by - Added a page counter for resumes running longer than 1 page, as requested by
U. Stöhr.
- added a page counter for resumes running longer than 1 page, as requested by
A. Martin. It can be disabled by the command \nopagenumbers{}. A. Martin. It can be disabled by the command \nopagenumbers{}.
- added commands to include a mobile phone and fax number. - Added commands to include a mobile phone and fax number.
- made the symbols used for the phone number, the email, ... customizable. - Made the symbols used for the phone number, the email etc. customizable. To
To modify those symbols, just redefine \phonesymbol, emailsymbol, ... modify those symbols, just redefine \phonesymbol, \emailsymbol etc.
- corrected the pdf information given to hyperref as pointed out by - Corrected the PDF information given to hyperref as pointed out by C. Knuepfer.
C. Knuepfer. - Rewrote the examples.
- rewrote the examples.
version 0.5.0 (9 September 2006) version 0.5.0 (9 September 2006)
- added a \photo command to display a picture. That command takes the name of - Added a \photo command to display a picture. This command takes the name of
the file with the picture as argument, and the desired height as optional the file with the picture as a required argument and the desired height as an
argument. optional argument.
- implemented the needed commands to make moderncv compatible with BibTeX, as - Implemented the needed commands to make moderncv compatible with BibTeX, as
suggested by J. Lie. This makes it possible to display one's publications, suggested by J. Lie. This makes it possible to display one's publications,
stored in the BibTeX file 'publications.bib' stored in the BibTeX file "publications.bib" by using:
by using:
\nocite{*} \nocite{*}
\bibliographystyle{plain} \bibliographystyle{plain}
\bibliography{publications} \bibliography{publications}
As usual, the name of the section title can be changed by redefining the As usual, the name of the section title can be changed by redefining \refname.
command \refname. - Added the \today command, useful for example if one needs to add the date the
- added the \today command, useful for example if one need to add the date the resume was produced with:
resumé was produced with
\closesection{} \closesection{}
\vfill{\hfill{\scriptsize Produced \today.}} \vfill{\hfill{\scriptsize Produced \today.}}
at the end of your CV, as suggested by F. Hammann. at the end of your CV, as suggested by F. Hammann.
version 0.4.0 (2 May 2006) version 0.4.0 (2 May 2006)
- removed the dependency on the geometry package, so that users can now invoke - Removed the dependency on the geometry package so that users can now invoke it
it themselve, and easily change the geometry of the page. themselves and easily change the geometry of the page.
version 0.3.0 (10 April 2006) version 0.3.0 (10 April 2006)
- moderncv now uses the 'longtable' class, allowing cv sections to split - Moderncv now uses the longtable class, allowing CV sections to split across
across multiple pages. multiple pages.
- the different lengths used by moderncv are now customizable! In particular, - The different lengths used by moderncv are now customizable! In particular,
the first column (the one containing the date in the examples), can now be set the first column (the one containing the date in the examples) can now be set
to any width, for people needing a smaller or larger one. To do that, either to any width, for people needing a smaller or larger one. To do that, either
use use
\sethintscolumnlength{<length>}, \sethintscolumnlength{<length>},
@ -374,33 +388,32 @@ version 0.3.0 (10 April 2006)
where <string> is a string of the desired length (usually, the longest string where <string> is a string of the desired length (usually, the longest string
that has to appear in the column). Thanks to A. Pöge for pointing out the need that has to appear in the column). Thanks to A. Pöge for pointing out the need
of such a feature. of such a feature.
- added the command \emptysection{}, which makes it possible to start a - Added the command \emptysection{}, which makes it possible to start an unnamed
section without name. In combination with \closesection{}, this makes it section. In combination with \closesection{}, this makes it possible to drop
possible to drop out of the layout of moderncv, and come back to it later. out of the layout of moderncv, and come back to it later. This should make the
This should make the inclusion of arbitrary elements not covered by moderncv inclusion of arbitrary elements not covered by moderncv code possible.
code possible. - Corrected a spacing problem in the \cventry command, as pointed out and solved
- corrected a spacing problem in the cventry command, as pointed out and by B. Eßmann.
solved by B. Eßmann.
version 0.2.0 (6 March 2006) version 0.2.0 (6 March 2006)
- rewrite of the code to have the styles (fonts, colours, headers and footers) - Rewrite of the code to have the styles (fonts, colours, headers and footers)
be defined in different files than the class. The styles are now defined in a be defined in different files than the class. The styles are now defined in a
separate file per style, named moderncvstyle<style_name>. It should now be separate file per style, named moderncvstyle<style_name>. It should now be
easy to write your own style, starting from moderncvstyleempty.sty. If you easy to write your own style, starting from moderncvstyleempty.sty. If you
feel you have created a nice style, just email it to me and I'll include it in feel you have created a nice style, just email it to me and I'll include it in
the next version. the next version.
- due to the previous point, styles are now loaded by the command - Due to the previous point, styles are now loaded by the command
\moderncvstyle{style_name}. I couldn't figure out a way to preserve the old \moderncvstyle{style_name}. I couldn't figure out a way to preserve the old
"casual" and "classic" class options, so these are now broken! Use "casual" and "classic" class options, so these are now broken! Use
\moderncvstyle{casual} or \moderncvstyle{classic} at the beginning of your \moderncvstyle{casual} or \moderncvstyle{classic} at the beginning of your
document. This should be the only incompatibility with version 0.1. document. This should be the only incompatibility with v0.1.
- added class option "nolmodern" for people without the latin modern fonts. - Added class option "nolmodern" for people without the Latin Modern fonts.
- corrected some English mistakes in the examples. Thanks to M. H. Prager for - Corrected some English mistakes in the examples. Thanks to M. H. Prager for
pointing them out. pointing them out.
- added a \cvlistitem to produce items with a bullet (or whatever is defined - Added a \cvlistitem to produce items with a bullet (or whatever is defined in
in \listitemsymbol), and renamed \cvresume to \cvlistdoubleitem for \listitemsymbol), and renamed \cvresume to \cvlistdoubleitem for consistency
consistency purpose. For compatibility reasons, the command \cvresume still purposes. For compatibility reasons, the command \cvresume still works, but
works, but should be avoided. should be avoided.
version 0.1.0 (1 March 2006) version 0.1.0 (1 March 2006)
- first release. - First release.

27
KNOWN_BUGS
View file

@ -1,15 +1,12 @@
- When using the "fancy" style, undesired space is added between the bibliography - moderncv is incompatible with biber.
head and the first entry, as well as after the last entry - moderncv is incompatible with BibLaTeX.
- Moderncv is incompatible with biblatex. - moderncv is incompatible with babel in Spanish.
- Footnotes generates errors (though the output seem correct when running with
"-interaction=nonstopmode") - Skill matrices don't break automatically in fancy style.
- When using CJK, the last \clearpage required for fancyhdr to work properly kills - Long names break the oldstyle style and possibly other styles (needs testing).
the "lastpage" counter, hence also the page numbering. - Long URLs in classic style can make the name break line. Fixed width for the address part must be implemented.
- Moderncv produces an error ("lonely \item--perhaps a missing list environment") - When using the fancy style, undesired space is added between the bibliography head and the first entry, as well as after the last entry.
when used with bibentry, through the output is actually correct. Amongst other, - Footnotes generate errors, but the output seems correct when running with "-interaction=nonstopmode"
this causes compilation by LyX to stop. - When using CJK, the last \clearpage required for the fancyhdr package to work properly kills the "lastpage" counter, and therefore also the page numbering.
- The space after a cventry gets eaten up when the last argument contains a nested - moderncv produces an error "lonely \item--perhaps a missing list environment" when used with the bibentry package, though the output is actually correct. Among other things, this causes compilation by LyX to stop.
itemize environment. An ugly hack and incomplete solution was implemented by - The space after a \cventry gets eaten up when the last argument contains a nested itemize environment. An ugly hack and incomplete solution was implemented by including a \strut in every item label, but this doesn't solve the problem for multi-line items. Ideally, the \strut should end the item, but there seems to be no way to do this.
including a \strut in every item label, but this doesn't solve the problem for
multi-line items. Ideally, the strut should end the item, but there seems to be
no way to do this.

51
README.md
View file

@ -1,27 +1,44 @@
# moderncv # moderncv
## A modern curriculum vitae class for LaTeX
**moderncv** provides a documentclass for typesetting curricula vitae in various styles. Moderncv aims to be both straightforward to use and customizable, providing five ready-made styles (classic, casual, banking, oldstyle and fancy) and allowing one to define his own by modifying colors, fonts, icons, etc.
Most commands are defined in such a way that arguments are optional.
Until a decent manual is written, one can always look in the `template.tex` file for an example. It can be compiled to pdf via `latexmk -pdf ./template.tex`.
If using [`academicons`](https://ctan.org/tex-archive/fonts/academicons) in the template, you need to use a Xe(La)TeX or Lua(La)TeX engine for them to render. Otherwise an alternative will be used automatically.
## Development
[![Build template](https://github.com/moderncv/moderncv/actions/workflows/build-pdf.yml/badge.svg)](https://github.com/moderncv/moderncv/actions/workflows/build-pdf.yml) [![Build template](https://github.com/moderncv/moderncv/actions/workflows/build-pdf.yml/badge.svg)](https://github.com/moderncv/moderncv/actions/workflows/build-pdf.yml)
[![CTAN](https://img.shields.io/ctan/v/moderncv.svg)](https://www.ctan.org/pkg/moderncv) [![CTAN](https://img.shields.io/ctan/v/moderncv.svg)](https://www.ctan.org/pkg/moderncv)
[![Matrix](https://img.shields.io/matrix/moderncv:matrix.org)](https://matrix.to/#/#moderncv:matrix.org) [![Matrix](https://img.shields.io/matrix/moderncv:matrix.org)](https://matrix.to/#/#moderncv:matrix.org)
As the main goal is to keep this package alive, it is maintained in a loosely structured team. You can contact us in our matrix room [moderncv:matrix.org](https://matrix.to/#/#moderncv:matrix.org), feel free to join if you have questions or want to contribute. Development takes place at [github.com/moderncv/moderncv](https://github.com/moderncv/moderncv). ## A modern curriculum vitae class for LaTeX
The `moderncv` package provides a document class for typesetting applications (curricula vitae and cover letters) in various styles. `moderncv` aims to be both straightforward to use and customizable, providing five ready-made styles (classic, casual, banking, oldstyle and fancy) and allowing you to define your own by modifying colors, fonts, icons, etc.
## Getting started
### Installation
`moderncv` should already be included in your installed LaTeX distribution.
If not, you can get the tarball of the package from [CTAN](https://www.ctan.org/pkg/moderncv).
Alternatively, you can also build the package from source by cloning the its [GitHub repository](https://github.com/moderncv/moderncv) and compiling the included LaTeX files:
```
latexmk -pdf ./template.tex manual/moderncv_userguide.tex
```
### Usage
To get started on your own CV, use and modify the template file `template.tex`.
The user guide can be found in the folder `manual` and contains additional information on what the document class offers.
Take a look at it to see if this package suits your needs.
If you are using the [`academicons`](https://ctan.org/tex-archive/fonts/academicons) package in the template, you will need to use a Xe(La)TeX or Lua(La)TeX engine to render the icons. Otherwise, an alternative icon package will be used automatically.
## Development
As the main goal is to keep this package alive, it is maintained in a loosely structured team.
You can contact us in our matrix room [moderncv:matrix.org](https://matrix.to/#/#moderncv:matrix.org), feel free to join if you have questions or want to contribute.
Development takes place at [github.com/moderncv/moderncv](https://github.com/moderncv/moderncv).
## Licence ## Licence
moderncv is licensed under the [LPPL-1.3c](https://spdx.org/licenses/LPPL-1.3c.html).
`moderncv` is licensed under the [LPPL-1.3c](https://spdx.org/licenses/LPPL-1.3c.html).
## Origin ## Origin
Original author: Xavier Danaux <xdanaux@gmail.com><br/>
Original repository: https://github.com/xdanaux/moderncv<br/> Original author: Xavier Danaux <xdanaux@gmail.com>
This repository is a fork aiming to maintain moderncv inside CTAN, since upstream is dead since 2016. <br/>
Original repository: https://github.com/xdanaux/moderncv
This repository is a fork aiming to maintain `moderncv` inside CTAN, since upstream has been dead since 2016.

BIN
manual/moderncv_userguide.pdf
View file

Binary file not shown.

1310
manual/moderncv_userguide.tex
View file

File diff suppressed because it is too large Load diff

4
moderncv.cls
View file

@ -553,11 +553,11 @@
\newcommand*{\cvdoubleitem}[5][.25em]{} \newcommand*{\cvdoubleitem}[5][.25em]{}
% makes a resume line with a list item % makes a resume line with a list item
% usage: \cvlistitem[label]{item} % usage: \cvlistitem[spacing]{item}
\newcommand*{\cvlistitem}[2][\listitemsymbol]{} \newcommand*{\cvlistitem}[2][\listitemsymbol]{}
% makes a resume line with 2 list items % makes a resume line with 2 list items
% usage: \cvlistdoubleitem[label]{item1}{item2} % usage: \cvlistdoubleitem[spacing]{item1}{item2}
\newcommand*{\cvlistdoubleitem}[3][\listitemsymbol]{} \newcommand*{\cvlistdoubleitem}[3][\listitemsymbol]{}
% makes a typical resume job / education entry % makes a typical resume job / education entry

1
template.tex
View file

@ -16,7 +16,6 @@
% adjust the page margins % adjust the page margins
\usepackage[scale=0.75]{geometry} \usepackage[scale=0.75]{geometry}
\setlength{\footskip}{149.60005pt} % depending on the amount of information in the footer, you need to change this value. comment this line out and set it to the size given in the warning
%\setlength{\hintscolumnwidth}{3cm} % if you want to change the width of the column with the dates %\setlength{\hintscolumnwidth}{3cm} % if you want to change the width of the column with the dates
%\setlength{\makecvheadnamewidth}{10cm} % for the 'classic' style, if you want to force the width allocated to your name and avoid line breaks. be careful though, the length is normally calculated to avoid any overlap with your personal info; use this at your own typographical risks... %\setlength{\makecvheadnamewidth}{10cm} % for the 'classic' style, if you want to force the width allocated to your name and avoid line breaks. be careful though, the length is normally calculated to avoid any overlap with your personal info; use this at your own typographical risks...