{"id":14980529,"url":"https://github.com/thenetadmin/zjuthesis","last_synced_at":"2025-05-13T22:11:47.518Z","repository":{"id":37451248,"uuid":"130163142","full_name":"TheNetAdmin/zjuthesis","owner":"TheNetAdmin","description":"Zhejiang University Graduation Thesis LaTeX Template","archived":false,"fork":false,"pushed_at":"2025-01-06T22:58:27.000Z","size":1189,"stargazers_count":2992,"open_issues_count":19,"forks_count":668,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-05-08T15:33:19.933Z","etag":null,"topics":["latex","latex-template","latex-thesis-template","overleaf","thesis-template","xelatex","zhejiang-university","zjuthesis"],"latest_commit_sha":null,"homepage":"https://thenetadmin.github.io/zjuthesis","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheNetAdmin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["TheNetAdmin"],"patreon":null,"open_collective":"zjuthesis","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2018-04-19T05:25:46.000Z","updated_at":"2025-05-08T13:42:06.000Z","dependencies_parsed_at":"2024-04-09T18:21:42.923Z","dependency_job_id":"cbefc312-4f8d-4d2f-abab-1e1ca5d32af2","html_url":"https://github.com/TheNetAdmin/zjuthesis","commit_stats":{"total_commits":615,"total_committers":28,"mean_commits":"21.964285714285715","dds":"0.10731707317073169","last_synced_commit":"dc6dc712179ebfa44c837e2e23a861adcec45345"},"previous_names":[],"tags_count":86,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheNetAdmin%2Fzjuthesis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheNetAdmin%2Fzjuthesis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheNetAdmin%2Fzjuthesis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheNetAdmin%2Fzjuthesis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheNetAdmin","download_url":"https://codeload.github.com/TheNetAdmin/zjuthesis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254036843,"owners_count":22003654,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["latex","latex-template","latex-thesis-template","overleaf","thesis-template","xelatex","zhejiang-university","zjuthesis"],"created_at":"2024-09-24T14:01:56.069Z","updated_at":"2025-05-13T22:11:47.500Z","avatar_url":"https://github.com/TheNetAdmin.png","language":"TeX","funding_links":["https://github.com/sponsors/TheNetAdmin","https://opencollective.com/zjuthesis"],"categories":[],"sub_categories":[],"readme":"# 浙江大学学位论文 LaTeX 模板\n\n[![ZJUTHESIS](https://img.shields.io/badge/zjuthesis-latex-blue.svg)](https://thenetadmin.github.io/zjuthesis)\n[![GitHub release](https://img.shields.io/github/release/TheNetAdmin/zjuthesis.svg?label=version\u0026style=popout)](https://github.com/TheNetAdmin/zjuthesis/releases/latest)\n[![GitHub All Releases](https://img.shields.io/github/downloads/thenetadmin/zjuthesis/total.svg?color=blue\u0026style=popout)](https://github.com/TheNetAdmin/zjuthesis/releases/latest)\n[![Commit Since Latest Release](https://img.shields.io/github/commits-since/TheNetAdmin/zjuthesis/latest.svg)](https://github.com/TheNetAdmin/zjuthesis/commits/master)\n[![GithubAction](https://github.com/TheNetAdmin/zjuthesis/workflows/Build%20Tests/badge.svg)](https://github.com/TheNetAdmin/zjuthesis/actions)\n[![GitHub Discussion](https://img.shields.io/badge/github-discussion-blue)](https://github.com/TheNetAdmin/zjuthesis/discussions)\n\n## 简介\n\n本项目为浙江大学学位论文的 LaTeX 模板，包含本科生、硕士生与博士生模板，以及英文硕博士模板。\n\nThis is a LaTeX template for Zhejiang University graduation thesis/design.\nIt provides undergraduate and graduate (master and doctor) templates.\nIt also provides an English template for graduate students.\nSee [English template user manual](./docs/english.md) for more details.\n\n[CC98 校内讨论贴](https://www.cc98.org/topic/4762356)\n\n[GitHub 讨论版](https://github.com/TheNetAdmin/zjuthesis/discussions)\n\n## 使用\n\nzjuthesis 模板有三种使用方式，Overleaf，本地编译，或者 Container 编译：\n\n- Overleaf 是一个线上 LaTeX 编辑器，可以在不安装任何工具的情况下编写 LaTeX 文档，同时也可以和其他人共享文档，共同编辑。\n- 本地编译比 Overleaf 更快，而且本地编译可以使用 Git 来记录版本。推荐有能力的同学设置本地编译环境，并推荐使用 Visual Studio Code 配合 LaTeX workshop 插件 (vscode 使用方式见[FAQ](./docs/FAQ.md))。\n- Container 编译是使用 GitHub 提供的 Codespace 搭配 Container 来编译，这个环境提供了浏览器内的 VS Code 界面以及 TeX Live 的编译环境。这种方式适合熟悉 Container 与 GitHub Codespace 相关用法的同学使用。\n\n### Overleaf\n\n1. [下载模板代码](https://github.com/TheNetAdmin/zjuthesis/releases) 中的 `zjuthesis-v*.*.*-overleaf.zip` 文件\n1. 在 Overleaf 中上传这个 .zip 压缩文件以创建一个新 Overleaf 项目\n1. 在 Overleaf 界面左上角点击 \"Menu\"\n   - 选择 \"Compiler\" 为 \"XeLaTeX\"\n   - 选择 \"TeX Live version\" 为 \"2019\" 或者更新的版本\n1. 参照 Overleaf 项目中 `fonts/README.md` 的说明下载所需字体，并上传到 `fonts` 文件夹中\n1. 使用 Overleaf 编译\n   - 选择专业模板与毕业学位的方式参见下文 \"本地编译\"\n\n### 本地编译\n\n1. 安装 TeXLive 工具包，编译需要 XeTeX 引擎。安装过程可以参考[浙江大学镜像站提供的文档](https://mirrors.zju.edu.cn/docs/CTAN)，以便在校内网下更快下载。\n1. [下载模板代码](https://github.com/TheNetAdmin/zjuthesis/releases)，\n   每个专业模板都有预览 pdf 文件，可以单独下载查看。\n   模板代码请下载 `zjuthesis-v*.*.*.zip` 文件\n   （如果你在用 Clone 或者 Fork 得到的代码，请切换到最新的 release tag，避免 master 分支上的不稳定更新破环你的论文的样式）\n1. 在 `zjuthesis.tex` 中 `\\documentclass[]{zjuthesis}` 部分填写个人信息，其中以下信息用于控制文档的生成：\n\n   - `Degree` 为 `undergraduate` 时，编译本科生论文：\n\n   | Field       | Option 1                             | Option 2                               | Option 3                           |\n   | :---------- | :----------------------------------- | :------------------------------------- | :--------------------------------- |\n   | Type        | thesis: 论文类                       | design: 设计类                         |                                    |\n   | Period      | proposal: 开题报告                   | final: 最终论文/设计（含开题报告）     | paper: 最终论文/报告（无开题报告） |\n   | BlindReview | true: 生成盲审用 pdf（隐藏个人信息） | false: 生成提交用 pdf                  |                                    |\n   | MajorFormat | general: 默认模板                    | 与 `config/format/major/` 下目录名相同 |                                    |\n\n   - `Degree` 为 `graduate` 时，编译硕士生/博士生论文：\n\n\n   | Field       | Option 1                             | Option 2                               |\n   | :---------- | :----------------------------------- | :------------------------------------- |\n   | Type        | thesis: 学术论文                     | design: 专业学术论文                   |\n   | BlindReview | true: 生成盲审用 pdf（隐藏个人信息） | false: 生成提交用 pdf                  |\n   | MajorFormat | general: 默认模板                    | 与 `config/format/major/` 下目录名相同 |\n   | GradLevel   | master: 硕士                         | doctor: 博士                           |\n\n   - 其他设置\n\n   | Field         | Option 1                                  | Option 2            |\n   | :------------ | :---------------------------------------- | :------------------ |\n   | PrintFilePath | true: 在每页侧边打印该页对应 TeX 文件路径 | false: 不打印此输出 |\n   | TwoSide       | true: 章节末的偶数页留白，保证下章节的标题位于奇数页 | false: 取消偶数页留白 |\n\n1. 在 `body` 目录下编写内容\n1. 在 `pages` 目录下填写必要的内容，如审核评语等\n1. 在 `figure` 目录下保存图片，在 `body/ref.bib` 内插入文献条目\n1. 在根目录下运行命令 `latexmk`（或者 `latexmk -xelatex -outdir=out zjuthesis`）即可使用 XeTeX 编译 pdf 文件到 `out` 目录（该目录不会被记录版本）。**请务必使用此 `latexmk` 命令进行编译（除非你已经了解 LaTeX 的工作机制），否则你可能遇到参考文献无法显示等问题**\n1. 如需使用 LuaTeX 编译，可运行命令 `latexmk -pdflua -outdir=out`\n\n\u003e **注意**\n\u003e\n\u003e - 每年的三月底四月初会有 TeXLive 的版本升级，届时本模板会根据 TeXLive 的更新做出一定的修改，请在提交最终论文前查看并应用本模板的更新。\n\u003e - 如果你使用 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)。\n\u003e - 本模板已经兼容 TeXLive 2021。TeXLive 2018 以及之前的版本复制伪粗体文字会产生乱码，建议使用本地 TeXLive 的同学使用最新版 TeXLive。\n\u003e - 计算机专业的部分页面与学校通用格式不同，如果你是计算机专业的同学，请使用计算机专业的模板。\n\n### 使用容器编译\n\n本模板提供了一套配置文件，用以支持在容器中安装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)。\n\nGitHub Codespace使用方法：\n\n1. 创建个人的项目（直接fork，或自行clone并修改remote）\n1. 在个人的项目主页点击\"Code\"\n1. 点击\"Codespaces\"\n1. 点击\"New codespace\"\n1. 等待容器构建（这一过程约要10分钟，因为要在标准Ubuntu的镜像中安装TeX Live）\n1. 构建完成后，可以选择在VS Code（需要[GitHub Codespaces](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces)插件）中或在浏览器中打开，然后按照在本地的使用方式使用\n\n\u003e **注意**\n\u003e\n\u003e - 这一功能的初衷是为了方便性能较弱的设备（例如低功耗笔记本电脑）也能利用免费的云运算资源较快地完成编译，因此**不建议**在本地性能较强的机器上使用（请改用\"本地编译\"）。\n\n### 字数统计\n\n本模板提供了一个脚本用于统计正文字数，请在根目录下使用 `latexmk` 编译一遍模板，然后执行脚本 `script/utils/word_count.sh`。\n此脚本调用了 `texcount` 工具，该工具是 TeX Live 的一部分，不需要额外安装。\n\n## Slides 模板\n\n作者用于毕业答辩的一个 Slides 模板 (Microsoft PowerPoint 模板)\n\n- [GitHub 下载链接](https://github.com/TheNetAdmin/zjuthesis/releases/tag/v2.1.1-slide)\n- [Gitee （国内镜像仓库）下载链接](https://gitee.com/netadmin/zjuthesis/releases/v2.1.1-slide) 国内网络用这个链接下载比较快\n\n[HGGshiwo](https://github.com/HGGshiwo) 同学于 2021 年开发了基于 Beamer 的 Slides 模板，有兴趣的同学可以参考如下几个 repo\n\n- [Formal](https://github.com/HGGshiwo/BeamerthemeFormal) (内含对其他几个 Beamer 模板的简介)\n- [Brief](https://github.com/HGGshiwo/BeamerthemeBrief)\n- [Mixture](https://github.com/HGGshiwo/BeamerthemeMixture)\n- [Classical](https://github.com/HGGshiwo/BeamerthemeClassical)\n\n## 参考文档\n\n常见问题与解决方案请参考[FAQ](./docs/FAQ.md)，模板使用请参考[使用手册](./docs/usage.md)，模板修改与二次开发请参考[开发手册](./docs/develop.md)。\n\n本模板所使用的各专业规范文件请参考 [zjuthesis-std](https://github.com/thenetadmin/zjuthesis-std)。\n\n## 贡献\n\n对本项目最好的贡献方式是在 GitHub Issue 里提交你发现的 BUG，或者贡献 Pull Request。\n如果你不熟悉 GitHub 的运作方式，也可以通过邮件联系我，联系方式位于 `zjuthesis.tex` 顶部。\n\n本项目提供了 LaTeX 模板，但并不负责教会用户使用各种 LaTeX 工具与环境。\n与工具和环境有关的问题（例如 TeXStudio 如何处理参考文献）请先自行上网搜索解决方案。\n在本项目的 GitHub Issue 里也已经有很多相关内容可供查阅。\n当以上尝试均失败后，可到本项目的 [GitHub Discussion](https://github.com/TheNetAdmin/zjuthesis/discussions) 板块进行讨论。\n\n本项目的 Issue 板块只处理使用命令行 `latexmk` 命令编译后产生的问题，不处理使用其他工具（如 TeXStudio）产生的问题。\n\n## 开源许可\n\n本项目代码基于 MIT 协议开源\n\n学校标志与学校文件的版权归浙江大学所有\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthenetadmin%2Fzjuthesis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthenetadmin%2Fzjuthesis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthenetadmin%2Fzjuthesis/lists"}