# BIT-thesis-LaTex
LaTeX Template for BIT thesis

LaTeX 论文写作填坑/拓展指南 & 模板简介可参考Helper_manual/Helper_manual.pdf,**欢迎补充完善**。。。该模板基于项目<https://github.com/BIT-thesis/LaTeX-template>修改，以下模板使用说明也基于该项目README.md。

### [环境安装与配置](https://github.com/BIT-thesis/LaTeX-template) 
- windows、linux用户推荐安装TeX Live套装，并更新宏包。[北理工TeX Live镜像](http://mirror.bit.edu.cn/CTAN/systems/texlive/Images/)
- OSX用户推荐安装Mac TeX。[北理工Mac TeX镜像](http://mirror.bit.edu.cn/CTAN/systems/mac/mactex/)
- 由于CTeX套装所含宏包比较陈旧，可能会导致编译无法通过，故不推荐安装。如果已安装CTeX，建议将其卸除。
- 鉴于Texlive安装包过大和跨版本更新不支持，喜欢折腾的，可以安装MikTex，目前全平台支持，具体下载和安装方法可以参考[MiKTeX安装](https://miktex.org/)
### 使用方式
下载文件后，Windows 系统请点击运行 `BIT-thesis-run.bat` 脚本，Linux 系统以及 mac OS 系统请点击运行 `BIT-thesis-run.sh` 脚本。脚本会自动运行生成文档 `demo.pdf`。
若使用**硕士**论文模板，请在`demo.tex`中`\documentclass`命令采用`master`选项；若使用**博士**论文模板，请使用`doctor`选项。
```
\documentclass[oneside, master, normal]{BIT-thesis-grd-jdh} %硕士模板
\documentclass[oneside, doctor, normal]{BIT-thesis-grd-jdh} %博士模板 
```
- 模板选项： 硕士论文 master； 博士论文 doctor
- 正常模式：normal  自查重模式：selfSimilarCheck  盲审模式：blindCheck
（1）提交学校的查重文件可以直接使用normal模式结果;

（2）自查重模式主要用于关闭图片、公式等内容的显示，以减少文章字符数和降低PDF转word过程中出现的乱码，节省查重费用支出。应结合\insertcontents系列命令使用。对于土豪此选项没有任何卵用。。。。。;

（3）盲审模式主要根据盲审文件格式要求，隐去了作者、导师、致谢等信息，更改发表论文的格式。

所有.tex都采用**UTF-8**编码格式
##  通过 XeLaTeX 编译
- 手动模式编译：完整的处理流程是：
```
    xelatex -no-pdf --interaction=nonstopmode demo
    bibtex demo
    xelatex -no-pdf --interaction=nonstopmode demo
    xelatex --interaction=nonstopmode demo
```
- 编译器编译：
采用智能编辑器编译，必须设置默认的tex编译引擎为xelatex，具体可以在每个编辑器中的设置——编译器-Xelatex，推荐用编译器编译

- 附加的编译方法：模版包含了latexmk设置文件，可以进行一体化编译。将命令行工作目录切换到项目文件夹下，执行
```bash
latexmk
```
命令即可自动调用相关程序进行编译，处理各种文件依赖并自动预览。执行`latexmk -c`命令清理所有缓存文件。也可以使用TeXstudio、Texmaker或WinEdt等编辑调用`latexmk`编译，请将编译引擎设置成latexmk。另外在Windows平台下使用MikTeX可能还需要安装Perl语言解释器

`到文档最后成稿，只需要小改的时候，才推荐用批处理就行操作，不然很难定位错误。`

### 基于[源项目](https://github.com/BIT-thesis/LaTeX-template) 新增/修改的内容
- 新增普通模式(normal)、自查重模式(selfSimilarCheck)和盲审模式(blindCheck)。提交学校的查重文件可以直接使用normal模式结果；自查重模式主要用于关闭图片、公式等内容的显示，以减少文章字符数和降低PDF转word过程中出现的乱码，节省查重费用支出,应结合\insertContents等系列命令使用,对于土豪此选项没有任何卵用。。。。。(仅供参考)；盲审模式主要根据盲审文件格式要求，隐去了作者、导师、致谢等信息，更改发表论文的格式
- 增加\makeVerticalenWords命令，修改英文单词树立排放时的显示效果。
- 增加书脊中作者姓名显示。
- 增加对mathptmx包的引用，修改公式字体为New Time Roman。
- 新增\pubitem命令，用于显示学术成果。在盲审模式下该命令将会隐去作者信息。
- 新增\sayThanks命令，用于致谢。在盲审模式下该命令指定的致谢内容将不被显示。
- 新增\insertContents、\insertFigure、\insertTable、\insertEquation系列指令，该指令用于自查重模式下选择性指定不显示的内容。}
- 新增\ncite、\nupcite、\nref命令，自查重模式下将不显示。
- 修改了官方v1.5版本中文献引用标注显示的字号和颜色。
- 目录中章节标题取消加粗显示。
- 打印中文信息的命令更改为\makeChineseInfo,在盲审模式下不显示中英文个人信息。
- 修改英文信息中下划线的长度。

### 对于想使用Vscode工具进行编写的朋友，可以参照以下方法
- 下载安装VScode，搜索安装LaTeX WorkShop插件
- 选择“文件-首选项-设置”进入设置界面，搜索“setting.json”打开，添加项目中“setting.json”文件内容
- 使用VScode时，选择LATEX-COMMANDS-Build LaTeX project-Recipe：BIT_thesis，保存文档后编辑器会根据设置自动编译更新。 

###  致谢
本模板基于[北京理工大学硕士（博士）学位论文LaTeX模板 BIT-Thesis v1.5](https://github.com/BIT-thesis/LaTeX-template)修改，感谢作者[Yang Yating](https://github.com/y-yating/), [Wang Wei](https://github.com/qiuzhu/)的贡献。