This template is for undergraduate thesis at Wuhan University of Techology. LaTeX is a popular typesetting document preparation system in many scientific fields. All questions and suggestions are welcomed, please file an issue in this repo.

本模板是武汉理工大学本科生毕业论文LaTeX免费模板（非官方）。LaTeX是一个流行的编辑科学类文章的工具。 大多数科学类书籍，期刊，文章都采用了LaTeX。 使用这个模板可以使你从无聊的格式限制中解脱出来，从而更专注地阐述自己的想法。 希望本模板能够帮助你入门LaTeX, 如果你有关于本模板的良好意见和建议，请在顶栏的问题(issue)一栏中提出。

你可以选择安装 texlive 或者 MiKTeX ；texlive 有多种安装包，可以选择适合你需求的包下载：

• texlive-base - 136 MB
• texlive-latex-recommended - 177 MB
• texlive - 240 MB
• texlive-latex-extra - 404 MB
• texlive-full - 4714 MB

但是 Linux 下的 texlive 暂时没有自动下载宏包的能力，这意味着如果你下载的 texlive 不是完整版，你可能会缺少需要的宏包；所以这里推荐使用 miktex，它可以按需安装宏包，更轻便，你可以使用下面的命令快速安装 miktex，或者查看详细的 MiKTeX 安装步骤：

1. 注册 GPG 秘钥

   sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys D6BC243565B2087BC3F897C9277A7293F59E4889

2. 添加安装源

   如果你是 Ubuntu 18.04：

   echo "deb http://miktex.org/download/ubuntu bionic universe" | sudo tee /etc/apt/sources.list.d/miktex.list

   如果你是 Ubuntu 16.04：

   echo "deb http://miktex.org/download/ubuntu xenial universe" | sudo tee /etc/apt/sources.list.d/miktex.list

3. 安装 MiKTeX

   sudo apt-get update
   sudo apt-get install miktex

4. 设置 MiKTeX

   在 application 中搜索 MiKTeX Console 并打开，点击Finish private setup等待配置完成即可。

   

1. 配置环境

   使用任意你喜欢的文本编辑器，这里推荐使用 VSCode ，并安装 LaTeX Workshop 插件。

   

本模板已经为你配置好了编译工具链，设定主文档为thesis.tex，可以在 VSCode 中的 command palette 键入build with recipe并选择xelatex -> bibtex -> xelatex*2手动触发编译。等待 VSCode 编译完毕，左下角显示绿色钩√符号（第一次 build 时间可能较长），在 command palette 键入view latex PDF file查看以 PDF 。

如果你对 LaTeX 语法还不熟悉，可以从下面的链接中快速上手：

• Overleaf: Creating a document in LaTeX

欢迎补充

欢迎补充

欢迎补充

如果你需要 latex 代码格式化，你需要安装 cmhughes/latexindent.pl，安装方法可参考latex-formatter - Visual Studio Marketplace。安装完成后在 LaTeX Workshop 的 latex-workshop.latexindent.path 中配置 latexindent路径即可。

如果报错stderr: Can't locate Log/Log4perl.pm in @INC (you may need to install the Log::Log4perl module)请尝试使用下面命令安装 Log4perl ：sudo apt-get install -y liblog-log4perl-perl

• How to install LaTex on Ubuntu 18.04 Bionic Beaver Linux

• Install MiKTeX for Linux - MiKTeX.org

• mtobeiyf/whu-thesis

• tsaoyu/WHUT-LaTeX-bachelor