同济大学本科生毕业设计论文模板 | Tongji Univer-tongji-undergrad-thesis.zip

# :page_facing_up: 同济大学本科生毕业设计论文模板（理工类） 中文 | [English](README-EN.md) > * **注意**：使用该模板你会获得 **pdf** 文件作为输出。但在毕业设计过程中可能存在需要提交 docx 等格式文件的场合，这时你可以使用一些 **pdf 转 docx 工具**，比如：[pdf2go.pdf-to-word](https://www.pdf2go.com/pdf-to-word))。 > * 你 **不需要担心** “抛弃 1 系统的 docx 模板而选用本 LaTeX 模板是否会受到影响”，毕竟使用该模板的我们（[2017-ganler](https://github.com/ganler), [2018-skyleaworlder](https://github.com/skyleaworlder)）都没有因格式问题而被勒令重新排版论文。 ## 样例展示 > 完整样例可见 [模板输出样例展示（完整版）](https://github.com/TJ-CSCCG/tongji-undergrad-thesis/discussions/21)、[Release 页](https://github.com/TJ-CSCCG/tongji-undergrad-thesis/releases) 中 "Assets" 下的 pdf 下载链接或 [Overleaf 模版 PDF](https://www.overleaf.com/latex/templates/tongji-university-undergraduate-thesis-template/tfvdvyggqybn.pdf)。 以下依次展示 “封面”、“中文摘要”、“目录”、“主要内容”、“参考文献” 与 “谢辞”。 <p align="center"> <img src="https://media.githubusercontent.com/media/TJ-CSCCG/TJCS-Images/tongji-undergrad-thesis/preview/main_page-0001.jpg" width="30%"> <img src="https://media.githubusercontent.com/media/TJ-CSCCG/TJCS-Images/tongji-undergrad-thesis/preview/main_page-0002.jpg" width="30%"> <img src="https://media.githubusercontent.com/media/TJ-CSCCG/TJCS-Images/tongji-undergrad-thesis/preview/main_page-0004.jpg" width="30%"> <img src="https://media.githubusercontent.com/media/TJ-CSCCG/TJCS-Images/tongji-undergrad-thesis/preview/main_page-0005.jpg" width="30%"> <img src="https://media.githubusercontent.com/media/TJ-CSCCG/TJCS-Images/tongji-undergrad-thesis/preview/main_page-0010.jpg" width="30%"> <img src="https://media.githubusercontent.com/media/TJ-CSCCG/TJCS-Images/tongji-undergrad-thesis/preview/main_page-0011.jpg" width="30%"> </p> ## 使用方法 ### 1. 通过 **Overleaf** 模板直接使用 您可以通过以下链接访问我们的 Overleaf 模板并使用：[](https://www.overleaf.com/latex/templates/tongji-university-undergraduate-thesis-template/tfvdvyggqybn) 请注意，该 Overleaf 模板已经及时更新。我们鼓励您直接使用该模板来编写您的本科毕业论文，也可以将该模板导入到自己的 Overleaf 项目中进行使用。具体操作方法请参考本文档下一节。 > **注意！** 在使用 Overleaf 模板时，请务必检查编译器和主入口的设置： > > * 将 `main.tex` 文件设为主入口文件，而不是项目中的其他 `.tex` 文件（尤其是 `tongjithesis.cls` 或 `tongjithesis.sty`）； > * 推荐使用 `XeLaTeX` 和 `LuaLaTeX` 编译器，本模板不支持某些编译器（如 `pdfLaTeX`）。 ### 2. 在 **Overleaf** 上导入本仓库 * 通过本仓库主页项目文件列表上方的 “Code | Download ZIP” 下载本仓库； * 打开 [Overleaf](https://www.overleaf.com/)； * 通过拖拽下载的 `zip` 文件上传至 Overleaf。 ### 3. 在 Mac / Linux 上使用 #### i. 安装 Python - 对于 Mac：大多数 Mac 上已经预装了 Python。如果你还没有安装，可以从官网下载安装：https://www.python.org/downloads/mac-osx/ - 对于 Linux：在终端中输入以下命令来安装 Python： ```shell sudo apt-get install python3 ``` 当安装完 Python 后，你需要设置环境变量 `PATH`，将 Python 的路径添加进去。这样才能在 LaTeX 中正确调用 `minted` 宏包。 #### ii. 使用 `pip` 安装 `pygmentize` 在终端中输入以下命令： ```shell pip install Pygments ``` 注意：如果你在安装过程中遇到了权限问题，可以在命令提示符中使用管理员权限运行以上命令。 #### iii. 使用 tlmgr 下载 TeXLive，并使用 `tlmgr` 下载宏包： ```shell # The following commands aims at installing packages upon TeXLive without any packages. # You can also install BasicTex: https://mirrors.chevalier.io/CTAN/systems/mac/mactex/mactex-basictex-20210325.pkg sudo tlmgr update --self sudo tlmgr install adjustbox algorithmicx algorithms biber biblatex biblatex-gb7714-2015 bibtex booktabs \ caption carlisle cases catchfile chinese-jfm chngcntr cleveref collectbox ctex dvips \ enumitem environ extarrows fancybox fancyhdr fancyvrb float framed fvextra \ gbt7714 gsftopk helvetic hologo ifplatform lastpage latexmk lineno \ minted multirow mwe natbib needspace newtx nth oberdiek pdftexcmds realscripts rsfs setspace siunitx subfig \ tcolorbox texcount texliveonfly threeparttable threeparttablex times titling tocloft \ trimspaces txfonts ucs upquote was xcolor xecjk xstring zhnumber sudo tlmgr update --self --all ``` #### iv. 通过 Makefile 构建项目 > 感谢 [SJTUThesis](https://github.com/sjtug/SJTUThesis) 项目的 Makefile 文件。 你可以通过下列指令完成对应操作： ```shell make all # compile main.pdf make ENGINE=$ENGINE all # use $ENGINE(where $ENGINE=-xelatex or -lualatex) to compile main.pdf make clean # rm intermediate files make cleanall # rm all intermediate files (including .pdf) make wordcount # wordcount ``` ### 4. 在 Windows 上使用 #### i. 安装 Python 1. 下载 Python 安装程序：在 [Python 官网](https://www.python.org/downloads/windows/) 上下载 Python 的安装程序（注意：下载的版本需要与你的操作系统版本和位数相匹配）。 2. 运行 Python 安装程序：双击下载的安装程序并按照提示进行安装。在安装过程中，记得勾选 `Add Python 3.x to PATH` 选项，这样 Python 才能在命令行中使用。 #### ii. 使用 `pip` 安装 `pygments` 在终端中输入以下命令： ```shell pip install Pygments ``` 注意：如果你在安装过程中遇到了权限问题，可以在命令提示符中使用管理员权限运行以上命令。 注意：若您担忧将某个具体版本的 Python 加入环境变量存在潜在的环境污染隐患，希望使用 Python 环境管理应用，则步骤如下： - 创建一个新的 Python 环境，在环境中安装 `pygments` 模块 - 按照`main.tex`中的注释，在文件中直接指定该环境路径。 #### iii. 安装 TeXLive 通过 [此处](https://www.tug.org/texlive/acquire-netinstall.html) 下载 `install-tl-windows.exe`。 注意：安装过程中会下载8GB左右的数据，请耐心等待。 #### iv. 通过 Batchfile 构建项目 > 感谢 [SJTUThesis](https://github.com/sjtug/SJTUThesis) 项目的 Compile.bat 文件。 你可以通过下列指令完成对应操作： ```bat .\make.bat # the same to "make.bat thesis" .\make.bat thesis # compile main.pdf .\make.bat thesis $ENGINE # use $ENGINE(where $ENGINE=-xelatex or -lualatex) to compile main.pdf .\make.bat clean # clean all work files by latexmk -c .\make.bat cleanall # clean all work files and main.pdf by latexmk -C .\make.bat wordcount # wordcount .\make.bat help # read the manual ``` 至此，您已经可以借助LaTex撰写论文了。若相比命令行，您更倾向于在一个完整的UI环境中进行操作，请继续查阅以下内容。 ### 5. 在 VSCode 上使用 #### i. 配置 VSCode 在插件市场中安装 LaTeX Workshop 插件，此后下载该项目，并在该项目根目录打开。（LaTeX Workshop 只是一个插件，仍需要下载对应平台下的 `TeXLive`） > **注意**：下列配置已被项目中 `.vscode/settings.json` 包含。正常情况下，启动 LaTeX Workshop 插件时会自动装载配置。