UESTC-Thesis-Latex-Template

English version of the README

使用说明

参考main.tex中关于本模板使用的各项说明，正文写法可参考一份其实很短的 LaTeX 入门文档

注意，请尽量使用texlive 2021或之后的版本进行编译，模板仅在这些版本的latex下进行过相关测试

设置论文相关信息

以下所有内容均需设置在正文开始（\begin{document}）之前

学位信息设置（选择对应模板）

main.tex第一行进行设置，应用thesis-uestc模板，设置学位信息：

bachelor：本科
master：学硕
promaster：专硕
doctor：博士
engdoctor：工程博士

操作方式如下所示：

\documentclass[master]{thesis-uestc}

作者、导师、题目等基本信息

\title{中文题目}{English Title} % 论文题目
\author{姓名}{English Name} % 作者姓名
\setdate[submit]{2022年3月17日} % 论文提交日期，可留空
\setdate[oral]{2022年4月15日}  % 答辩日期，可留空
\setdate[confer]{2022年6月8日} % 学位授予日期，可留空
\advisor{导师姓名\chinesespace 导师职称}{English name English title}
\coAdvisor{合作导师姓名\chinesespace 导师职称}{Co advisor English name English title} % 仅专业硕士/博士使用，在扉页/英文首页添加合作导师
\school{计算机科学与工程学院(网络空间安全学院)}{School of Computer Science and Engineering(School of Cyberspace Security)} % 学院信息
\major{计算机科学与技术}{Computer Science and Technology} % 专业信息
\studentnumber{xxxxx} % 学号
\Chairman{xxxxx} % 答辩委员会主席

设置专业学位领域（专业硕士/博士专用）

\ProfessionalDegreeArea{随便学学} % 专业硕士/博士专用：专业学位领域

答辩委员会主席

$chairman pos$

由于学校20220224格式规范中明确显示该内容左对齐，本模板进行了同步，若为了美学设计，请在cls文件中搜索\arraybackslash\fontsize{14pt}{14pt}\bfseries\selectfont}p{4.35in} ，并全局替换为\centering\arraybackslash\fontsize{14pt}{14pt}\bfseries\selectfont}p{4.35in}完成对该内容的居中显示。

设置合作导师

专业学位硕士/博士（请按照以下步骤操作）

在main.tex中，对以下内容取消注释并设置：

\coAdvisor{合作导师姓名\chinesespace 导师职称}{Co advisor English name English title} % 仅专业硕士/博士使用，在扉页/英文首页添加合作导师

在thesis-uestc.cls中修改以下内容（修改后如下所示）：

1126-1127取消注释；1129行修改为12bp

1126    合作导师 & {\bfseries\zh@thecoadvisor} \\
1127    \cline{2-2}
1128    & \fontsize{12pt}{12pt}\selectfont（姓名、职称、单位名称）
1129    \end{tabular}  \\ [12bp]

1215-1216行取消注释；

1215    Co-Supervisor: & \en@thecoadvisor \\
1216    \cline{2-2}

学术学位硕士/博士（请按照以下步骤操作）

在main.tex中，对以下内容取消注释并设置：

\coAdvisor{合作导师姓名\chinesespace 导师职称}{Co advisor English name English title} % 仅专业硕士/博士使用，在扉页/英文首页添加合作导师

在thesis-uestc.cls中修改以下内容（修改后如下所示）：

1008-1009取消注释；1011行修改为24bp

1008    合作导师 & {\bfseries\zh@thecoadvisor} \\
1009    \cline{2-2}
1010    & \fontsize{12pt}{12pt}\selectfont（姓名、职称、单位名称）
1011    \end{tabular}  \\ [24bp]

1091-1092行取消注释；

1091    Co-Supervisor: & \en@thecoadvisor \\
1092    \cline{2-2}

分类号、密级、UDC号

UDC编号查询：https://udcsummary.info/php/index.php?lang=chi&pr=Y
分类号查询：http://pss.uestc.edu.cn:8080/chineseSearch.action

\ClassificationNumber{TP309.2} % 分类号
\ClassifiedClass{公开} % 密级
\UDCNumber{004.78} % UDC号

图、表目录设置

\thesisfigurelist % 图目录
\thesistablelist % 表目录

缩略词/符号表目录设置

注意，模板为了便于操作，对glossary设置了automake，会导致在不使用这部分功能时发生编译错误，请在注释main.tex中的\makeglossaries的基础上，在cls文件中取消27行的注释，并将28行注释，如下所示：

%\RequirePackage[nopostdot]{glossaries}
\RequirePackage[toc,nopostdot,style=long,automake,acronym]{glossaries}

