欢迎使用上海海事大学 LaTeX 学位论文模板(SHMTUThesis - LaTeX )

本项目是上海海事大学学位论文（非官方）LaTeX 模板文档。

目前该模板仅适用于信息工程学院的硕士生。（未参考其他学院的论文要求）

项目介绍

本项目模板文档是基于 LaTeX 语法编写，模板格式参考了过往硕士毕业生的学位论文以及《上海海事大学学位论文与摘要的统一要求》。

本模板的示例文件中包含了排版中常用的例子，其中包括公式、表格、算法、参考文献等，用户可以参考或者直接基于此示例文档撰写论文。模板预览效果参看main.pdf。

环境依赖

本模板仅支持XeTeX引擎——XeLaTeX，字符编码仅支持UTF-8。

使用方法

目前已在macOS、Linux、Windows环境下编译运行通过，由于测试用例较少有任何问题欢迎在Requests中提出。

编译设置主要是将排版引擎（Typeset Engine）设置为XeLaTeX；文献引擎（Bibliography Engine）设置为Biber。

设置完毕后进行编译即可得到PDF文件。

注意：如果编译过程中出现XITS、LISU和YOUYUAN字体缺失错误，请在本项目的fonts目录中安装字体。

macOS用户

推荐下载texpad、texlive或其他类型的LaTeX编辑器使用，也可以下载安装好LaTeX相关环境后，使用项目中提供的compile.sh脚本进行编译。以texpad编辑器为例：

首先使用编辑器打开该模板的main.tex文件；
点击左上角的设置按钮，将Built-in TexpadTex Typesetter修改为External Typesetter；
点击Typeset Configuration中的General设置Document Format为LaTeX，然后再将Typeset Engine修改为XeLaTeX；
再点击Bibliographies设置Bibliography Engine为Biber；
最后点击编译按钮即可。

Linux用户

命令行运行

首先，安装latexmk和biber，sudo apt-get install latexmk biber；
然后，在SHMTUThesis目录下运行./compile.sh run，等待论文生成即可。

VSCode编辑器

安装Latex WorkShop插件；
打开设置：点击左上角File，点击Preferences -> Settings；
输入latex，点击Edit in setting.json；
在latex-workshop.latex.tools和latex-workshop.latex.recipes下配置biber：

"latex-workshop.latex.tools": [{
  "name": "biber",
  "command": "biber",
  "args": [
    "%DOCFILE%"
  ]
}]
 
"latex-workshop.latex.recipes": [{
  "name": "xe->bib->xe->xe",
  "tools": [
    "xelatex",
    "biber",
    "xelatex",
    "xelatex"
  ]
}]

修改完配置后，在编辑器内打开main.tex；
点击左边的TEX按钮，选择Build LaTex Project，再点击Recipe: xe->bib->xe->xe即可。

Windows用户

首先参考这篇blog安装 LaTeX环境和编辑器——Texlive 2019、TeXstudio，（补：blog中TeXstudio的官网挂了，换这个下载链接。）；
并且按照上述blog进行TeXstudio的相关配置；
导入本项目文件：文件—打开—选择项目中的main.tex——点击打开；
点击工具栏上的构建并查看按钮（绿色双箭头），等待结果输出。（pdf文件和一些其他文件会一同生成在项目文件夹根目录中）。

如何自定义模板文档？

main.tex是论文主体文件，该文件负责将论文中的每个部分组合起来从而形成完整的论文架构。在进行论文书写时，可以对main.tex中的每个子模块进行增加、删除、修改等具体操作，但必须保证information.tex中的字段都是存在的。

.
├── figures                         # 图片目录
├── tex                             # 解耦后论文目录
│   ├── achievements	            # 攻读学位期间的成就汇总目录
│   │   ├── awards.tex              # 获奖情况
│   │   ├── patents.tex             # 申请的专利
│   │   ├── projects.tex            # 参与的项目
│   │   └── publications.tex	    # 发表或已收录的论文
│   ├── appendix                    # 附录目录
│   │   ├── flow_chart.tex          # 流程图示例
│   │   └── maxwell_equations.tex   # 附录示例
│   ├── abstract.tex                # 中英文摘要示例
│   ├── acknowledgements.tex        # 致谢示例
│   ├── float.tex                   # 浮动体示例（包括图、表、算法、代码）
│   ├── information.tex             # 信息录入（该文件中的字段都是必须的）
│   ├── introduction.tex            # 绪论示例
│   ├── math_and_citations.tex      # 数学符号与文献引用示例
│   └── summary.tex                 # 总结示例
└── main.tex                        # 论文主体文件

问题反馈

如果在使用上有任何问题或者改进建议，请在主页中开个Issue。

致谢

感谢 LaTeX 开源项目组；
感谢 CTeX-kit提供了 LaTeX 的中文支持；
感谢上海交大大学的sjtug项目组提供的开源模板，为本模板提供了基础代码;
感谢melochin和PrisonerAZ提供的Linux、Windows编译说明。

软件许可证

本项目中所使用到的上海海事大学校徽、校名图片（shmtu-badge.jpg 等）的版权归上海海事大学所有；
shmtuthesis.cls 文档类与相关附属文件使用 LPPL 授权；
其他部分使用 Apache License 2.0 授权。

hellckt/SHMTUThesis

欢迎使用 上海海事大学 LaTeX 学位论文模板(SHMTUThesis - LaTeX )