LaTeX之宏包安装

$LATEX$ 之宏包安装

安装和更新宏包

$\text{TeX Live}$ 和 $\text{MiKTeX}$ 分别提供了图形界面的宏包管理器 $\text{TEX Live Manager}$ 和 $\text{MiKTeX Package Manager}$，用于安装、管理和更新宏包。一般情况下，直接在图形界面的工具下按提示操作即可（$\text{MiKTeX Package Manager}$ 有普通权限和管理员权限的版本，建议总是使用管理员权限的版本）。

两者也可以通过各自的命令行工具安装和更新宏包：

% TeX Live 命令行工具 tlmgr 的使用示例
% 安装/卸载宏包
tlmgr install <package-name>
tlmgr remove <package-name>
% 更新所有宏包（包括 tlmgr 本身）
tlmgr update --all --self
% 列出所有可更新的宏包
tlmgr update --list
% 指定更新源地址
% <CTAN mirrors> 形如 https://mirrors.tuna.tsinghua.edu.cn/CTAN
tlmgr repository set <CTAN mirrors>/systems/texlive/tlnet
% 查看宏包信息，加 --list 参数可列出宏包的所有文件
tlmgr info <package-name>

% MiKTeX 命令行工具 mpm 的使用示例
% 建议始终加 --admin 参数使用
% 安装/卸载宏包
mpm --admin --install <package-name>
mpm --admin --uninstall <package-name>
% 更新所有宏包
mpm --admin --update
% 列出所有可更新的宏包
mpm --admin --find-updates
% 指定更新源地址
mpm --admin --set-repository=<CTAN mirrors>/systems/win32/miktex/tm/packages
% 查看宏包信息
mpm --admin --print-package-info <package-name>

$\text{TeX Live}$ 默认安装所有宏包， $\text{MiKTeX}$ 的安装程序只包含了 $LATEX$ 的一些基本宏包。从 $\text{TeX Live}$ 的光盘镜像和 $\text{MiKTeX}$ 的安装包体积可见一斑。
默认情况下，编译过程中如果遇到宏包未安装而报错的情况下，$\text{MiKTeX}$ 会弹出一个对话框，让用户可以选择临时安装宏包，安装成功后继续编译。

手动安装宏包

$\mathrm{如}\mathrm{非}\mathrm{万}\mathrm{不}\mathrm{得}\mathrm{已}，\mathrm{尽}\mathrm{量}\mathrm{不}\mathrm{要}\mathrm{手}\mathrm{动}\mathrm{安}\mathrm{装}\mathrm{宏}\mathrm{包}$。绝大多数宏包都已打包到 $\text{TeX Live}$ 和 $\text{MiKTeX}$ 两大发行版的安装源，可用宏包管理器安装。如果用户知道某个宏包的名称，但不确定是否在发行版中已打包，可在 $\text{CTAN}$ 中搜索，网址是https://www.ctan.org/。

在手动安装之前，有必要了解一下 $TEX$ 目录结构（$TEX$ Directory Structure, TDS）。它是 $TEX$ 发行版中宏包、字体、帮助文档等文件的组织结构。TDS 有时也称为 $\text{TEXMF}$ 树，取 $TEX+\text{METAFONT}$ 之意。

以 $\text{TeX Live}$ 为例，假设系统的 $\text{TEXMF}$ 树根目录为 $\text{C:texlive2020texmf-dist}$，其下有很多子目录，仅举几例：

$\mathtt{\text{tex/latex}}$	$LATEX$ 宏包
$\mathtt{\text{doc/latex}}$	$LATEX$ 宏包的帮助文档
$\mathtt{\text{source/latex}}$	$LATEX$ 宏包的源代码
$\mathtt{\text{bibtex}}$	$\text{BibTeX}$ 工具相关文件，许多宏包配套的 $\text{BibTeX}$ 格式文件位于子目录 $\mathtt{\text{bst}}$ 中
$\mathtt{\text{fonts/tfm}}$	$TEX$ 使用的字体文件，$\text{TFM}$ 格式
$\mathtt{\text{fonts/type1}}$	$\text{PostScript}$ 字体文件（$\text{Type1}$），$\text{PFB}$ 格式
$\mathtt{\text{fonts/opentype}}$	$\text{OpenType}$ 格式的字体文件