在使用缩略词/符号表时,请在导言区填写缩略语条目并使能glossary宏包(如下所示,详细使用方法见main.tex):

\makeglossaries % 产生缩略词表/符号表专用,不使用时请注释
\newacronym[description=逻辑卷管理器]{lvm}{LVM}{Logical Volume Manager} % 定义缩略词/符号:以本项为例,逻辑卷管理器为中文名称;lvm用于文内引用;LVM为显示的应为缩略语或符号;Logical Volume Manager为显示的英文全称/描述

若要添加缩略词/符号表目录,请在需要的位置进行以下设置:

% \glsaddall % 默认仅显示被正文引用的项,取消注释以显示所有已定义的缩略词/符号
\thesisglossarylist % 缩略词目录
\thesissymbollist % 符号表

使用代码模板

如下所示，使用代码环境。其中style用于指定语言进行代码高亮；caption用于设置代码段标题；label用于生成代码段标签，以便在正文中引用。这里三项参数均为非必填项（但不填style会导致没有任何格式和高亮）。现支持的代码语言高亮包括：c++，shell，python，json，solidity

\begin{lstlisting}[style=shell, caption={xxxx},label{xxxx}]
sudo apt install xxx
\end{lstlisting}

(盲审提交用)不显示作者姓名

采用以下方法进行设置（即设置为空格）

\author{$\quad$}{$\quad$}

参考文献数量超过100时的悬挂缩进问题

引入参考文献时设置间距为large（如下所示）：

\thesisbibliography[large]{reference}

禁止英语单词截断换行

在main.tex中取消注释以下内容，用于禁止文中换行处的英语单词自动截断换行。

% \tolerance=1
% \emergencystretch=\maxdimen
% \hyphenpenalty=10000
% \hbadness=10000

数字/罗马字符加粗显示

本模板中请使用\pmb{1234}对公式中数字/罗马字符加粗，效果如：$\pmb{1234}$

overleaf备注

可能存在中文摘要无页码的问题，解决方案如下：在cls文件的439和440行之间增加\setcounter{page}{1}\setcounter{pseudopage}{1}

macOS上设置字体

如果Mac上安装了Microsoft Word，可将uestc-thesis.cls中的代码

  \setCJKmainfont[AutoFakeBold=true]{Songti SC}
  \newCJKfontfamily{\heiti}{STHeiti}
  \newfontfamily{\heiti@letter}{STHeiti}

改为

  \def\WordPath{/Applications/Microsoft Word.app/Contents/Resources/DFonts/}
  \setCJKmainfont[AutoFakeBold=true,Path=\WordPath]{SimSun.ttf}
  \newCJKfontfamily{\heiti}[Path=\WordPath]{SimHei.ttf}
  \newfontfamily{\heiti@letter}[Path=\WordPath]{SimHei.ttf}

常见问题

需要更多层级的目录：Issue 25
英文封面专业名称不需要双行（减少下划线）：Issue 42
学院名称单行不够，需要多行：Issue 31
删除空白页：请使用Adobe Acrobat等PDF软件直接删除页面。模板中的空白页为了打印而准备，电子版提交时请删除。
注释符号表：在完成main.tex中的注释后，请修改cls文件，将第27行取消注释，并将第28行注释（避免glossaries的自动编译导致的问题）

Beamer Slides Template

Slides模板位于./slides目录下，使用时直接参照slides中内容进行修改即可，编译链为xelate->bibtex->xelatex*2
改模板源自overleaf，可直接在overleaf中使用

更新日志

2022.3.17：新版cls模板提供了分类号、密级、UDC号的设置功能，使用方法如下所示(在main.tex中\begin{document}之前加入，与作者等信息等同)： $UDC$
- UDC编号查询：https://udcsummary.info/php/index.php?lang=chi&pr=Y
2022.3.17：修正英文封面中学号和姓名顺序错误的问题（对调）
2022.3.17：修正“答辩委员会主席”后下划线长度不足的问题
2022.3.18：增加专业硕士专用封面：
- 新增\ProfessionalDegreeArea{}用于设置“专业学位领域”，如下所示： $UDC$
2022.3.18：修正页眉下划线宽度为0.75磅，修正专硕英文封面学号和姓名顺序
2022.3.27: 章节编号加粗（目录不加粗），目前版本完整适配20220224新标准
2022.4.16: 增加主要符号表，修订缩略词表各栏宽度
2022.5.30: 增加合作导师设置，修正“指导老师”为“指导教师”；默认展示PDF修订为专硕版本
2022.6.30：新增了答辩slides的beamer模板
2023.3.01: bug修复，更新README

QQ讨论群

建立了QQ群便于讨论和改进模板：

$QQ Group$

tinoryj / UESTC-Thesis-Latex-Template