moderncv 的笔记

摘自：http://www.xiangsun.org/tex/notes-on-moderncv

大多数人的 CV 都是使用 Microsoft Word 之类的所见即所得的软件制作的。但作为一个 TeXer，CV 显然得用 TeX 制作。TeX 中有很多文档类、宏包可以用来制作 CV（另见 Writing the curriculum vitae with LaTeX）；但我一直钟情于 moderncv 文档类。

六年前，看到 moderncv 文档类的第一眼，我就完全被她吸引了，简洁又不失华丽。打那之后，自用的同时，一直竭力向身边的朋友推荐。

第一个接受我推荐的是一个师弟。那还是在五年前，我用 moderncv 文档类给他写中文 CV。当时比较流行的中文处理方法还是 CJK 宏包，而 moderncv 与 CJK 在兼容性方面有一些 bug；这也导致当时写得很辛苦。第二个接受我推荐的是一个哥们。因为是英文 CV，所以处理起来相当方便。之后接受我推荐的人越来越多，但我基本再未捉刀代笔过了。

去年，出于找工作的目的，我使用 moderncv 制作了自己的 CV；中间或多或少遇到了一些麻烦，但最后都处理得不错。身边的一些伸手党看到之后，也想使用；由于 moderncv 文档类没有说明文档，也希望我能简单描述一下如何使用。

moderncv 最早发布于 2006 年 03 月 01 日，当前最新版本为 version 1.3.0 version 1.5.1 version 2.0.0，发布于 2013 年 02 月 09 日 2013 年 04 月 29 日 2015 年 07 月 28 日。

Contents | 任意门

1 安装
2 使用
3 编译
4 一些特殊要求的实现 

安装

对于 MiKTeX 和 TeX Live 完全安装的同学，moderncv 已经安装好了；不是完全安装的，请通过相关组件检查并安装；对于其它 TeX 发行版，请自行检查。当然，手动安装也是可以的，可以在 CTAN 下载，放入对应目录，并刷新 FNDB。
使用

下面我将结合 moderncv 文档类中自带的 template.tex 文件来具体分析下如果快速上手。另外，对于需要制作中文 CV 的朋友，可能会对 template-zh.tex 感兴趣，我劝您最好别看它，里面使用的 CJK 那个古董早该退出历史舞台了。
设置文档类

\documentclass[10pt,a4paper,roman]{moderncv}

10pt 是字体大小，其余可选项有 11pt、12pt。字体的大小总该懂吧；也就三个选择，不明白的每个都去试一下。
a4paper 是纸张大小，其余可选项有 letterpaper（美洲常用标准，比 A4 短、宽）、a5paper、legalpaper（美洲常用标准，比 A4 长、宽）、executivepaper（比 A4 短、窄）、landscape（横向）；需要的话请移步维基百科相关页面。
roman 是字体族，其余可选项有 sans，分别代表衬线字体、无衬线字体。我总觉得字体族默认选择 sans 有些不妥，毕竟整个 CV，文字可能很多，全部使用无衬线字体很影响阅读。

设置 CV 样式

% moderncv themes
\moderncvstyle{classic}
\moderncvcolor{blue}
%\renewcommand{\familydefault}{\sfdefault}
%\nopagenumbers{}

classic 是整体样式，其余可选项有 casual、oldstyle、banking、empty。具体的样子可以参见 moderncv 宏包中的例子。个人比较喜欢 classic，尤其喜欢每个 Section 前的短横线；当然 banking 样式下个人信息的排版很不错。
blue 是颜色样式，其余可选项有 orange、green、red、purple、grey、black、burgundy（2.0.0 新增加的颜色）。具体的样子可以参见 moderncv 宏包中的例子。要严肃的话推荐 black，其余随意。
第三行代码用来选择默认字体，我一般把它注释掉。由于现在有了 XeTeX 等强大的引擎，可以用 fontspec 直接加载西文字体，当然，前提是你得有字体的 otf 或者 ttf 等文件。我一般喜好使用衬线字体 Minion Pro 配合无衬线字体 Myriad Pro，待会我会提到如何使用新的字体。
最后一行代码用来控制是否显示页码。CV 超过一页的话，建议显示页码，即注释掉这个代码。当然，我已经习惯自己定义页眉页脚，也不需要这个选项了。

设置编码方式

% character encoding
%\usepackage[utf8]{inputenc}
%\usepackage{CJKutf8}

因为会使用 XeTeX 引擎，代码最好是 UTF-8 字符，因此指定 inputenc 参数完全是多余的，第一行代码直接注释掉。
处理中文可以直接使用 XeTeX + fontspec + xeCJK，所以这行代码完全多余，直接注释掉。

调整页面边距

