summaryrefslogtreecommitdiff
path: root/info/install-latex-guide-zh-cn/chapter/macos.tex
blob: d934bda690d2213bd7b9210055c58fcf307eb817 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
% !TeX root = ../install-latex-guide-zh-cn.tex

\chapter{macOS}\label{chap:macOS}

\section{安装 Mac\TeX}

Mac\TeX{} 是 \TeX{} Live 在 macOS 下的再打包版本,
并额外加入了一些辅助程序.
在 macOS 上安装 Mac\TeX 可以选择以下两种方式: 
\begin{description}
  \item[直接下载 Mac\TeX{} 安装包进行安装]
  将安装文件下载到本地,
  然后按照安装提示进行安装.
  \item[借助 Homebrew 以命令行方式安装]
  先安装 Homebrew,
  然后通过命令行进行在线安装.
\end{description}

目前比较推荐直接下载 Mac\TeX{} 安装包的安装方式,
因为最近一段时间以来,
大陆用户对 GitHub 的访问极不稳定,
有可能会导致 Homebrew 安装失败.

\subsection{直接下载 Mac\TeX{} 安装包进行安装}

\href{https://mirror.ctan.org/systems/mac/mactex/MacTeX.pkg}{下载} Mac\TeX{} 的安装包 \texttt{MacTeX.pkg},
在系统内点击已下载的 \texttt{MacTeX.pkg} 文件,
根据系统提示进行安装即可.
这个过程与安装 macOS 上的其他软件并无太多不同.

另外,
用户也可以选择国内各个镜像来下载 \texttt{MacTeX.pkg}.
因其独特性,
用户需调整附录~\ref{chp:appendix:mirror} 中提供的大陆地区的源的网址,
具体来讲,
是将 \texttt{.../texlive} 改为 \texttt{.../mac/mactex}.
例如,
阿里云的镜像地址为 \url{https://mirrors.aliyun.com/CTAN/systems/mac/mactex/},
北京交通大学的镜像地址为 \url{https://mirror.bjtu.edu.cn/ctan/systems/mac/mactex/},
其他镜像类似,
不再一一列举.

\subsection{借助 Homebrew 以命令行方式安装}

建议用户学习使用 \href{https://brew.sh}{Homebrew},
Homebrew 是一个包管理工具,
类似 Ubuntu 上面的 \texttt{apt-get}.

\subsubsection{安装 Homebrew}
Homebrew 安装教程可以在其网站找到, 这里简单列出来:

\begin{lstlisting}[language=bash]
  /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
\end{lstlisting}
将以上命令在\textsf{终端}\footnote{%
  打开方法为: \keys{\cmdmac + \SPACE}, 输入 \textsf{terminal} 并打开 \menu{终端} 应用}%
执行.
脚本会在执行前暂停, 并说明它将做什么. 依据屏幕指令执行即可.

中国大陆用户可以更改镜像以提高访问速度. 以中国科学技术大学镜像源为例:
\begin{lstlisting}[language=bash]
  cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"
  git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
  cd "$(brew --repo)"/Library/Taps/homebrew/homebrew-cask
  git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
  echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.bash_profile
  source ~/.bash_profile
\end{lstlisting}
如果是 zsh 用户, 最后两行请替换为
\begin{lstlisting}[language=bash]
  echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc
  source ~/.zshrc
\end{lstlisting}

\subsubsection{Xcode}

根据 \href{https://docs.brew.sh/Xcode\#supported-xcode-versions}{Homebrew 网站}的提示\footnote{原文是 Homebrew supports and recommends the latest Xcode and/or Command Line Tools available for your platform},
推荐用户在安装 Homebrew 前先安装 Xcode.
在\textsf{终端} 执行以下命令即可:
\begin{lstlisting}[language=bash]
  xcode-select --install
\end{lstlisting}

\subsubsection{安装 Mac\TeX}

安装 Homebrew 后,
只需在\textsf{终端}执行以下命令即可完成安装:
\begin{lstlisting}[language=bash]
  brew cask install mactex
\end{lstlisting}
如有输入密码等提示, 请根据屏幕指示操作.至于环境变量等繁琐细节, Homebrew 会自动进行处理,
无须用户干预.

完整的 Mac\TeX{} 会比较大. 如果磁盘空间实在紧张, 也可以考虑安装 Basic\TeX:
\begin{lstlisting}[language=bash]
  brew cask install basictex
\end{lstlisting}
安装完成后 Basic\TeX{} 依然会缺很多包, 手动安装会比较麻烦, 所以不推荐没有经验的用户尝试.

\section{卸载 Mac\TeX}

如果用户直接下载了 Mac\TeX{} 安装包进行安装,
可以对照\href{https://www.tug.org/mactex/uninstalling.html}{这里}的介绍来卸载,
通常我个人会比较建议在跨版本升级前卸载就版本.

如果用户借助 Homebrew cask 安装了 Mac\TeX,
那么卸载工作可能会稍显麻烦.
这里引用 \href{https://github.com/Homebrew/homebrew-cask/issues/32073}{Github} 上的讨论.
用户可以根据这里的内容卸载 Mac\TeX.

\section{跨版本升级 Mac\TeX}

如果用户直接下载了 Mac\TeX{} 安装包进行安装,
可以先卸载旧版本,
再安装新版本,
或者干脆保留多个版本,
具体见\href{https://www.tug.org/mactex/multipletexdistributions.html}{这里}.

如果用户借助 Homebrew cask 安装了 Mac\TeX,
跨版本升级 (Mac\TeX{} 的版本与 \TeX{} Live 保持一致), 可在\textsf{终端}借助 Homebrew 完成:
\begin{lstlisting}[language=bash]
  brew update
  brew cask upgrade mactex
\end{lstlisting}

\section{升级宏包}

升级宏包依旧可以使用 \texttt{tlmgr}.
使用方法与 \ref{sec:ubuntu:update}~节类似, 这里不再重复.
一般来说, 也需要使用 \texttt{sudo} 获取管理员权限后才能完成安装.

\section{安装宏包}

安装 CTAN 中的宏包方法与 \ref{sec:ubuntu:installpackage}~节一致.

\section{调出宏包手册}

调出宏包手册方法与 \ref{sec:ubuntu:texdoc}~节一致.

\section{编译文件}

假设已经用 TextEdit.app 或其他文本编辑器编写以下示例 \texttt{main.tex}%
\footnote{注意建立最小示例前先确定工作路径},
内容为
\begin{lstlisting}[language = {[LaTeX]TeX}]
  \documentclass{article}
  \begin{document}
    Hello \LaTeX{} World!
  \end{document}
\end{lstlisting}
接下来在\textsf{终端}中执行
\begin{lstlisting}[language=bash]
  pdflatex main
\end{lstlisting}
等待系统完成编译过程. 
待编译完成后, 可看到在工作路径中生成了 \texttt{main.pdf}
文件和其他同名的辅助文件 \texttt{main.aux} 与 \texttt{main.log}.
可以打开 \texttt{main.pdf} 查看内容.

对于中文文档, 可以编写以下最小示例%
\footnote{注意使用 UTF-8 编码}%
\begin{lstlisting}[language={[LaTeX]TeX}]
  \documentclass[UTF8]{ctexart}
  \begin{document}
    你好 \LaTeX{} 世界!
  \end{document}
\end{lstlisting}
保存并退出.
接下来在\textsf{终端}中进入工作路径,
执行
\begin{lstlisting}[language=bash]
  xelatex main
\end{lstlisting}
等待系统完成编译过程.
\texttt{xelatex} 可调用系统字体,
为系统安装字体的方法请参考
\href{https://support.apple.com/en-us/HT201749}{How to install and remove fonts on your Mac}.
安装完成后, 刷新字体缓存.
注意到此时 \texttt{xelatex} 只能通过文件名来调用发行版预装的字体,
解决此问题的方法请参考%
\href{https://zhuanlan.zhihu.com/p/59774395}{慕子的文章}.

编译命令的相关参数, 这里不再赘述.