西电Latex论文模板使用经验总结

西安电子科技大学的论文Latex模板，教务处所公布的版本稍显落后。

当前，仍在维护更新的是 xduts[1] 这个公益开源版本。

维护者为其编写了详尽的接口说明[2]，然而，没有提供一个初学者友好的项目模板和配置教程，导致上手存在一定门槛。

本文就来记录一下从空环境到完成部署编译的捣鼓历程。

Latex下载安装

这个项目适用于Windows/Linux/MacOS，以及在线的编辑器Overleaf。

如果是Windows系统，则需要下载安装TeX Live；Mac系统，则需要下载安装 MacTeX。

下载完后，可以执行latex -v，查看所安装的版本。

如果安装得较早，可以用以下命令更新TeX Live 系统及所有已安装宏包：

sudo tlmgr update --all --self

Vscode环境配置

下面用vscode来作为本地Latex的编辑器，tex studio也可以，但操作体验不如vscode。

在vscode中，需要安装 LaTeX Workshop 这个插件。

安装完后，需要修改配置文件，以让其支持 xelatex->biber->xelatex 这个编译链。

具体方式是按 Ctrl+Shift+P，输入 Preferences: Open User Settings (JSON) ，打开用户配置文件。

在下面添加以下条目[3]。

"latex-workshop.latex.tools":[{"name":"xelatex",// 负责中文编译"command":"xelatex","args":["-synctex=1","-interaction=nonstopmode","-file-line-error","%DOCFILE%"]},{"name":"biber",// 负责引用文献"command":"biber","args":["%DOCFILE%",]},],"latex-workshop.latex.recipes":[{"name":"xelatex -> biber -> xelatex","tools":["xelatex","biber","xelatex"]},],"latex-workshop.latex.autoBuild.run":"never",// 关闭自动编译"latex-workshop.showContextMenu":true,"latex-workshop.intellisense.package.enabled":true,// 开启自动补全"latex-workshop.message.error.show":true,// 开启Error弹窗提示"latex-workshop.message.warning.show":false,//关闭Warning弹窗提示"latex-workshop.latex.autoClean.run":"onBuilt",// 编译后自动清除中间文件"latex-workshop.latex.clean.subfolder.enabled":true,//清除子文件目录中的文件"latex-workshop.latex.recipe.default":"lastUsed",// 自动使用上一次的编译器"latex-workshop.view.pdf.internal.synctex.keybinding":"double-click","latex-workshop.synctex.afterBuild.enabled":true,

配置完之后，就可以在插件侧边栏中看到该编译链选项。

部署模板

从官方仓库部署

如果是从官方仓库[1]中进行构建，可下载源码，并用以下命令编译宏包。

gitclone https://github.com/note286/xduts.git xetex xduts.ins l3build doc

从个人仓库部署

近两年的texlive发行版中，已经内置了xduts，因此不要从源码编译，可以直接下载完成度更高的模板。

当前，已经有人为本科毕业论文，构建了xduts_demo[4]这个模板。

而研究生毕业论文的模板尚未有人公开完整提供，因此我捣鼓了一个xduts_xdupg_demo[5]模板，可以下载之后，在vscode中，打开main.tex文件。

然后，右键->Build LaTeX project。

如果编译成功，会在项目中输出 main.pdf 文件。

拓展阅读

如果没有Latex基础，推荐看我四年前录制的半小时搞定Latex教程[6]快速入门。

对于一些复杂的图表公式排版，可进一步看xduts作者在讨论区的补充示例说明[7]。

表格/数学公式如需转换成Latex格式，可使用FreeTool中的在线转换工具[8]。

参考

[1] https://github.com/note286/xduts
[2] https://mirrors.ibiblio.org/pub/mirrors/CTAN/macros/xetex/latex/xduts/xduts.pdf
[3] https://zhuanlan.zhihu.com/p/696132299
[4] https://github.com/ChambersXDU/xduts_demo
[5] https://github.com/zstar1003/xduts_xdupg_demo
[6] https://www.bilibili.com/video/BV1aT4y1f74w
[7] https://github.com/note286/xduts/discussions/40
[8] https://xdxsb.top/FreeTool/#table-converter