FAQ

What's it?

UCASThesis is a LaTeX thesis template package for University of Chinese Academy of Sciences in order to make it easy to write thesises for either master or doctor. This template pacagge is derived from the ThuThesis.

UCASThesis 是**科学院大学学位论文 LaTeX 模板，支持硕士、博士论文格式。该模板基于清华大学ThuThesis二次开发。本模板目前已经针对**科学院计算技术研究所的论文模板进行调整，但由于中科院各院所的模板规范并非完全一致，其余院所的同学可能需要进行一些必要的修改。

版权须知

This file may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3a of this license or (at your option) any later version. The latest version of this license is in:

http://www.latex-project.org/lppl.txt

and version 1.3a or later is part of all distributions of LaTeX version 2004/10/01 or later.

使用须知

本模板强烈建议使用texlive 2014或以上版本、MikTex2.9或以上版本编译，请不要使用CTEX。

特别注意的是， CTEX 可能由于内置宏包老旧，暂时无法支持 UCASThesis 模板，随之可能会产生"ifxetex","zhnumber.sty not found"等问题。

确定系统中存在xfig，transfig依赖(Mac OSX 系统可尝试通过port进行安装)。
确保当前系统已安装配置SimSun，SimHei，KaiTi，FangSong字体，如果您使用的是Linux和Mac OSX系统，请自行以“fc-cache 添加 win 字体”为关键字通过Google搜索解决方案)。备用方案：如果您并不想安装其他字体，而仅使用系统自带的兼容字体（不建议这样做），则可利用以下命令交互式地完成字体配置

python zhfonts.py

使用方法

编译示例文档 xelatex main bibtex main xelatex main xelatex main

说明：也可以使用 pdflatex/latex+dvipdfmx 生成文档。
编写自己的论文参考示例文档： main.tex 主控文档 data/ 论文具体内容 ref/ 参考文献目录 figures/ 图片目录

如何获取/升级

如需以git方式获取，git clone https://github.com/xiaoyao9933/UCASthesis
如需直接获取压缩包文件，请下载 https://github.com/xiaoyao9933/UCASthesis/archive/master.zip
建议通过git pull方式更新模板，如果你之前已经完成论文的一部分写作，则可以通过下载新版模板包里的ucasthesis.cls、ucasthesis.cfg以及ucasthesis.dtx文件，替换至你的论文目录中完成模板更新；也可以通过下载新版模板后，拷贝入含有写作内容的main.tex,data/figures/ref目录进行更新。

Makefile Howto (by xiaoyao9933 & edyfox & littleleo)

获取帮助文档

make doc 得到 ucasthesis.pdf，帮助文档，里面有详细的说明。
生成示例文档

make thesis
生成书脊示例

make spine

附录： Makefile 命令详解：

Makefile：

使用方法：

    make [{all|thesis|spine|doc|clean|distclean}] \
        [METHOD={xelatex|pdflatex|dvipdfmx}] \
        [TEXI2DVI=<tex2dvi>]

参数说明：

    make all       等于 make thesis && make spine && make doc；
    make cls       生成模板文件，相当于 make -f thesis.mak cls；
    make thesis    生成论文，相当于 make -f thesis.mak；
    make spine     生成书脊，相当于 make -f spine.mak；
    make doc       生成使用说明书，相当于 make -f doc.mak；
    make clean     表示清除除了 pdf 外的所有中间文件和目标文件；
    make distclean 表示清除包括 pdf 在内的所有中间文件和目标文件。

    METHOD 参数用来指定生成 pdf 的方式，

    METHOD=xelatex  表示使用 xelatex 引擎编译生成 pdf；
    METHOD=pdflatex 表示使用 pdflatex 引擎编译生成 pdf，请确保有相应的cjk字体配置；
    METHOD=dvipdfmx 表示使用 texi2dvi -> dvipdfmx 的方式生成 pdf，请确保有相应的cjk字体配置；

    如果缺省，则采用 xelatex 方式，同时我也建议只使用该方式编译。

    TEXI2DVI 表示 texi2dvi 实用工具的文件名，该工具的作用是自动重复运行
    latex 若干遍，直至所有交叉引用都正确为止。在有的发行版中该工具的文件名
    不叫 texi2dvi，譬如 CTeX 下的这个工具就叫 texify。遇到这种情况你可以在
    命令行通过 TEXI2DVI=texify 命令指定使用其它的 texi2dvi 工具。

OlivasLee/UCASthesis