Skip to content

TongjiThesis v1.1.0

Latest

Choose a tag to compare

@github-actions github-actions released this 18 Sep 09:34
· 1 commit to master since this release
5601d09

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.jsonCITATION.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) 维护。