joaomlourenco/novathesis · 上手攻略

  • 仓库:joaomlourenco/novathesis
  • 链接:https://github.com/joaomlourenco/novathesis
  • 分类:academic-writing / thesis-template
  • 作者:Tom
  • 更新:2026-08-23

是什么

novathesis 是一个面向学术论文( dissertation / thesis )的开源 LaTeX 模板,基于 memoir 文档类构建,支持全球 25+ 所高校的封面格式自动生成,提供从安装到提交的完整工作流。项目由 João Lourenço 维护,开源协议为 LPPL v1.3c。

解决什么问题

学位论文格式繁琐是全球研究生的共同痛点:封面页、书脊、章节标题、参考文献、词汇表每所学校各有规范,手动调整费时费力且容易出错。novathesis 将这些格式规范预置为配置文件,换学校只需改一行配置,不用重写内容。

快速安装

方式一:Overleaf(推荐新手)

直接导入 Overleaf,零配置:

  1. 访问 novathesis.org 找到你的学校
  2. 点击 Overleaf 导入链接
  3. Overleaf 自动配置好封面和格式,开箱即写

方式二:本地安装

# 1. 安装 TeX 发行版
# Windows: TeX Live (https://www.tug.org/texlive/) 或 MiKTeX
# macOS: MacTeX 或 MiKTeX
# Linux: sudo apt install texlive-latex-base (Debian/Ubuntu)

# 2. 克隆模板
git clone https://github.com/joaomlourenco/novathesis.git
cd novathesis

# 3. 编译(默认 LuaLaTeX)
make

# 或手动编译
latexmk -pdflua -shell-escape -file-line-error template

⚠️ -shell-escape 允许模板在编译时调用外部程序(minted 调用 Pygments 高亮代码),请只编译可信的 .tex 文件。

核心用法

项目结构

novathesis/
├── template.tex              # 主文件(编辑此文件)
├── latexmkrc                 # 编译配置(自动加载)
├── Makefile                  # 构建入口
├── chapters/                # 章节内容
├── refs/                    # 参考文献 .bib 文件
├── appendices/              # 附录
└── setup/                   # 学校配置(封面、格式规则)

基本写作流程

# 编辑 chapters/ 下的章节文件
# 编辑 template.tex 添加章节引用

# 编译并实时预览(文件保存后自动重编译)
make watch

# 仅编译
make

# 查看 PDF
make view

# 清理构建产物
make clean

多引擎支持

make lua    # LuaLaTeX(推荐,默认)
make pdf    # pdfLaTeX
make xe     # XeLaTeX

添加参考文献

将 .bib 文件放入 refs/ 目录,模板自动使用 biber 处理:

% 在 template.tex 的参考文献位置
\printbibliography[heading=bibintoc]

词汇表与缩写(v8.0+ 重大变化)

v8.0 起,词汇表条目从 .tex 文件迁移到 .bib 文件,由 bib2gls 处理:

# 编译时自动触发(latexmk 内部调用)
bib2gls yourfile.aux

# 手动运行
make glsbib

⚠️ bib2gls 需要 Java 运行环境(JRE)。Overleaf 自带 JRE;本地检查命令:bib2gls --version

典型适用场景

  • 硕士/博士论文:25+ 所高校预置配置,覆盖全球主流大学格式
  • 学术写作规范:memoir 文档类提供书籍级排版质量
  • Overleaf 用户:直接导入,无需配置本地 TeX 环境
  • 跨机构写作:同一模板切换学校配置即可复用

坑与注意

⚠️ v8.0 破坏性升级:8.0 版本将词汇表从 \newacronym / \newglossaryentry(.tex)迁移到 .bib + bib2gls 流程。如果从旧版本升级,需要参考 Migrating from 7.10.x 附录重新配置词汇表。

⚠️ biber vs bibtex:模板默认使用 biber,不是 bibtex。两者不兼容,切换前请确认。

⚠️ shell-escape 安全提示:-shell-escape 允许编译时执行本地命令。模板内置 makeglossaries / minted 等依赖此选项;收到他人论文模板时,先确认来源可信再编译。

⚠️ makeglossaries 淘汰:v8.0 后词汇表改用 bib2gls,makeglossaries 已废弃。

⚠️ 学校预置 vs 主库:主库模板不含具体学校格式,建议优先使用 novathesis.org 的学校预置版本(ZIP / Git clone / Overleaf 链接),格式已绑定好。

与同类对比

novathesis vs 官方 thesis template:多数大学官方模板格式规范但代码老旧、无维护;novathesis 活跃维护(2026 年持续更新)、支持 Overleaf、配置化程度更高。

novathesis vs LaTeXThesis:LaTeXThesis 是另一个开源论文模板,但 novathesis 的 memoir 基类提供了更丰富的书籍排版功能,且预置学校覆盖范围更广。

novathesis vs pandoc thesis template:pandoc 模板轻量但格式控制粒度不如 memoir;novathesis 适合需要精细控制章节结构、封面、书脊的正式学术场景。

一句话推荐结论

写学位论文,优先到 novathesis.org 找你的学校预置配置——25+ 所高校开箱即用,Overleaf 零配置,本地 make 一键编译,比任何自己拼凑的 LaTeX 模板都省心。