首字母缩略词和符号列表
glossaries-extra 方案概览,或在够用时手工维护的列表。
首字母缩略词和符号列表
长文档会积累缩写,而围绕缩写的惯例很严格。首字母缩略词在首次使用时完整拼写,之后使用缩写,论文通常还需要在前置部分列出缩写列表。手动维护会以可预见的方式失败:你重排了两章,首次使用的位置随之移动,突然之间“ML”出现在“machine learning (ML)”之前三页。 glossaries-extra 包会替你跟踪首次使用。
自动路线
\usepackage[acronym]{glossaries-extra}\makeglossaries\newacronym{ml}{ML}{machine learning}acronym 选项启用首字母缩略词支持,并且 \makeglossaries 打开在编译期间收集条目的机制。每个\newacronym都有三个参数:你将在文本中键入的键、短形式和长形式。在序言中或在\input的单独文件中定义所有它们,因此它们位于一个位置。
在正文中,你永远不会输入首字母缩略词本身:
\gls{ml} on first use expands; later uses stay short.\printglossaries文档中的第一个 \gls{ml} 打印“机器学习 (ML)”,后面的每个都只打印“ML”。由于包跟踪使用情况而不是在源中的位置,因此无论你的重组将其移动到何处,扩展都会跟随第一次使用。 \printglossaries 会打印收集的缩写列表,无论你将其放在何处,通常位于目录之后。相关命令涵盖了与此相关的语法:\glspl表示复数,\Gls表示大写的句子开头。
问题在于构建。在 LaTeX 各遍编译之间,必须运行 makeglossaries 辅助程序对条目排序和格式化,否则 \printglossaries 会静默地产出空内容。完整的 latexmk 配置会自动处理这一步。更简单的流水线可能不会,glossaries-extra 为此提供了后备方案。如果你的列表怎么都不出现,首先怀疑缺少辅助程序运行,远在怀疑文档有 bug 之前。
手工构建的路线
对于简单的符号列表,手动维护的 description 环境通常就足够了:
\section*{Notation}\begin{description} \item[$\eta$] learning rate \item[$\theta$] model parameters\end{description}每个 \item[...] 把方括号中的参数印成粗体标签,后面跟解释,这正是符号列表的形状。它没有首次使用跟踪,但符号列表几乎不需要:无论如何,符号都是在数学中首次出现的位置定义的。
诚实的建议是让工具匹配规模。只有五个缩略词的论文手工管理更容易。一篇 200 页、含 40 个缩略词的论文则不然,在那里这个宏包的安装成本会被成倍赚回。 列表课程 更详细地介绍了 description 环境。