需要手动安装的宏包，一般已经按照上述目录结构打包完成。手动安装时，尽量不要拷贝到系统的 $\text{TEXMF}$ 树，而是拷贝到发行版提供的用户 $\text{TEXMF}$ 树，如 $\text{TeX Live}$ 的 $\text{C:texlivetexmf-local}$。安装完成后，还需刷新 $TEX$ 发行版的文件名数据库，令新安装的宏包文件能够被系统找到。$\text{TeX Live}$ 用户须在 Windows 命令行或者 Linux 终端执行命令：

mktexlsr

$\text{MiKTeX}$ 用户的命令为：

initexmf --update-fndb

下载下来的宏包，有的直接包含$\mathtt{\text{.sty}}$ 文件（$\mathtt{\text{.sty}}$文件就是package的最终形式）；有的下载下来只包含了$\mathtt{\text{.ins}}$,$\mathtt{\text{.dtx}}$，以及一个 $\text{readme}$ 文件，这时需要自己编译生成 $\mathtt{\text{.sty}}$ 文件，以及生成相应的 $\text{manual}$ 。下面详细介绍生成 $\mathtt{\text{.sty}}$ 文件以及帮助文档的步骤。

• 第一步：下载宏包，解压，下载地址https://www.ctan.org/pkg；

• 第二步：找到你的解压后安装包地址，打开电脑的命令提示符界面，切换路径到这个package所在文件夹；

• 第三步：生成*.sty，在命令提示符界面输入 latex *.ins；生成帮助文档manual, 在命令提示符界面输入latex *.dtx，编译完成以后，会生成一个叫做*.dvi的文件，这个文件也可以用ctex自带的yap程序打开，不过不是很方便，所以最好还是把它转为pdf格式，分为两步，先输入 dvips *.dvi，生成 *.ps文件，再输入ps2pdf *.ps，最终就生成了*.pdf的帮助文档，可以打开查看这个package的基本用法，命令的格式等。

• 第四步：生成 *.sty文件以后还需要把这个文件放到LaTeX能够识别的路径下，在CTEX下，可以是 ~\CTEX\MiKTeX\tex\latex，$\text{TeX Live}$ 下，可以选择 ~\texlive\texmf-local\tex\latex\local, 你可以在这个路径下建立一个文件夹，文件夹的名字即是宏包的名字，把*.sty放到这里，接着找到MikTeX的Console，以管理员方式打开，点击“任务”——“刷新文件名数据库”。

下面的表格中给出了文件存放的规则：

Type	Directory (under texmf/ or texmf-local/)	Description
.afm	fonts/afm/foundry/typeface	Adobe Font Metrics for Type 1 fonts
.bst	bibtex/bst/packagename	BibTeX style
.cls	tex/latex/base	Document class file
.dvi	doc	package documentation
.enc	fonts/enc	Font encoding
.fd	tex/latex/mfnfss	Font Definition files for METAFONT fonts
.fd	tex/latex/psnfss	Font Definition files for PostScript Type 1 fonts
.map	fonts/map/	Font mapping files
.mf	fonts/source/public/typeface	METAFONT outline
.pdf	doc	package documentation
.pfb	fonts/type1/foundry/typeface	PostScript Type 1 outline
.sty	tex/latex/packagename	Style file: the normal package content
.tex	doc	TeX source for package documentation
.tex	tex/plain/packagename	Plain TeX macro files
.tfm	fonts/tfm/foundry/typeface	TeX Font Metrics for METAFONT and Type 1 fonts
.ttf	fonts/truetype/foundry/typeface	TrueType font
.vf	fonts/vf/foundry/typeface	TeX virtual fonts
others	tex/latex/packagename	other types of file unless instructed otherwise

如果一个宏包还顺带安装了一些字体，还应该更新字体的映射。详细方法参详这里。

参考博文

[1] Partl H, Hyna I, Schlegl E. 一份 (不太) 简短的 LATEX2ε 介绍[J]. 2024. https://github.com/CTeX-org/lshort-zh-cn

[2] https://www.cnblogs.com/csucat/p/5142459.html

[3] https://blog.csdn.net/memray/article/details/45248259