
# Changelog

此处记载了 SJTUTeX 中所有值得留意的改动，格式参照[《如何维护更新日志》](https://keepachangelog.com/zh-CN/1.1.0/)。

点击版本号即可在 GitHub 上查看相邻版本间的代码变动。

## [Unreleased]

## [v2.3.1] - 2026-02-26

### Fixed

- 将非标准接口移入预设文件。

## [v2.3] - 2026-02-25

### Added

- 新增 `\SetInfoEntry` 命令设置 `sjtu/info` 键。
- 新增 `preset` 文档选项，分离非必要设置；同时支持载入用户预设，方便自定义模板。

### Changed

- 原创性声明变体默认值固定为样式 `a`。
- 设置标题行距与正文一致。

### Removed

- 移除 `info/<lang>/custom` 键。
- 移除过时 `sjtu/info` 键。

### Fixed

- 修复浮动体环境中 `cases` 环境中的字体问题，在浮动体中将 `\SJTU@style@equation@font` 置空（[#77](https://github.com/sjtug/SJTUTeX/pull/77)）。

## [v2.2.1] - 2025-03-28

### Added

- 新增本科新版原创性声明变体（[#72](https://github.com/sjtug/SJTUTeX/pull/72)）。
- 新增语言设置钩子（[#75](https://github.com/sjtug/SJTUTeX/pull/75)）。

### Removed

- 不再自动载入 `xcolor` 宏包（[#73](https://github.com/sjtug/SJTUTeX/pull/73)）。

### Fixed

- `subject` 初始化时不再完全展开，避免使用 pdfTeX 时德语模板标题页生成错误的问题（[#74](https://github.com/sjtug/SJTUTeX/pull/74)）。
- 修正插入外置版权页的 PDF 书签。

## [v2.2] - 2025-02-12

### Added

- 新增 `info/<lang>/custom` 键，可自定义标题页信息。
- `style/page-number` 支持设置总页码数。
- 新增 `hanyi` CJK 字体选项。

### Changed

- 同步 LaTeX 2024-06-01，无需显式调用 `xtemplate` 宏包，内部实现使用 e 型展开替代 x 型展开。
- 取消对标准文档选项的包装，未知选项将转递给标准文档类。
- 简化 CJK 字体配置文件，pdfLaTeX 下直接使用 `ctex` 的默认设置。
- 内置文档命令与环境修改为使用键值对参数，废弃对应的带星号版本。
- 移除 `bibliolist` 环境的使用限制，修改为默认重置计数，新增 `resume` 选项设置连续编号。
- 视觉形象系统文件重命名。

## [v2.1.5] - 2024-11-06

### Fixed

- 修复了 `array` 更新造成的标题页生成失败的问题（[#68](https://github.com/sjtug/SJTUTeX/pull/68)）。

## [v2.1.4] - 2024-10-20

### Changed

- 标题页信息栏允许手动换行（[#66](https://github.com/sjtug/SJTUTeX/pull/66)）。

## [v2.1.3] - 2024-06-29

### Changed

- 更新目录样式。

## [v2.1.2] - 2024-04-05

### Changed

- 改用 `titletoc` 设置目录格式，不再使用原 `tocloft` 包（[#62](https://github.com/sjtug/SJTUTeX/pull/62)）。

## [v2.1.1] - 2024-03-23

### Added

- 新增 `style/theorem-header-font`、`style/theorem-body-font` 选项，支持修改预设数学环境字体。
- 兼容 `thmtools` 包，使用 `tocloft` 包设置 `\listoftheorems` 的样式（[#57](https://github.com/sjtug/SJTUTeX/issues/57)、[#60](https://github.com/sjtug/SJTUTeX/pull/60)）。

### Changed

- 预定义的数学环境声明移至导言区末尾，且不会覆盖重名的已定义环境。

## [v2.1] - 2024-02-18

### Added

- 新增 `style/equation-font` 选项：行间数学公式的字体设置。
- 新增 `style/indent-first` 选项：章节标题后首段是否缩进（[#51](https://github.com/sjtug/SJTUTeX/pull/51)）。
- 新增 `style/keywords-format` 选项：设置关键词格式为普通段落或悬挂格式。
- 新增 `style/num-sep` 选项及子选项 `style/float-num-sep`, `style/equation-num-sep` 和 `style/theorem-num-sep` 来定义编号中的分隔符。
- 添加 `baselineskip` 文档类选项，替换原 `lineskip` 选项。

### Changed

- `abstract` 环境添加目录条目，`abstract*` 环境对应修改为不添加目录条目。
- `\tableofcontents` 添加目录条目，`\tableofcontents*` 对应修改为不添加目录条目。
- 同步 LaTeX 2020/10/01，无需显式调用 `expl3` 和 `xparse` 宏包。
- 更新题注格式。
- 标题页信息栏改用表格实现。

## [v2.0.3] - 2023-09-25

### Added

- 新增 `libertinus` 西文字体设置（[#44](https://github.com/sjtug/SJTUTeX/pull/44)）。
- 添加 `siunitx` 宏包的本地化支持。

### Changed

- 更新学位论文初始英文主题。

### Removed

- 移除文档类内的 `listings` 宏包预设，相关预设移至主文档中。

### Fixed

- 页面统一纵向顶部对齐。

## [v2.0.2] - 2023-04-01

### Changed

- 标题页日期底部增加空白。

### Fixed

- 修复使用 `unicode-math` 字体配置时，`math-style` 设置不生效的问题。

## [v2.0.1] - 2023-03-31

### Changed

- 取消索引条目的缩进。
- 调整索引编号宽度，`thesis` 和 `report` 分章编号的加长编号宽度 2.3em -> 2.8em，`article` 默认不分节编号的减小宽度 2.3em -> 1.8em。

### Fixed

- 修复表格索引中编号宽度不正确的问题。

## [v2.0] - 2023-03-29

### Added

- 对 `sjtuthesis` 文档类：`sjtu/info` 域现在使用 `<lang>/<key>` 接口（比如 `zh/title`），`abstract` 和 `digest` 现在接受一个可选语言参数，移除 `running-title`；对 `sjtureport` 和 `sjtuarticle` 文档类：添加 `\keywords` 和 `\subject` 命令，推荐使用标准文档类接口，`sjtureport` 恢复标准文档类默认封面（[#36](https://github.com/sjtug/SJTUTeX/pull/36)）。
- 新增日语模板（[#37](https://github.com/sjtug/SJTUTeX/pull/37)）。
- 新增德语模板（[#38](https://github.com/sjtug/SJTUTeX/pull/38)）。
- 新增 `sjtu/style/fnmark-style` 选项以支持脚注在带圈数字（`lang=zh` 和 `lang=ja` 时默认）和普通数字（`lang=en` 和 `lang=de` 时默认）间做切换；`sjtu/style/fnmark-font` 可以使用 `haranoaji` 预设（[#39](https://github.com/sjtug/SJTUTeX/pull/39)）。

### Changed

- `sjtu/name` 域中的 `abbr`, `nom`, `ack`, `achv` 键仍然兼容旧接口，但请尽快更新为新用法。
- `abbreviation`、`nomenclature`、`acknowledgements`、`achievements`、`resume` 现在支持使用可选参数变更标题。
- 每个 `achievements` 环境将重置 `bibliolist` 和 `bibliolist*` 环境内部文献条目的计数器，而且 `bibliolist` 和 `bibliolist*` 现在只允许在 `achievements` 环境中使用。
- `abbreviation`、`nomenclature` 现在是带编号的章节（[#34](https://github.com/sjtug/SJTUTeX/pull/34)）。

### Removed

- 移除 `summary` 环境。

### Fixed

- 统一西文无衬线字体缩放。
- 修复 `review` 文档类选项的行为。
- 在 `math-font=none` 时 `\QED` 可用。

## [v2.0-beta] - 2023-02-05

### Changed

- 更新 `math-style` 文档类选项，默认值由 `TeX` 改为 `ISO`；废弃 `nointlimits`, `intlimits`, `upint`, `slint` 文档类选项，改为 `integral-limits=true/false` 和 `integral=slanted/upright`；添加文档类选项 `uppercase-greek=slanted/upright`（[#23](https://github.com/sjtug/SJTUTeX/pull/23)）。

### Deprecated

- 文档类选项 `fontset` 已过时。

### Fixed

- 修复 `\copyrightpage` 使用可选参数时不换页的错误。

## [v2.0-alpha] - 2022-12-28

SJTUTeX 使用 LaTeX3 进行了重构，并对学校新毕业设计模版的要求做了适配。与此同时，新增了 `sjtuarticle` 和 `sjtureport` 文档类，可以用在实验报告等短文中。欢迎使用！


[Unreleased]: https://github.com/sjtug/SJTUTeX/compare/v2.3.1...HEAD
[v2.3.1]:     https://github.com/sjtug/SJTUTeX/compare/v2.3...v2.3.1
[v2.3]:       https://github.com/sjtug/SJTUTeX/compare/v2.2.1...v2.3
[v2.2.1]:     https://github.com/sjtug/SJTUTeX/compare/v2.2...v2.2.1
[v2.2]:       https://github.com/sjtug/SJTUTeX/compare/v2.1.5...v2.2
[v2.1.5]:     https://github.com/sjtug/SJTUTeX/compare/v2.1.4...v2.1.5
[v2.1.4]:     https://github.com/sjtug/SJTUTeX/compare/v2.1.3...v2.1.4
[v2.1.3]:     https://github.com/sjtug/SJTUTeX/compare/v2.1.2...v2.1.3
[v2.1.2]:     https://github.com/sjtug/SJTUTeX/compare/v2.1.1...v2.1.2
[v2.1.1]:     https://github.com/sjtug/SJTUTeX/compare/v2.1...v2.1.1
[v2.1]:       https://github.com/sjtug/SJTUTeX/compare/v2.0.3...v2.1
[v2.0.3]:     https://github.com/sjtug/SJTUTeX/compare/v2.0.2...v2.0.3
[v2.0.2]:     https://github.com/sjtug/SJTUTeX/compare/v2.0.1...v2.0.2
[v2.0.1]:     https://github.com/sjtug/SJTUTeX/compare/v2.0...v2.0.1
[v2.0]:       https://github.com/sjtug/SJTUTeX/compare/v2.0-beta...v2.0
[v2.0-beta]:  https://github.com/sjtug/SJTUTeX/compare/v2.0-alpha...v2.0-beta
[v2.0-alpha]: https://github.com/sjtug/SJTUTeX/releases/tag/v2.0-alpha
