hellckt / shmtuthesis

上海海事大学 LaTeX 学位论文模板

欢迎使用 上海海事大学 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编辑器为例：

1. 首先使用编辑器打开该模板的main.tex文件；

2. 点击左上角的设置按钮，将Built-in TexpadTex Typesetter修改为External Typesetter；

3. 点击Typeset Configuration中的General设置Document Format为LaTeX，然后再将Typeset Engine修改为XeLaTeX；

4. 再点击Bibliographies设置Bibliography Engine为Biber；

5. 最后点击编译按钮即可。

Linux用户

命令行运行

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

VSCode编辑器

1. 安装Latex WorkShop插件；
2. 打开设置：点击左上角File，点击Preferences -> Settings；
3. 输入latex，点击Edit in setting.json；
4. 在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"
  ]
}]

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

Windows用户

1. 首先参考这篇blog安装 LaTeX环境和编辑器——Texlive 2019、TeXstudio，（补：blog中TeXstudio的官网挂了，换这个下载链接。）；
2. 并且按照上述blog进行TeXstudio的相关配置；
3. 导入本项目文件：文件—打开—选择项目中的main.tex——点击打开；
4. 点击工具栏上的构建并查看按钮（绿色双箭头），等待结果输出。（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 授权。

shmtuthesis's Issues

怎么能上传overleaf来进行在线修改并编译呢

参考文献禁止显示DOI号以及[S.l.: s.n.]

在CLS文件中，在相应宏包中加入如下命令

gbpub=false, doi =false,

\RequirePackage[backend=biber, gbpub=false, doi =false, style=\shmtu@bibstyle]{biblatex}

enabstract里加的模板那句话怎么删除？

[求助]编译时报错

系统环境：arch linux
已安装xelatex， biber

$ ./compile.sh run
main.tex

Rc files read:
  NONE
Latexmk: Run number 1 of rule 'xelatex'
This is XeTeX, Version 3.141592653-2.6-0.999994 (TeX Live 2022/Arch Linux) (preloaded format=xelatex)
 restricted \write18 enabled.
entering extended mode
Latexmk: Getting log file 'temp/main.log'
Latexmk: Missing bbl file 'temp/main.bbl' in following:
 No file temp/main.bbl.
Latexmk: Summary of warnings from last run of *latex:
  Latex failed to resolve 5 reference(s)
Latexmk: ====List of undefined refs and citations:
  Reference `fig:shmtu-school-motto' on page 5 undefined on input line 11
  Reference `fig:shmtu-school-motto-2' on page 5 undefined on input line 11
  Reference `fig:parallel-1' on page 5 undefined on input line 29
  Reference `fig:parallel-2-1' on page 6 undefined on input line 40
  Reference `fig:parallel-2-2' on page 6 undefined on input line 40
Collected error summary (may duplicate other messages):
  xelatex: Command for 'xelatex' gave return code 1
      Refer to 'temp/main.log' for details
Latexmk: If appropriate, the -f option can be used to get latexmk
  to try to force complete processing.
mv: 对 'temp/main.pdf' 调用 stat 失败: 没有那个文件或目录

公式编号中连字符问题

公式编号中的连字符，不应该使用破折号。而是采用hyphen
\renewcommand{\theequation}{\thechapter-\arabic{equation}}

LaTeX编译报错，请问如何修改？

Key 'ctex/option/zihao’ accepts only a fixed set of choices.

安装Texlive 2020新环境，存在CJKfilltwosides环境问题

问题描述:

编译文件显示wrong：Environment CJKfilltwosides undefined，错误定位在main文件\maketitle处

解决方法:
在项目sty文件中添加以下两行即可
% xeCJK > 3.8.3 宏包结构改动
\RequirePackage{xeCJKfntef}

你好，请问参考文献怎么让英文作者的首字母大写，而不是所有字母都大写啊？

有什么法子能够禁用算法目录么？

你好，请问如何在overleaf中使用呢？

如题
期待作者解答

想问下，如何将文献引用改为[1]序号引用，目前编译出来的是thesis第一行

你好，请问在哪设置可以使页眉显示当前页的章标题？是在cls文件里面改吗？

有没有overleaf的版本贡献一个呀

在Window10环境下，正文字体为华文中宋的问题

在Window10环境下，正文字体不是宋体的情况，可以在cls文件中添加一行，

\setCJKmainfont{SimSun}