% adjust the page margins
\usepackage[scale=0.75]{geometry}
%\setlength{\hintscolumnwidth}{3cm}
%\setlength{\makecvtitlenamewidth}{10cm}

TeX 用户应该都知道大名鼎鼎的 geometry 宏包吧，在此不再赘述。
修改“显示时间的列的宽度”；直观点说，如果使用的是 classic 样式，那么调整的就是 Section 前面的短横线的长度。一般不作修改，注释掉。
有的时候姓名比较长，使用 classic 样式的时候，因为要在右上角显示个人信息，可能姓名会出现换行的情况。第三行代码可以设置姓名所占空间的宽度。一般不作修改，注释掉。

多语言环境设置

\usepackage{fontspec}
\usepackage{xunicode}
\usepackage{xeCJK}
\setmainfont{Minion Pro}
\setsansfont{Myriad Pro}
\setmonofont{Courier New}
\setCJKmainfont{SimSun}
\setCJKsansfont{KaiTi}
\setCJKmonofont{SimHei}
%\setCJKmathfont{}

第一行代码中的 fontspec 宏包用来处理加载一般西文字体。第二行代码中的 xunicode 宏包用来指明代码是 unicode 编码。其实这两个宏包可以用 xltxtra 代替。
第三行代码中的 xeCJK 宏包用来处理加载中文字体。
第四、五、六行代码分别用来设置西文字体的正文衬线族、正文无衬线族、正文等宽族。第七、八、九行代码分别用来设置中文字体的正文衬线族、正文无衬线族、正文等宽族。最后一行用来设置数学公式中的中文字体族。xeCJK 宏包功能很强大，可参见其说明文档。
有了上述设置，可以随便写中文了。

个人信息设置

% personal data
\name{John}{Doe}
\title{Resumé title} % optional
\address{street and number}{postcode city}{country}% optional
\phone[mobile]{+1~(234)~567~890} % optional
\phone[fixed]{+2~(345)~678~901} % optional
\phone[fax]{+3~(456)~789~012} % optional
\email{john@doe.org} % optional
\homepage{www.johndoe.com} % optional
\social[linkedin]{john.doe} % optional
\social[twitter]{jdoe} % optional
\social[github]{jdoe} % optional
\extrainfo{additional information} % optional
\photo[64pt][0.4pt]{picture} % optional
\quote{Some quote} % optional

姓名较长，使用 classic 样式的时候，可能需要调整姓名所占的空间的宽度。
\address 改进了，之前只能填写 2 行地址，现在最多可以 3 行，灵活了不少。
有的时候在个人信息里需要放两个 E-mail 地址、两个电话等等，实现办法可以参考这里和这里。
我在使用 \homepage 的时候遇到了一个与 hyperref 宏包相关的 bug。我之前的个人主页中有字符"~"，直接输入

\homepage{graduate.math.nus.edu.sg/~g0800878/}

输出的 PDF 文件中看不到"~"。如果输入

\homepage{graduate.math.nus.edu.sg/\textasciitilde g0800878/}

输出的 PDF 文件中可以看见"~"了；但同时出现了另一个问题，在 PDF 文件中点击 homepage 这个链接，Adobe Acrobat 9.5 Pro 直接报错

The Web Capture operation you have requested has failed because of an error

最后我用了一个“野蛮”的办法绕过去了，直接在 \extrainfo 中输入

\extrainfo{\homepagesymbol http://graduate.math.nus.edu.sg/\textasciitilde g0800878/}

以上的问题可以按照下面的方法解决，在“moderncv.cls”文件中删除“baseurl=http://,”，或者在导言区的末尾加上

\AfterPreamble{\hypersetup{baseurl={}}}

感谢 Xi Zhang 提供解决办法。
一般每份 CV 都需要注明更新时间，我一般直接借用 \quote 来实现。

{\footnotesize Last updated: \today}
有的同学可能需要更多的组件，比如 Linkedin 的信息等，实现办法可以参考这里。

列表样式

关于这个，我真不用多费口舌了，直接在 template 上修改就好了，一边用一边就会了。
编译

如果仅使用英文，保证 TeX 系统是最新的，然后直接编译即可，PDFLaTeX、XeLaTeX 都可以。
如果有使用中文，保证 TeX 系统是最新的同时，还需要：保证 XeTeX 版本高于 0.9995.0 （2009 年 06 月 29 日）的版本；安装有 l3kernel 宏包和 l3packages 宏包；安装有 fontspec 宏包和 xeCJK 宏包；安装有想用的字体。一切都搞定之后使用 XeLaTeX 编译即可。

一些特殊要求的实现

修改链接的颜色：在导言区加入

\AtBeginDocument{ \hypersetup{colorlinks,urlcolor=red} }