使用主要符号表和缩略词表 · shifujun/UESTCthesis Wiki · GitHub优秀个人简历推荐

使用方法

根据规范主要符号表和缩略词表可根据需要选择是否使用。使用这两个功能不需要特别设置模板，只要定义了符号或缩略词并在文中引用过它们，模板会自动在目录后添加主要符号表或缩略词表。

需要注意的是，这两个表格需要用模板提供的编译脚本编译后才会出现。

定义符号或缩略词

定义一个符号可以使用命令：
\newglossaryentry{引用标签}{name={符号},description={说明},sort=排序名}
例如：
\newglossaryentry{labelpai}{name={$\Pi$},description={圆周率符号},sort=pi}
其中sort参数不是必须的，当没有它时该符号会在符号表中按照它的name排序。但像上面例子中的符号如果没有sort参数会把该符号作为首字母为$的单词进行排序。指定sort参数可以控制它在符号表中的位置。引用标签用于在正文中引用。

定义一个缩略词可以使用命令：
\newacronym[description=中文全称]{引用标签}{缩写形式}{英文全称}
例如：
\newacronym[description=支持向量机]{svm}{SVM}{Support Vector Machine}
缩略词也可以指定排序名，例如：
\newacronym[description=法语:版本,sort=editions]{ed}{éd.}{édition(s)}
像上面这条以非英文字母开头的条目如果不指定sort，将会排在a之前。

对于复数形式特别的符号，需要指定plural参数。例如：
\newglossaryentry{cow}{name=cow,plural=kine,
description={a fully grown female of any bovine animal}}
对于缩略词则需分别指定全称和缩写的复数形式，例如：
\newacronym[description=支持向量机,longplural={Support Vector Machines},shortplural=SVMs]{svm}{SVM}{Support Vector Machine}

引用符号或缩略词

引用符号或缩略词都是用同一个命令：
\gls{引用标签}
例如：
\gls{labelpai}或\gls{svm}。
在引用缩略词时，第一次引用会以全称加括号缩略词的方式显示，而之后再引用的时候则只有缩略词显示了。例如：
有一类算法叫做\gls{svm}，\gls{svm}的效果非常显著。编译后的效果是：
有一类算法叫做Support Vector Machine (SVM)，SVM的效果非常显著。

\gls命令的完整语法是：
\gls[选项]{引用标签}[额外文字]
选项详见glossaries的说明文档。额外文字是用于插入到自动生成的文字中的。

除了\gls命令，还有5个类似的命令。6个命令功能如下：
\gls：不改变大小写，引用单数形式。
\Gls：将首字母大写，引用单数形式。
\GLS：全部字母大写，引用单数形式。
\glspl：不改变大小写，引用复数形式。
\Glspl：将首字母大写，引用复数形式。
\GLSpl：全部字母大写，引用复数形式。

不引用而显示所有条目

可以在文中使用\glsaddall命令，即可将该命令之前所有定义过的条目都标记为“引用过”。不过要注意，这些条目的页码也会被设置为当前页，这一般是不对的。所以，还需要参考下面修改格式的方法将页码列去掉。

类似的命令还有\glsadd{}，可以单独设置一个条目。详见宏包说明文档。

高级用法

模板使用的是glossaries宏包实现的主要符号表和缩略词表。所以关于这两个表格的详细用法需要参考该宏包的说明文档：http://mirrors.ctan.org/macros/latex/contrib/glossaries/glossaries-user.pdf。

修改格式

由于学校规范中没有对这两个表有具体的格式要求。你可以更改这两个表的格式。这里只介绍一些简单而常见的修改方法。更为深入的修改请参考该宏包的说明文档。

恢复分组间距

在v1.1.0之前，模板使用了glossaries宏包的默认设置。主要符号表和缩略词表中不同首字母开头的条目会形成分组，每个分组间有一个额外的间距。很多同学觉得不适应，所以模板取消了这个空白。如果要恢复这个分组间距，可以在cls文件中做如下修改：
修改缩略词表，在cls中搜索:
\printacronyms[nogroupskip,style=acronymwithtranslation]改为
\printacronyms[style=acronymwithtranslation]即可。
修改主要符号表，在cls中搜索：
\printglossary[nogroupskip,style=custom-long3colheader]改为
\printglossary[style=custom-long3colheader]即可。

修改缩略词第一次引用的显示格式

缩略词的引用样式叫做acronymstyle。glossaries宏包预定义了许多acronymstyle，而默认启用的叫做long-short。模板（v1.1.0之后的版本）的源代码中重定义了long-short，但是在代码中没有对long-short的设置进行任何修改。将其放在源代码中就是为了方便修改。在cls文件中搜索：
\renewacronymstyle{long-short}%
就能找到这部分代码。这个renewacronymstyle命令具有3个参数，所以它后面的3对大括号都是它的参数。

我们需要修改的就是其中4个\renewcommand*命令，分别是\genacrfullformat、\Genacrfullformat、\genplacrfullformat和\Genplacrfullformat。这4个宏依次是\gls、\Gls、\glspl和\Glspl引用命令在第一次使用时的显示格式。以\genacrfullformat为例，它被定义为：
\glsentrylong{##1}##2\space
(\protect\firstacronymfont{\glsentryshort{##1}})%
首先我们要知道LaTeX的源码中单独一个换行和一个空格没有区别，所以上面的定义在显示的时候还是一行文字。\glsentrylong{##1}表示取出英文全称显示在那里，##1就是这个条目的标签。而##2就是\gls等命令最后的可选参数“额外文字”。然后是\space就是一个空格，你可以不这么写。第二行的小括号会原样输出，然后是为\glsentryshort{##1}指定了专门的字体，你也可以不指定。而\glsentryshort{##1}是用来取出缩写形式的。最后的小括号也是原样输出的。

用来取出缩略词定义的各命令如下：
\glsentryshort{##1}：缩写形式
\glsentrylong{##1}：英文全称
\glsentrydesc{##1}：中文全称

所以如果想将\gls第一次引用形式改为“中文全称【英文全称,缩写形式】”的话，可以将\genacrfullformat的定义改为如下命令：
\renewcommand*{\genacrfullformat}[2]{%
\glsentrydesc{##1}~【\glsentrylong{##1},\glsentryshort{##1}】%
}%
第二行中最后的%是为了避免将那一行最后不可见的回车符解释为\genacrfullformat的一部分。否则回车符会变成】后面的一个空格。