-
Notifications
You must be signed in to change notification settings - Fork 163
模板使用入门
模板可供全校毕业生使用。对于本科排版设置，参考的是2014年2月的[本科]2014毕业设计管理办法修订：http://www.jwc.uestc.edu.cn/news/read.do?nid=1127。对于研究生排版设置，参考的是2013年7月研究生院发布的研究生学位论文（含研究报告）撰写格式规范：http://gr.uestc.edu.cn/article.shtml?id=6643。
研究生院已发布了关于使用LaTeX模板撰写研究生学位论文的建议。
通过链接https://github.com/shifujun/UESTCthesis/archive/master.zip下载到的模板总是最新的。
解压后有几个目录。下面分别介绍：
这份“论文”原本是本模板的说明文档兼生成样例。2015年2月13日模板更新到v1.1.0之后，不再更新本说明文档。此说明文档中讲解的TeX安装方法、命令用法等已不全，或根本不再正确了。但本文档依然可作为一份样例供用户参考源码。
由于学校提供的撰写范例没有能全面展现本模板提供的功能，所以存在这份template论文对模板的其他功能进行展示，以便大家能看到代码的编译效果并对比实现的源代码。
presentation目录是一个简单的Beamer幻灯片模板。这个模板不像论文模板，它十分简陋。作者当年作为本科生答辩，并不需要太复杂的幻灯片。关于如何使用Beamer，请参考Beamer的官方说明文档http://mirrors.ctan.org/macros/latex/contrib/beamer/doc/beameruserguide.pdf（英文）。网络上也有一些不错的入门PPT讲解如何使用Beamer。
source目录包含的是本模板的源代码。仅使用模板的同学无需关注。
作为LaTeX模板，源代码使用了dtx和ins文件配合的方式撰写。这是一种将程序代码和程序注释编写在一起的方式，通过ins文件可以控制将dtx中的一部分内容抽取成单独的文件。通过这种方式将dtx中的一部分代码抽取成cls文件。同时用latex编译dtx文件还可以得到排版美观的源代码注释文档。因此cls文件并不是本模板的源代码，它是由dtx文件通过latex编译生成的。如果要修改本模板，这一点要清楚。编译dtx的脚本也放在了source目录中，它们是和论文的编译脚本不同的。
新建一份你的论文，首先需要复制template目录。可以将复制的目录重新命名，保存在计算机上的任何位置。这个目录在其余的Wiki说明就会被称为“工作目录”。
工作目录中的uestcthesis.cls文件和uestcthesis.bst文件分别是LaTeX文类和BibTeX样式，它们共同组成了模板的排版设置。这两个文件不一定非要留在工作目录中。LaTeX在编译时会自动寻找这两个文件，如果在MiKTeX或者TeXLive等管理器中安装了最新版的UESTCthesis，则这两个文件可以从工作目录中删除。将这两个文件放在工作目录中可以保证编译时使用的设置一定来自于这两个文件。如果对工作目录中的这两个文件进行修改，则LaTeX会优先使用工作目录中的这两个文件，而不会使用系统中安装的UESTCthesis提供的文件。
thesis.tex文件是论文的“主文件”，主文件的意思是编译这份论文时编译的就是这个文件。工作目录中的其他文件的内容都是通过主文件自动加载的。该文件的文件名可以自行修改，编译出的pdf文件名将和它保持一致。
想必你已经按照TeX环境安装中第一次测试编译的介绍从zip文件中解压出了编译脚本。如果你修改了主文件的文件名，还需要修改compile编译脚本中第一行的内容，第一行的最后有主文件的文件名，注意不包括扩展名tex。compile.bat可以直接在右键菜单中点编辑进行编辑（对于Linux和Mac用户则是compile.sh）。
主文件中的\documentclass命令的中括号中可以写上模板的一些参数。例如：
\documentclass[master,listoffigures,listoftables]{uestcthesis}
上面一行中该命令有三个参数，参数之间用英文逗号分隔。其中第一个参数是确定论文学位类型的，可以是bachelor、master、doctor中的一个，分别代表本科生、硕士生、博士生。v1.1.0之后的版本不再区分硕士生或博士生的类别，因为详细的类别只关系到封面和扉页。v1.1.0之后的版本不再模板内用LaTeX方案解决封面和扉页的问题了。封面和扉页的解决方案见XXX。
前面示例代码中后面两个参数不是必须的，它们的功能分别是启用图目录和表目录。模板的其余选项说明见XXX。
v1.1.0之后的版本由于删去了封面和扉页，不再使用titlepage.tex编辑封面信息。但为了在pdf文件内的元信息中录入论文的题目、作者和日期，将\title、\author和\date放在了主文件里。
在主文件里可以看到在document环境中只有\include命令，这些\include命令的参数是chapters目录中的tex文件。所以主文件中的document环境只写这些\include命令，控制章节的顺序。论文的每一章都以一个单独的tex文件形式存放在chapters目录中。
打开主文件可以看到文件的第一行：
% !Mode:: "TeX:UTF-8"
%符号后面的内容都是注释，不会被编译。这行特别的注释是指示一些文本编辑器以UTF-8编码打开该文件。需要注意的是，本模板的所有文件都是以“无BOM头的UTF-8”编码格式保存的。强调“无BOM头”的原因是Windows的记事本或微软的其他程序在保存文件为“UTF-8”编码时会存在一个“BOM头”，而其余编辑器在保存“UTF-8”编码时没有这个“BOM头”或者两种都支持。问题关键在于LaTeX不支持带“BOM头”的“UTF-8”编码。如果用Windows记事本编辑或模板中的文件，LaTeX并不会报错，而是会将“BOM头”变成一个本不该存在的空白页。
为了确保用户不会创建错误编码的文件，新建一章请不要自行创建文件。chapters目录中有一个DuplicateMe.tex文件，这是一个空白的章节文件。复制它，并重命名，然后在主文件中用\include命令将它插入到确定的位置即可。
模板使用的是LaTeX的标准章节命令。按照规范要求，存在四级章节。
\chapter{}章标题
\section{}一级节标题
\subsection{}二级节标题
\subsubsection{}三级节标题
在平时写论文时如果只是随意编译看看效果，可以不使用编译脚本进行编译，而是用你的TeX编辑器自带的编译命令或者按钮进行编译。只要选择的是pdflatex编译器就能得到基本正确的编译结果(如需参考文献等，分为下面四步：
1. 用LaTeX编译你的 .tex 文件 , 这是生成一个 .aux 的文件, 这告诉 BibTeX 将使用那些应用.
2. 用BibTeX 编译 .bib 文件.
3. 再次用LaTeX 编译你的 .tex 文件, 这个时候在文档中已经包含了参考文献, 但此时引用的编号可能不正确.
4. 最后用 LaTeX 编译你的 .tex 文件, 如果一切顺利的话, 这是所有东西都已正常了.
)。
这样的编译速度会比模板提供的编译脚本速度快。原因在于模板提供的编译脚本会进行3次编译并运行其他程序处理符号表和参考文献。（注意最后定稿请用模板提供的编译脚本进行最终的编译，不然可能存在摘要的首行没有空出两个中文空格的问题等。）