summaryrefslogtreecommitdiff
path: root/info/install-latex-guide-zh-cn/chapter/macos.tex
blob: 400325a36ebca0c1daa81096179206b798ae67b5 (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
% !TeX root = ../install-latex-guide-zh-cn.tex

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

\section{安装 Homebrew}

强烈建议用户使用 \href{https://brew.sh}{Homebrew}.
Homebrew 是一个包管理, 类似 Ubuntu 上面的 \texttt{apt-get}.
安装教程可以在其网站找到, 这里简单列出来:
\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}, 输入 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}

\subsection{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}

\section{安装 Mac\TeX}

Mac\TeX{} 是 \TeX{} Live 在 macOS 下的再打包版本, 额外加入了一些辅助程序. 如果已经安装了 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{} 依然会缺很多包, 手动安装会比较麻烦, 所以不推荐没有经验的用户尝试.

如果不通过 Homebrew 安装 Mac\TeX,
可以直接\href{https://mirrors.ctan.org/systems/mac/mactex/MacTeX.pkg}{下载}%
它的安装包而后手动安装.
同样可以考虑更换大陆镜像进行下载,
具体请参考附录~\ref{chp:appendix:mirror}.

\section{卸载 Mac\TeX}

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

\section{跨版本升级 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}{慕子的文章}.

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