Installation and Configuration of LaTeX on macOS

Why not LaTeX in an elegant way?

Posted by Wang Zhihao on 2016-12-27

临近毕业,LaTeX相关技能可不能缺少。

用过LaTeX排版系统的人都会体会到LaTeX的优雅,但是除了「生成的PDF文件」是优雅的之外,「编译LaTeX的环境」也应该是优雅的。本文将会介绍众多优雅方法之一。

本文测试环境:
> 操作系统:macOS Sierra 10.12.2
> 编译环境:Sublime Text 3 + LateXTools + Skim 
> 本篇文章仅适用于macOS用户,建议升级至最新版的macOS Sierra系统。

安装 Basic TeX

为什么不安装完整版?

  • Basic TeX 与完整版的区别主要在于 Basic TeX 没有 GUI 应用,即图形界面——然而这正是我觉得最不优雅的部分——我们可以用更优秀更优雅的 Sublime Text 来替代。
  • 完整版的 MacTex 动辄2GB,而 Basic TeX 只有110MB。作为macOS用户,还是节省一下SSD的空间吧。
  • Basic TeX 缺少的一些package可通过 tlmgr install xx 等方法安装(后面会介绍tlmgr

如何安装 Basic TeX?

install-basictex.png

安装和配置 Sublime Text 3

  • 安装 Package Control

    • 访问 https://packagecontrol.io 并复制此段代码:

      import urllib.request,os,hashlib; h = 'df21e130d211cfc94d9b0905775a7c0f' + '1e3d39e33b79698005270310898eea76'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener( urllib.request.build_opener( urllib.request.ProxyHandler()) ); by = urllib.request.urlopen( 'http://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s), please try manual install' % (dh, h)) if dh != h else open(os.path.join( ipp, pf), 'wb' ).write(by)
    • 点击菜单栏 View > Show Console 进入 Sublime Text console

    • 把刚刚复制过的代码粘贴到下方并按下 return
    • 等待安装完成即可(如果失败99.99%是因为网络问题)
  • 安装 LaTeXTools

    • 按下 shift + command + P 输入 install 并选择 Install Packageinstall-latextools.png
    • 等待加载repositoriesloading-repos.png
    • 输入 latextools 并选择 LaTeXToolschoose-latextools.png
    • 等待安装完成installing-latextools.png
    • 如果出现以下界面,那么恭喜你,你成功安装了 LaTeXToolsinstall-latextolls-ok.png

题外话:为什么推荐 Sublime Text

  • 无论你以后从事数学、统计、经济、金融或者计算机等工作,Sublime Text 都或多或少地与你有关。
  • 做统计的你可以用Sublime Text来编写R,并直接在里面运行——这比官方的R不知道高到哪里去了。
  • 做经济学实证的你可以用 Sublime Text 来写 Stata 代码,你只需要按下command + return 即可将选中的代码复制到 Stata 中运行。(当然啦,你需要通过 Package Control 来安装相关插件)
  • 其中一个好处就是:你不必担心 R 或者 Stata 闪退,Sublime Text 是一个非常稳定而且强大的工作环境。
  • 至于程序员嘛,我就不强推了,毕竟我自己都用Vim

安装和配置 Skim

为什么要安装 Skim

  • 官方解释:
    We recommend that you also install the Skim PDF viewer, as this provides forward and inverse search and is the default viewer that LaTeXTools uses on macOS.

如何下载与配置?

  • 访问 Sourceforge 下载最新版本的 Skim 并安装
  • 打开 Skim,点击菜单栏 Skim > 选项 > 同步 并按照下图配置 skim-preference.png

通过 tlmgr 安装必要的组件—— latexmk

  • 打开 Terminal 并逐行执行以下命令
sudo tlmgr update --self
sudo tlmgr install latexmk
tlmgr.png

如果你成功地走到了这一步,那么你就可以编译最基本的Tex文件了。

编译 LaTeX

  • 打开 Sublime Text 3
  • 按下 shift + command + P 输入 latex 并选择 Set Syntax: LaTeX 或者直接点击右下角的 Plain Text 并选择LaTeX
  • 将下面代码复制到 Sublime Text 3 中并保存文件(建议为 .tex 文件单独建一个文件夹存放)
\documentclass{article}
\usepackage{fontspec,xeCJK}
\setCJKmainfont{STKaitiSC-Regular}
\begin{document}

\begin{abstract}
This is a brief instruction of installation and configuration on macOS.
\end{abstract}

\pagebreak
\begin{center}
\tableofcontents
\end{center}
\pagebreak

\section{Section A}
你好,世界。

\subsection{Subsection}

\begin{equation}
\int^{b}_{a}xdx
\end{equation}

\section{Section B}

\begin{equation} \nonumber
A= \left(\begin{array}{ccc}
1 & 2 & 3 \
1/2 & 1 & 1 \
1/3 & 1 & 1
\end{array}\right)
\end{equation}

\end{document}
  • Tools > Build With... 并选择 LaTeX - Basic Builder - XeLaTex提醒:此操作仅需第一次编译时需要)你会神奇地发现你的PDF文件在 Skim 中打开了
xelatex.png
  • 如果不是第一次进行编译,直接按下 Cammand + B 进行编译即可。
sublimetext-skim.png
  • 小技巧:在 Skim 中,按下 Command + Shift,在PDF的某个位置按下触控板,即可跳转至 Sublime Text 中对应的代码。

至此,你已经完成了macOS平台上「优雅LaTeX编译环境」的搭建。