Skip to content

Repository files navigation

NJU Thesis: 南京大学学位论文 LaTeX 模板

build status CTAN GitHub release overleaf nju-git

njuthesis 是制作南京大学本科生毕业论文、研究生学位论文、博士后出站报告的 LaTeX 文档类。本模板基于本科生院的论文撰写规范制作,同时参考研究生院提供的硕士、博士学位材料包,用于生成符合南京大学排版要求和相应的国家标准的学位论文,力求通过 LaTeX3 语法实现清晰的实现逻辑、较高的可定制性以及友好的用户接口。

快速开始

请首先阅读用户手册,其中详尽阐述了模板的特性和使用方法。

对于普通用户,首要推荐使用下述的南大 TeX 编译方法

南大 TeX 编译

南大 TeXeScience 中心为南大在校师生提供的在线 LaTeX 写作平台,已安装有本模板的最新版。注册登录后,只需在创建新项目菜单中选择论文模板即可开始写作。

使用本平台时,请积极备份自己的文稿。

本地编译

推荐使用包管理器安装 njuthesis 的最新版。

新手同学不妨直接使用以下流程:

  1. 从南大镜像站下载并安装最新的 TeX 发行版,并更新所有宏包
  2. 下载包含模板全部文件的压缩包 njuthesis-user-v*.zip
  3. 根据需要更改 njuthesis-sample.tex 文件中的内容
  4. 在模板根目录下运行 latexmk -xelatex 运行编译,得到对应的 PDF 文件

典型结构

\documentclass{njuthesis}
\njusetup{}
\begin{document}
\maketitle
\tableofcontents
\mainmatter
\chapter{欢迎}
使用 \LaTeX{}!
\printbibliography
\end{document}

仓库结构

本仓库同时服务于模板开发和用户写作参考,几个主要目录的用途如下:

  • source/:模板的 .dtx 源代码、用户手册源码和相关资源。这里的文件仅供开发者维护模板使用。如需提取最新版格式文件,可以用 l3build unpack 命令,或下载 GitHub Actions 提供的 Artifacts。
  • template/:作为标准写作示例的空白模板。
  • examples/:提供典型用法参考,例如定制附加页面、处理声明页等非通用但可复用的示例。
  • test/:回归测试和编译测试文件,用于保证模板实现的稳定性。
  • scripts/.github/:自动化脚本与持续集成、发布流程配置。

反馈

在你遇到模板问题时,请遵守以下步骤:

  1. 在《修订记录》查看该问题是否已经修复但未发布;
    • 若是,则可以使用仓库中的开发版本解决问题
  2. GitHub IssuesDiscussions 中搜索该问题的关键词;
  3. 浏览本项目 Wiki用户手册
  4. 在你确定这是一个新问题时
    • 对于模板 bug、请求新功能、文档笔误等提出新 issue
    • 对于用法的疑惑、格式上的斟酌等提出新 discussion
    • 两个划分不绝对,区别在于 issue 是解决即关闭的
    • 如果确实重复了,会打上 duplicate 标签并将你引导至本问题首条提问

如果导师或院系有额外要求,请一同附上要求原文或格式截图。

贡献

欢迎提交 PR

许可

本模板的发布遵守 LaTeX Project Public License(版本 1.3c 或更高)

Releases

Packages

Used by

Contributors

Languages