Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update build_test.yml #400

Closed
wants to merge 7 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
149 changes: 1 addition & 148 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,148 +1 @@
# 浙江大学学位论文 LaTeX 模板

[![ZJUTHESIS](https://img.shields.io/badge/zjuthesis-latex-blue.svg)](https://thenetadmin.github.io/zjuthesis)
[![GitHub release](https://img.shields.io/github/release/TheNetAdmin/zjuthesis.svg?label=version&style=popout)](https://github.com/TheNetAdmin/zjuthesis/releases/latest)
[![GitHub All Releases](https://img.shields.io/github/downloads/thenetadmin/zjuthesis/total.svg?color=blue&style=popout)](https://github.com/TheNetAdmin/zjuthesis/releases/latest)
[![Commit Since Latest Release](https://img.shields.io/github/commits-since/TheNetAdmin/zjuthesis/latest.svg)](https://github.com/TheNetAdmin/zjuthesis/commits/master)
[![GithubAction](https://github.com/TheNetAdmin/zjuthesis/workflows/Build%20Tests/badge.svg)](https://github.com/TheNetAdmin/zjuthesis/actions)
[![GitHub Discussion](https://img.shields.io/badge/github-discussion-blue)](https://github.com/TheNetAdmin/zjuthesis/discussions)

## 简介

本项目为浙江大学学位论文的 LaTeX 模板,包含本科生、硕士生与博士生模板,以及英文硕博士模板。

This is a LaTeX template for Zhejiang University graduation thesis/design.
It provides undergraduate and graduate (master and doctor) templates.
It also provides an English template for graduate students.
See [English template user manual](./docs/english.md) for more details.

[CC98 校内讨论贴](https://www.cc98.org/topic/4762356)

[GitHub 讨论版](https://github.com/TheNetAdmin/zjuthesis/discussions)

## 使用

zjuthesis 模板有三种使用方式,Overleaf,本地编译,或者 Container 编译:

- Overleaf 是一个线上 LaTeX 编辑器,可以在不安装任何工具的情况下编写 LaTeX 文档,同时也可以和其他人共享文档,共同编辑。
- 本地编译比 Overleaf 更快,而且本地编译可以使用 Git 来记录版本。推荐有能力的同学设置本地编译环境,并推荐使用 Visual Studio Code 配合 LaTeX workshop 插件 (vscode 使用方式见[FAQ](./docs/FAQ.md))。
- Container 编译是使用 GitHub 提供的 Codespace 搭配 Container 来编译,这个环境提供了浏览器内的 VS Code 界面以及 TeX Live 的编译环境。这种方式适合熟悉 Container 与 GitHub Codespace 相关用法的同学使用。

### Overleaf

1. [下载模板代码](https://github.com/TheNetAdmin/zjuthesis/releases) 中的 `zjuthesis-v*.*.*-overleaf.zip` 文件
1. 在 Overleaf 中上传这个 .zip 压缩文件以创建一个新 Overleaf 项目
1. 在 Overleaf 界面左上角点击 "Menu"
- 选择 "Compiler" 为 "XeLaTeX"
- 选择 "TeX Live version" 为 "2019" 或者更新的版本
1. 参照 Overleaf 项目中 `fonts/README.md` 的说明下载所需字体,并上传到 `fonts` 文件夹中
1. 使用 Overleaf 编译
- 选择专业模板与毕业学位的方式参见下文 "本地编译"

### 本地编译

1. 安装 TeXLive 工具包,编译需要 XeTeX 引擎。安装过程可以参考[浙江大学镜像站提供的文档](https://mirrors.zju.edu.cn/docs/CTAN),以便在校内网下更快下载。
1. [下载模板代码](https://github.com/TheNetAdmin/zjuthesis/releases),
每个专业模板都有预览 pdf 文件,可以单独下载查看。
模板代码请下载 `zjuthesis-v*.*.*.zip` 文件
(如果你在用 Clone 或者 Fork 得到的代码,请切换到最新的 release tag,避免 master 分支上的不稳定更新破环你的论文的样式)
1. 在 `zjuthesis.tex` 中 `\documentclass[]{zjuthesis}` 部分填写个人信息,其中以下信息用于控制文档的生成:

- `Degree` 为 `undergraduate` 时,编译本科生论文:

| Field | Option 1 | Option 2 | Option 3 |
| :---------- | :----------------------------------- | :------------------------------------- | :--------------------------------- |
| Type | thesis: 论文类 | design: 设计类 | |
| Period | proposal: 开题报告 | final: 最终论文/设计(含开题报告) | paper: 最终论文/报告(无开题报告) |
| BlindReview | true: 生成盲审用 pdf(隐藏个人信息) | false: 生成提交用 pdf | |
| MajorFormat | general: 默认模板 | 与 `config/format/major/` 下目录名相同 | |

- `Degree` 为 `graduate` 时,编译硕士生/博士生论文:


| Field | Option 1 | Option 2 |
| :---------- | :----------------------------------- | :------------------------------------- |
| Type | thesis: 学术论文 | design: 专业学术论文 |
| BlindReview | true: 生成盲审用 pdf(隐藏个人信息) | false: 生成提交用 pdf |
| MajorFormat | general: 默认模板 | 与 `config/format/major/` 下目录名相同 |
| GradLevel | master: 硕士 | doctor: 博士 |

- 其他设置

| Field | Option 1 | Option 2 |
| :------------ | :---------------------------------------- | :------------------ |
| PrintFilePath | true: 在每页侧边打印该页对应 TeX 文件路径 | false: 不打印此输出 |
| TwoSide | true: 章节末的偶数页留白,保证下章节的标题位于奇数页 | false: 取消偶数页留白 |

1. 在 `body` 目录下编写内容
1. 在 `pages` 目录下填写必要的内容,如审核评语等
1. 在 `figure` 目录下保存图片,在 `body/ref.bib` 内插入文献条目
1. 在根目录下运行命令 `latexmk`(或者 `latexmk -xelatex -outdir=out zjuthesis`)即可使用 XeTeX 编译 pdf 文件到 `out` 目录(该目录不会被记录版本)。**请务必使用此 `latexmk` 命令进行编译(除非你已经了解 LaTeX 的工作机制),否则你可能遇到参考文献无法显示等问题**
1. 如需使用 LuaTeX 编译,可运行命令 `latexmk -pdflua -outdir=out`

> **注意**
>
> - 每年的三月底四月初会有 TeXLive 的版本升级,届时本模板会根据 TeXLive 的更新做出一定的修改,请在提交最终论文前查看并应用本模板的更新。
> - 如果你使用 Mac OS 10.15 及以上版本,并且 TexLive 中的 ctex 包版本低于 2.5,会产生[宋体字体判断问题](https://github.com/TheNetAdmin/zjuthesis/issues/79),导致编译得到的 pdf 中字体出现误差。要解决这个问题,可以将 ctex 包升级到 2.5 以上,或者临时在 ctex 包的选项中加入 `fontset=macnew`,详见 [issue 79](https://github.com/TheNetAdmin/zjuthesis/issues/79)。
> - 本模板已经兼容 TeXLive 2021。TeXLive 2018 以及之前的版本复制伪粗体文字会产生乱码,建议使用本地 TeXLive 的同学使用最新版 TeXLive。
> - 计算机专业的部分页面与学校通用格式不同,如果你是计算机专业的同学,请使用计算机专业的模板。

### 使用容器编译

本模板提供了一套配置文件,用以支持在容器中安装TeX Live,项目使用的字体,以及VS Code上的[LaTeX Workshop](https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop)插件,配合GitHub Codespaces可以做到开箱即用。感谢 [FUTURETECH6](https://github.com/FUTURETECH6) 同学贡献的[代码](https://github.com/TheNetAdmin/zjuthesis/pull/222)。

GitHub Codespace使用方法:

1. 创建个人的项目(直接fork,或自行clone并修改remote)
1. 在个人的项目主页点击"Code"
1. 点击"Codespaces"
1. 点击"New codespace"
1. 等待容器构建(这一过程约要10分钟,因为要在标准Ubuntu的镜像中安装TeX Live)
1. 构建完成后,可以选择在VS Code(需要[GitHub Codespaces](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces)插件)中或在浏览器中打开,然后按照在本地的使用方式使用

> **注意**
>
> - 这一功能的初衷是为了方便性能较弱的设备(例如低功耗笔记本电脑)也能利用免费的云运算资源较快地完成编译,因此**不建议**在本地性能较强的机器上使用(请改用"本地编译")。

### 字数统计

本模板提供了一个脚本用于统计正文字数,请在根目录下使用 `latexmk` 编译一遍模板,然后执行脚本 `script/utils/word_count.sh`。
此脚本调用了 `texcount` 工具,该工具是 TeX Live 的一部分,不需要额外安装。

## Slides 模板

作者用于毕业答辩的一个 Slides 模板 (Microsoft PowerPoint 模板)

- [GitHub 下载链接](https://github.com/TheNetAdmin/zjuthesis/releases/tag/v2.1.1-slide)
- [Gitee (国内镜像仓库)下载链接](https://gitee.com/netadmin/zjuthesis/releases/v2.1.1-slide) 国内网络用这个链接下载比较快

[HGGshiwo](https://github.com/HGGshiwo) 同学于 2021 年开发了基于 Beamer 的 Slides 模板,有兴趣的同学可以参考如下几个 repo

- [Formal](https://github.com/HGGshiwo/BeamerthemeFormal) (内含对其他几个 Beamer 模板的简介)
- [Brief](https://github.com/HGGshiwo/BeamerthemeBrief)
- [Mixture](https://github.com/HGGshiwo/BeamerthemeMixture)
- [Classical](https://github.com/HGGshiwo/BeamerthemeClassical)

## 参考文档

常见问题与解决方案请参考[FAQ](./docs/FAQ.md),模板使用请参考[使用手册](./docs/usage.md),模板修改与二次开发请参考[开发手册](./docs/develop.md)。

本模板所使用的各专业规范文件请参考 [zjuthesis-std](https://github.com/thenetadmin/zjuthesis-std)。

## 贡献

对本项目最好的贡献方式是在 GitHub Issue 里提交你发现的 BUG,或者贡献 Pull Request。
如果你不熟悉 GitHub 的运作方式,也可以通过邮件联系我,联系方式位于 `zjuthesis.tex` 顶部。

本项目提供了 LaTeX 模板,但并不负责教会用户使用各种 LaTeX 工具与环境。
与工具和环境有关的问题(例如 TeXStudio 如何处理参考文献)请先自行上网搜索解决方案。
在本项目的 GitHub Issue 里也已经有很多相关内容可供查阅。
当以上尝试均失败后,可到本项目的 [GitHub Discussion](https://github.com/TheNetAdmin/zjuthesis/discussions) 板块进行讨论。

本项目的 Issue 板块只处理使用命令行 `latexmk` 命令编译后产生的问题,不处理使用其他工具(如 TeXStudio)产生的问题。

## 开源许可

本项目代码基于 MIT 协议开源

学校标志与学校文件的版权归浙江大学所有
# 参考zjuthesis项目
113 changes: 10 additions & 103 deletions body/graduate/content.tex
Original file line number Diff line number Diff line change
@@ -1,103 +1,10 @@
\chapter{关于本模板}

本模板根据浙江大学研究生院编写的《浙江大学研究生学位论文编写规则》~\cite{zjugradthesisrules},
在原有的 zjuthesis 模板~\cite{zjuthesis}基础上开发而来。

本模板的本科生版本\cite{zjuthesisrules}得到了浙江大学本科生院老师的支持与审核,
已经在本科生院网上公示。
但当前的研究生版本并未经过研究生院老师的审核,
同学们使用时要注意对照模板与要求,
切不可盲目使用。

作者本人并未编写过浙江大学研究生毕业论文,
所以不清楚具体要求。
如果有热心同学愿意帮忙,
可以替我联系相关老师,我会配合审核并修改代码。

\section{Overleaf 使用注意事项}

如果你在Overleaf上编译本模板,请注意如下事项:

\begin{itemize}
\item 删除根目录的 ``.latexmkrc'' 文件,否则编译失败且不报任何错误
\item 字体有版权所以本模板不能附带字体,请务必手动上传字体文件,并在各个专业模板下手动指定字体。
具体方法参照 GitHub 主页的说明。
\item 当前的Overleaf默认使用TexLive 2017进行编译,但一些伪粗体复制乱码的问题需要TexLive 2019版本来解决。
所以各位同学可以在Overleaf上编写论文时务必切换到TexLive 2019或更新版本来编译,以免产生查重相关问题。
具体说明参照 GitHub 主页。
\end{itemize}


\section{节标题}

我们可以用includegraphics来插入现有的jpg等格式的图片,
如\autoref{fig:zju-logo}所示。

\begin{figure}[htbp]
\centering
\includegraphics[width=.3\linewidth]{logo/zju}
\caption{\label{fig:zju-logo}浙江大学LOGO}
\end{figure}


\subsection{小节标题}


\par 如\autoref{tab:sample}所示,这是一张自动调节列宽的表格。

\begin{table}[htbp]
\caption{\label{tab:sample}自动调节列宽的表格}
\begin{tabularx}{\linewidth}{c|X<{\centering}}
\hline
第一列 & 第二列 \\ \hline
xxx & xxx \\ \hline
xxx & xxx \\ \hline
xxx & xxx \\ \hline
\end{tabularx}
\end{table}


\par 如\autoref{equ:sample},这是一个公式

\begin{equation}
\label{equ:sample}
A=\overbrace{(a+b+c)+\underbrace{i(d+e+f)}_{\text{虚数}}}^{\text{复数}}
\end{equation}

\chapter{另一章}


\begin{figure}[htbp]
\centering
\includegraphics[width=.3\linewidth]{example-image-a}
\caption{\label{fig:fig-placeholder}图片占位符}
\end{figure}

\chapter{再一章}

\par 如\autoref{alg:sample},这是一个算法

\begin{algorithm}[H]
\begin{algorithmic} % enter the algorithmic environment
\REQUIRE $n \geq 0 \vee x \neq 0$
\ENSURE $y = x^n$
\STATE $y \Leftarrow 1$
\IF{$n < 0$}
\STATE $X \Leftarrow 1 / x$
\STATE $N \Leftarrow -n$
\ELSE
\STATE $X \Leftarrow x$
\STATE $N \Leftarrow n$
\ENDIF
\WHILE{$N \neq 0$}
\IF{$N$ is even}
\STATE $X \Leftarrow X \times X$
\STATE $N \Leftarrow N / 2$
\ELSE[$N$ is odd]
\STATE $y \Leftarrow y \times X$
\STATE $N \Leftarrow N - 1$
\ENDIF
\ENDWHILE
\end{algorithmic}
\caption{\label{alg:sample}算法样例}
\end{algorithm}
\chapter{绪论}
\input{body/主体内容/1绪论部分}
\chapter{研究区域与数据处理}
\input{body/主体内容/2研究区域与数据处理}
\chapter{基于机器学习算法的\texorpdfstring{$p\rm CO_2$}{}反演模型建立与分析}
\input{body/主体内容/3基于机器学习算法的pCO2反演模型建立与分析}
\chapter{南大洋\texorpdfstring{$p\rm CO_2$}{}和碳汇的时空变化}
\input{body/主体内容/4南大洋碳汇变化}
\chapter{结论与展望}
\input{body/主体内容/5结论与展望}
2 changes: 1 addition & 1 deletion body/graduate/post.tex
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
\inputbody{post/ref}
\inputbody{post/appendix}
% \inputbody{post/appendix}
\ifthenelse{\equal{\BlindReview}{true}}
{
}
Expand Down
18 changes: 18 additions & 0 deletions body/graduate/post/cv.tex
Original file line number Diff line number Diff line change
@@ -1,2 +1,20 @@
\cleardoublepage
\chapternonum{作者简历}


\begin{enumerate}
\item 个人情况

黄浩,男,1998年出生,安徽宣城人

\begin{tabular}{p{0.25\textwidth}p{0.2\textwidth}p{0.25\textwidth}p{0.25\textwidth}}
2017.09-2021.06 & 浙江大学 & 农业资源与环境 & 学士 \\
2021.09-至今& 浙江大学 & 资源与环境 &攻读硕士\\
\end{tabular}

\item 科研经历\\
2023年11月参加第十二届水色遥感大会
\item 科研成果\\
《Revisiting winter Southern Ocean CO2 uptake based on CALIPSO observations》,目前在审稿阶段。
\end{enumerate}

Loading
Loading