Releases · TJ-CSCCG/tongji-undergrad-thesis

18 Sep 09:34

github-actions

v1.1.0

5601d09

TongjiThesis v1.1.0 Latest

Latest

TongjiThesis LaTeX Class v1.1.0

这是一个里程碑版本，包含重大架构重构和大量改进。距离上一个版本 v1.0.2（2023年6月）已经过去了两年多时间，是迄今为止变化最大的一个版本。

📊 版本统计

30 个重要提交，涉及 31 个文件变更
2416 行代码新增，1068 行代码删除
完全重构的模板架构和工作流程

🔥 重大变更

架构重构:

文件结构简化: 将原来的 tongjithesis.sty 和 .cls 文件合并为单一的 tongjithesis.cls
移除字体依赖: 删除了仓库中的 Adobe 字体文件，减小项目体积
新增文档类选项: 支持 minted=true/false, fontset=, times=true/false, bibtex=true/false 等选项
代码重构: 完全重写了类文件的内部实现，提升可维护性

构建系统升级:

TeXLive 2025: 更新 CI 测试环境，解决了 Cleveref 宏包与 ctex 在新版本中的兼容性问题
删除过时配置: 移除了 .github/ci/texlive*.profile 文件
BibTeX 双支持: 现在同时支持传统的 BibTeX 和现代的 BibLaTeX 引擎

✨ 新功能

CTAN 发布系统:

自动化工作流: 全新的 GitHub Actions 工作流，支持一键生成 CTAN 包
多格式发布: 自动生成 .tar.gz 和 .zip 格式的 CTAN 包和源码包
示例 PDF: 自动编译 Linux、macOS、Windows 三平台的 XeLaTeX 和 LuaLaTeX 示例
版本管理: 新增 package.json 和 CITATION.cff 进行规范化版本管理

文档和示例增强:

代码高亮改进: 重写了 minted 和 listings 包的集成，提供更好的代码展示
浮动体示例: 新增大量图表、表格、算法的使用示例
跨平台兼容: 更新了 make.bat，改进 Windows 平台支持

🐛 主要修复

#50: 修复了 Cleveref 宏包中文并列引用连接词问题
#53: 修复了有序列表和无序列表格式不符合要求的问题
#44: 新增动态封面标题缩放，解决长标题显示问题
#59: 修复了多项 CI 构建问题，更新至现代化 GitHub Actions
修复了文档中过时的交叉引用标签（lst:fibonacci）
修复了多项编译兼容性问题

📦 发布内容

本版本提供了前所未有的完整发布包：

CTAN 包 (用于 LaTeX 包管理器):

tongjithesis-ctan-v1.1.0.tar.gz - CTAN 标准提交格式
tongjithesis-ctan-v1.1.0.zip - CTAN 备选格式

完整源码 (推荐学生用户):

tongjithesis-source-v1.1.0.tar.gz - 包含完整仓库、示例和文档
tongjithesis-source-v1.1.0.zip - 同上，ZIP 格式

预编译示例 (快速预览):

example-linux-xelatex.pdf / example-linux-lualatex.pdf
example-macos-xelatex.pdf / example-macos-lualatex.pdf
example-windows-xelatex.pdf / example-windows-lualatex.pdf

🚀 快速开始

学生用户: 下载源码包 → 解压 → 编辑 main.tex → 使用 make all 编译
LaTeX 管理员: 使用 CTAN 包进行系统级安装
快速预览: 直接查看对应平台的预编译示例 PDF

📋 系统要求

LaTeX 引擎: XeLaTeX 或 LuaLaTeX（不支持 pdfLaTeX）
TeX 发行版: TeXLive 2025+ 强烈推荐（解决 Cleveref 兼容性问题）
代码高亮: Python + Pygments（可选，用于 minted 包）
参考文献: 支持 BibTeX 或 BibLaTeX 引擎

📝 完整变更日志

自 v1.0.2 以来的所有提交记录 [点击查看]

git log v1.0.2..HEAD --oneline
24be233 fix: wrong cross reference
288f204 update: CI release
28b845e fix: CI release
93718ae update: CI workflow for release, citation info update
b290eec fix: CI script
60ec6a1 update: documentation, metadata, and CI workflow
7092bf4 update: CI tex-live/setup-texlive-action@v3 link update
c6505f8 update: texlive version 2025 in CI
b079c12 Update CTAN package and consolidate class file [skip ci]
ef44e11 update: documentation
253d4b8 Update CTAN package and consolidate class file [skip ci]
40d44e1 update: tongjithesis.cls reconstructed with options
0965cd5 Update CTAN package and consolidate class file [skip ci]
2bc6aab fix: ctan github actions file
e9d0104 add: ctan config; merge .{sty,cls} to a new .cls file
c0ed764 make.bat update
0a3e03d Fix ci (#59)
2ad4702 makefile update
01b95a0 add: support for bibtex option
64c7800 fix: enumerate and itemize format (#53)
1fa495d fix: multiple cleveref items in Chinese (#50)
c0d16c8 New README (#45)
0796856 Add dynamically scaled cover items (#44)
c1ee5d6 Fixed ci
c413488 Update references format and examples
8535540 Merge overleaf-2023-11-19-1347 into master
950978c fix: modify cover
5105a33 Create CITATION.cff
e14519b fix: small modifications
5476fcd Merge overleaf-2023-06-27-0727 into master
ca742f1 Updates from Overleaf

🙏 致谢

特别感谢为本版本做出重要贡献的开发者：

@RizhongLin: 主要维护者，负责架构重构、CI/CD 系统开发、CTAN 包支持等核心功能
Issue 反馈用户: 感谢所有提交问题报告的用户，特别是那些报告 #44、#50、#53、#57、#59 等关键问题的用户

本项目由 TJ-CSCCG (Tongji University Computer Science Curriculum Consortium Group) 维护。

Contributors

RizhongLin

Assets 12

21 Jun 06:41

skyleaworlder

v1.0.2

6593047

Release v1.0.2

Makefile 支持 ENGINE 选项，xelatex / lualatex 可供选择 #19 ；
tongji-undergrad-thesis 模板上线 Overleaf，且仓库与 Overleaf 同步 #22 ；
修复了 ci #23 #25 #34 ；
完善了模板使用样例，内含 latex 简单教学；
适配了更现代的数学库，使数学字体格式标准；
修复了错误的 paragraph / subparagraph / caption 等格式；
提供了有关 python 安装的指导 #26 / #30 ；
在仓库中提供 adobe 字体作为可选项 #32 ；
使用了符合 word 模板要求的 biblatex-gb7714-2015 和 biber 引擎 #33 ；
实现了可选的双页模式 #36 。

by @CookiePieWw @skyleaworlder @tobiasforest @watermellye. June, 2023.

What's Changed

fix: missing flags in Makefile and compatible changes to workflow by @CookiePieWw in #19
Updated README.md and rewrote README-EN.md by @tobiasforest in #22
fix: try to fix the workflow error on mac by @tobiasforest in #23
fix: fixed the error on macOS & updated README by @tobiasforest in #25
fix: default math font; ci; README by @tobiasforest in #28
Update: instructions for specifying Python path manually by @watermellye in #30
update: adobe font by @tobiasforest in #32
update: citation examples & biber by @tobiasforest in #33
update: twoside init by @tobiasforest in #36
ci: update binaries path in TL 2023 by @skyleaworlder in #34