Releases: BITNP/BIThesis
v3.8.6-beta-1(测试版)
Tip
若是初次使用,可先参考快速使用指南(本科/硕博)或者 Wiki 网站。有需要再进一步参考详细配置手册bithesis.pdf
。
[unreleased]
🚀 Features
- 支持盲审模式显示致谢标题 (d1c19f4) by @SinCerely023
- 按论文类型自动设置
acknowledgements/showTitleInPeerReview
,并简化逻辑 (c9f53e1) by @YDX-2147483647
🐛 Bug Fixes
- Annotation in bithesis.dtx (3f00c99) by @SinCerely023
- 致谢选项键值对定义 (d569a81) by @SinCerely023
📚 Documentation
- 盲审模式显示致谢标题 (f39a294) by @SinCerely023
⚙️ Miscellaneous Tasks
- Fix
make pkg-only
(f36d825) by @YDX-2147483647
New Contributors
- @github-actions[bot] made their first contribution in #659
v3.8.5 (Public Release)
Tip
若是初次使用,可先参考快速使用指南(本科/硕博)或者 Wiki 网站。有需要再进一步参考详细配置手册bithesis.pdf
。
与 v3.8.4 相比,主要是修复小问题。如无需要,可以不升级。
[3.8.5] - 2025-05-15
🚀 Features
- 给摘要页竖直间距增加弹性,允许写更多内容 (15c9e32) by @YDX-2147483647 in #647
- 允许用 lualatex 编译 (43cbc14) by @YDX-2147483647 in #653
- 渲染题名页时若发现行溢出,发出警告并提示换行 (2869f29) by @YDX-2147483647 in #650
🐛 Bug Fixes
-
汉化 algorithms 和 algorithm2e 包,并更正字号 (76579b9) by @YDX-2147483647
若已在
*.tex
中自行汉化或调整字号,应该仍然生效,无需专门改动。 -
TeX Live 2022/2023 或更早版本无法发出警告 (bdfc3cc) by @YDX-2147483647 in #636
对于硕博模板,如果未按硕博升级指南操作就升级到 v3.8.3+,会警告缺少文件。然而若使用旧版 TeX Live,该警告操作会导致文档无法编译,引发困惑。此次修复让警告能正常发出了;当然,仍需按警告提示下载缺失的文件。
-
限制盲审模式题名页
***
长度,以防行溢出 (952f223) by @YDX-2147483647 -
(GT) 英文题名页宽度不应受前面中文影响 (ef775e9) by @YDX-2147483647
-
H
与htbp
型浮动体(表格、算法)内的行间距应当相同 (66b220b) by @YDX-2147483647
🚜 Refactor
- (license) Release graduate thesis template to public domain (a959e15) by @everything411
- (license) Release experiment report template to public domain (839716d) by @everything411
- (license) Release bachelor paper translation template to public domain (4b4ea2f) by @everything411
- (license) Release presentation template to public domain (2e2eac5) by @everything411
- (license) Release reading report template to public domain (b3e1d8d) by @everything411
- (license) Release undergraduate thesis template to public domain (687fc47) by @everything411
- (license) Release English undergraduate thesis template to public domain (e4abb2b) by @everything411
📚 Documentation
- (GT) 更新
pub.tex
中的注释 (7db4024) by @YDX-2147483647 - 定义
\FAQ{bib-sort}[sortkey]
(8e9f6d2) by @YDX-2147483647 - 补充 FAQ 链接,标注有些功能不限于导言区 (01e6f67) by @YDX-2147483647
- 重整 README (7319884) by @YDX-2147483647 in #652
- 更新
pub.bib
相关文档和注释 (445c114) by @YDX-2147483647 in #656
🎨 Styling
- Fix E300 unexpected function call argument (c5ecb71) by @YDX-2147483647
- Fix W302 unbraced n-type function call argument (dcf34bb) by @YDX-2147483647
🧪 Testing
- 默认测试所有文件夹 (1c6fbf4) by @YDX-2147483647
- 测试 TeX Live 2021–2025,其中仅 2024–2025 测试编译文档 (3e4326b) by @YDX-2147483647
- 支持补充安装依赖 (bfdfc09) by @YDX-2147483647 in #632
- 测试 l3msg 的警告功能 (eccb4a2) by @YDX-2147483647
- Refactor out
install_deps
(8f443c9) by @YDX-2147483647 - 验证盲审可以编译GT、UT、UTE (df09d4b) by @YDX-2147483647
⚙️ Miscellaneous Tasks
- (git-cliff) 修正时区,更新配置 (03ef745) by @YDX-2147483647 in #630
- 合并
examples/
到tests/
(277d76f) by @YDX-2147483647 - Switch release CI from xu-cheng/texlive-action to teatimeguest/setup-texlive-action (9a1201b) by @YDX-2147483647
- 更新 TeX Live 包 (44ce211) by @YDX-2147483647
- 删除多余的
apt install make fontconfig
(022c726) by @YDX-2147483647 - 更新邮箱 (b86b225) by @YDX-2147483647
- Fix typo (2e1bddc) by @YDX-2147483647
- 更新邮箱 webmaster → bithesis (9573c8b) by @YDX-2147483647
- 更新联系方式 (6b4c0f2) by @YDX-2147483647 in #633
- 设置测试版的版本号 (b7cf5d6) by @YDX-2147483647 in #637
- Fix
fd: command not found
(4e312e8) by @YDX-2147483647 in #638 - Some minor format fix (c7f6e0e) by @everything411 in #643
- (check-latex) Fix command fd not found (b81924e) by @YDX-2147483647 in #651
- (check-links) Ignore CHANGELOG (181c0ce) by @YDX-2147483647
- (test) Support merge queues (ad31d18) by @YDX-2147483647
- Update version to 3.8.5 (a1b1d01) by @YDX-2147483647
v3.8.5-alpha-3(测试版)
Tip
若是初次使用,可先参考快速使用指南(本科/硕博)或者 Wiki 网站。有需要再进一步参考详细配置手册bithesis.pdf
。
这个测试版主要是修复小问题。如无需要,可以不升级。
[unreleased]
🚀 Features
- 给摘要页竖直间距增加弹性,允许写更多内容 (15c9e32) by @YDX-2147483647 in #647
- 允许用 lualatex 编译 (43cbc14) by @YDX-2147483647 in #653
- 渲染题名页时若发现行溢出,发出警告并提示换行 (2869f29) by @YDX-2147483647 in #650
🐛 Bug Fixes
- 汉化 algorithms 和 algorithm2e 包,并更正字号 (76579b9) by @YDX-2147483647
- TeX Live 2022/2023 或更早版本无法发出警告 (bdfc3cc) by @YDX-2147483647 in #636
- 限制盲审模式题名页
***
长度,以防行溢出 (952f223) by @YDX-2147483647 - (GT) 英文题名页宽度不应受前面中文影响 (ef775e9) by @YDX-2147483647
🚜 Refactor
- (license) Release graduate thesis template to public domain (a959e15) by @everything411
- (license) Release experiment report template to public domain (839716d) by @everything411
- (license) Release bachelor paper translation template to public domain (4b4ea2f) by @everything411
- (license) Release presentation template to public domain (2e2eac5) by @everything411
- (license) Release reading report template to public domain (b3e1d8d) by @everything411
- (license) Release undergraduate thesis template to public domain (687fc47) by @everything411
- (license) Release English undergraduate thesis template to public domain (e4abb2b) by @everything411
📚 Documentation
- (GT) 更新
pub.tex
中的注释 (7db4024) by @YDX-2147483647 - 定义
\FAQ{bib-sort}[sortkey]
(8e9f6d2) by @YDX-2147483647 - 补充 FAQ 链接,标注有些功能不限于导言区 (01e6f67) by @YDX-2147483647
- 重整 README (7319884) by @YDX-2147483647 in #652
🎨 Styling
- Fix E300 unexpected function call argument (c5ecb71) by @YDX-2147483647
- Fix W302 unbraced n-type function call argument (dcf34bb) by @YDX-2147483647
🧪 Testing
- 默认测试所有文件夹 (1c6fbf4) by @YDX-2147483647
- 测试 TeX Live 2021–2025,其中仅 2024–2025 测试编译文档 (3e4326b) by @YDX-2147483647
- 支持补充安装依赖 (bfdfc09) by @YDX-2147483647 in #632
- 测试 l3msg 的警告功能 (eccb4a2) by @YDX-2147483647
- Refactor out
install_deps
(8f443c9) by @YDX-2147483647 - 验证盲审可以编译GT、UT、UTE (df09d4b) by @YDX-2147483647
⚙️ Miscellaneous Tasks
- (git-cliff) 修正时区,更新配置 (03ef745) by @YDX-2147483647 in #630
- 合并
examples/
到tests/
(277d76f) by @YDX-2147483647 - Switch release CI from xu-cheng/texlive-action to teatimeguest/setup-texlive-action (9a1201b) by @YDX-2147483647
- 更新 TeX Live 包 (44ce211) by @YDX-2147483647
- 删除多余的
apt install make fontconfig
(022c726) by @YDX-2147483647 - 更新邮箱 (b86b225) by @YDX-2147483647
- Fix typo (2e1bddc) by @YDX-2147483647
- 更新邮箱 webmaster → bithesis (9573c8b) by @YDX-2147483647
- 更新联系方式 (6b4c0f2) by @YDX-2147483647 in #633
- 设置测试版的版本号 (b7cf5d6) by @YDX-2147483647 in #637
- Fix
fd: command not found
(4e312e8) by @YDX-2147483647 in #638 - Some minor format fix (c7f6e0e) by @everything411 in #643
- (check-latex) Fix command fd not found (b81924e) by @YDX-2147483647 in #651
v3.8.5-alpha-2
Tip
若是初次使用,可先参考快速使用指南(本科/硕博)或者 Wiki 网站。有需要再进一步参考详细配置手册bithesis.pdf
。
这个测试版主要是修复小问题。如无需要,可以不升级。
[unreleased]
🐛 Bug Fixes
-
汉化 algorithms 和 algorithm2e 包,并更正字号 (76579b9) by @YDX-2147483647
若已在
*.tex
中自行汉化或调整字号,应该仍然生效,无需专门改动。 -
TeX Live 2022/2023 或更早版本无法发出警告 (bdfc3cc) by @YDX-2147483647 in #636
对于硕博模板,如果未按硕博升级指南操作就升级到 v3.8.3+,会警告缺少文件。然而若使用旧版 TeX Live,该警告操作会导致文档无法编译,引发困惑。此次修复让警告能正常发出了;当然,仍需按警告提示下载缺失的文件。
🧪 Testing
- 默认测试所有文件夹 (1c6fbf4) by @YDX-2147483647
- 测试 TeX Live 2021–2025,其中仅 2024–2025 测试编译文档 (3e4326b) by @YDX-2147483647
- 支持补充安装依赖 (bfdfc09) by @YDX-2147483647 in #632
- 测试 l3msg 的警告功能 (eccb4a2) by @YDX-2147483647
⚙️ Miscellaneous Tasks
- (git-cliff) 修正时区,更新配置 (03ef745) by @YDX-2147483647 in #630
- 合并
examples/
到tests/
(277d76f) by @YDX-2147483647 - Switch release CI from xu-cheng/texlive-action to teatimeguest/setup-texlive-action (9a1201b) by @YDX-2147483647
- 更新 TeX Live 包 (44ce211) by @YDX-2147483647
- 删除多余的
apt install make fontconfig
(022c726) by @YDX-2147483647 - 更新邮箱 (b86b225) by @YDX-2147483647
- Fix typo (2e1bddc) by @YDX-2147483647
- 更新邮箱 webmaster → bithesis (9573c8b) by @YDX-2147483647
- 更新联系方式 (6b4c0f2) by @YDX-2147483647 in #633
- 设置测试版的版本号 (b7cf5d6) by @YDX-2147483647 in #637
- Fix
fd: command not found
(4e312e8) by @YDX-2147483647 in #638
v3.8.5-alpha-1(存在问题,请忽略)
ci: 设置测试版的版本号 Relates-to: #625
v3.8.4 (Public Release)
Tip
若是初次使用,可先参考快速使用指南(本科/硕博)或者 Wiki 网站。有需要再进一步参考详细配置手册bithesis.pdf
。
此版本只修改了封面、摘要等前置内容,对正文无影响。如无需要,可以不更新。
[3.8.4] - 2025-04-18
🚀 Features
-
支持在PDF书签中隐去封面、书脊、题名页、声明,如
\MakeCover[bookmarked = false]
(186e09a) by @YDX-2147483647\MakeCover[bookmarked = false] \MakePaperBack[bookmarked = false] \MakeTitle % 默认 bookmarked = true \MakeOriginality[bookmarked = false]
-
支持用
title
修改conclusion
环境内的标题 (0eb90b6) by @YDX-2147483647\begin{conclusion}[title = 结论与 $\lim_{t \to +\infty}$] 如需更改,可设置 title。 \end{conclusion}
🐛 Bug Fixes
cover/delimiter
较宽时,封面信息整体不能向左偏 (fd8efd2) by @YDX-2147483647- 封面信息整体居中时,不应计入隐藏项 (8c17bf6) by @YDX-2147483647 in #614
- (GT) 封皮、题名页标题的行距不应过小 (0814adb) by @YDX-2147483647 in #618
📚 Documentation
- Fix IPA font (c6b883a) by @YDX-2147483647
make regression-test
(e999609) by @YDX-2147483647- 改进 DocStrip 里的文档 (05bc34f) by @YDX-2147483647
- (handbook) 更新快速使用指南开头 (e572618) by @YDX-2147483647
- (handbook) Fix warnings and reformat (390191c) by @YDX-2147483647 in #627
🎨 Styling
- Fix E300 unexpected function call argument (42eb640) by @YDX-2147483647
- Fix S205 malformed function name (23db46c) by @YDX-2147483647
- Fix W302 unbraced n-type function call argument (55f8b49) by @YDX-2147483647
🧪 Testing
- Collect more errors (d6a274b) by @YDX-2147483647
- 允许手动准备回归测试比较对象 (39ee2d8) by @YDX-2147483647
- 支持限制线程数 (c97d797) by @YDX-2147483647 in #612
make regression-test
needs*.cls
(3ac2789) by @YDX-2147483647 in #624
⚙️ Miscellaneous Tasks
- Fix font cache (92da744) by @YDX-2147483647 in #620
- 改写 zsh 为
scripts/regression_test.py
(fbd02a1) by @YDX-2147483647 - 并行化
scripts/regression_test.py
(94a0b94) by @YDX-2147483647 - 允许
make regression_test
提前中止 (bb44f06) by @YDX-2147483647 in #619 - Check expl3 (ecf90e2) by @YDX-2147483647
update_version.py
(f3b7cc0) by @YDX-2147483647- 上传快速使用指南到 CTAN (9a6b27f) by @YDX-2147483647
- Update version to 3.8.4 (ac63574) by @YDX-2147483647
v3.8.3 (Public Release)
Tip
若是初次使用,可先参考快速使用指南(本科/硕博)或者 Wiki 网站。有需要再进一步参考详细配置手册bithesis.pdf
。
这个版本主要是适应2025年三月末新研究生模板。
-
硕博模板
- 若已在用之前 v3.8.3-alpha-1 测试版:这次基本没有变化,可以不升级;如想升级,替换
bithesis.cls
即可。 - 若在用 v3.8.2 或更早版本:因为要填信息,不能像往常一样单纯替换
bithesis.cls
;请参考以下升级指南。
- 若已在用之前 v3.8.3-alpha-1 测试版:这次基本没有变化,可以不升级;如想升级,替换
-
本科模板:升级仍只需替换
bithesis.cls
。
硕博升级指南
- 下载新的模板包并解压。
- 用新的
bithesis.cls
替换旧的bithesis.cls
。 - 将新的
misc/icon_{academic,professional}.jpg
复制到旧的misc/
。 - 参考新的
main.tex
重新填写\BITSetup{ info = {…} }
:- 增加学号
studentId
(用于封皮)、研究生类型degreeType
(学术型academic
、专业型professional
)。 - 若是专业型研究生,增加行业合作导师
industrialMentor{,En}
。 - 若是工程硕博士专项,增加
工程硕博士专项 = true
。
- 增加学号
- 重新编译。
此外,关于 #584 图表标题与周围文字的间距异常(特别是 float 宏包),可以用\captionsetup[figure]{belowskip = 0pt}
微调。
补充:如果三种类型都不是,封面「学生类型」信息框为美观默认关闭,可以手动开启。
请编辑main.tex
:
\BITSetup{
cover = {
…
autoWidthPadding = 0.25em,
+ showSpecialTypeBox = true,
},
以前和研究生院确认过这个信息框重要程度比较低,这回还没有问。如果有人通知要始终保留,欢迎分享,LaTeX模板可以改一下默认行为。
[3.8.3] - 2025-04-08
🚀 Features
- (GT) 适应2025年三月末新研究生模板 (03e05f9) by @YDX-2147483647 in #605
🐛 Bug Fixes
- (GT) 参照Word模板微调摘要、正文、结论等标题上下的间距,并展示省略号写法 (3433a53) by @YDX-2147483647 in #606
- 调大
cover/autoWidthPadding
时,题名页信息应该整体居中 (3c5e397) by @YDX-2147483647 in #611
📚 Documentation
- 2023 → 2025 (c82d688) by @Aaron-Gp in #599
- 更正文档类组成 (af20679) by @YDX-2147483647
- Fix 24 warnings (e7ed4f8) by @YDX-2147483647 in #600
- Update README to v3.8.3-alpha-1 (ab73edb) by @YDX-2147483647 in #609
- (handbook) Clean obsolete codes, add manual
\clearpage
(7200ebd) by @YDX-2147483647
🧪 Testing
- Refactor
make test
withtest.py
for easier debugging (6f8a9f7) by @YDX-2147483647 - Move
make doc
into `test.py (ae28957) by @YDX-2147483647 - Record durations (c4bb27b) by @YDX-2147483647
- Force latexmk to process document fully (c76efbb) by @YDX-2147483647 in #607
- Collect key errors from log files (6e23060) by @YDX-2147483647
⚙️ Miscellaneous Tasks
- Switch from xu-cheng/texlive-action to teatimeguest/setup-texlive-action (08614f9) by @YDX-2147483647
- Minimize packages (5685220) by @YDX-2147483647
- Fix packages (4ef7ce0) by @YDX-2147483647 in #610
- Update version to 3.8.3 (dfb29fe) by @YDX-2147483647
New Contributors
v3.8.3-alpha-1
Tip
若是初次使用,可先参考快速使用指南(本科/硕博)或者 Wiki 网站。有需要再进一步参考详细配置手册bithesis.pdf
。
硕博升级指南
这个测试版主要是适应2025年三月末新研究生模板。因为要填信息,不能像往常一样单纯替换bithesis.cls
;请如下操作。
- 下载新的模板包并解压。
- 用新的
bithesis.cls
替换旧的bithesis.cls
。 - 将新的
misc/icon_{academic,professional}.jpg
复制到旧的misc/
。 - 参考新的
main.tex
重新填写\BITSetup{ info = {…} }
:- 增加学号
studentId
(用于封皮)、研究生类型degreeType
(学术型academic
、专业型professional
)。 - 若是专业型研究生,增加行业合作导师
industrialMentor{,En}
。 - 若是工程硕博士专项,增加
工程硕博士专项 = true
。
- 增加学号
- 重新编译。
此外,关于 #584 图表标题与周围文字的间距异常(特别是 float 宏包),可以用\captionsetup[figure]{belowskip = 0pt}
微调。
(本科不受影响,升级仍只需替换bithesis.cls
,当然不升级也可以。)
补充(2025年4月3日傍晚)
如果三种类型都不是,封面「学生类型」信息框为美观默认关闭。如需开启,请编辑main.tex
:
\BITSetup{
cover = {
…
autoWidthPadding = 0.25em,
+ showSpecialTypeBox = true,
},
以前和研究生院确认过这个信息框重要程度比较低,这回还没有问。如果有人通知要始终保留,欢迎分享,LaTeX模板可以改一下默认行为。
[unreleased]
🚀 Features
- (GT) 适应2025年三月末新研究生模板 (03e05f9) by @YDX-2147483647 in #605
🐛 Bug Fixes
- (GT) 参照Word模板微调摘要、正文、结论等标题上下的间距,并展示省略号写法 (3433a53) by @YDX-2147483647 in #606
📚 Documentation
- 2023 → 2025 (c82d688) by @Aaron-Gp in #599
- 更正文档类组成 (af20679) by @YDX-2147483647
- Fix 24 warnings (e7ed4f8) by @YDX-2147483647 in #600
New Contributors
v3.8.2 (Public Release)
Tip
若是初次使用,可先参考快速使用指南(本科/硕博)或者 Wiki 网站。有需要再进一步参考详细配置手册bithesis.pdf
。
v3.8.2 主要更改:
- 改善文档,特别是将以前散落各处的FAQ整理成了 🥑 疑难杂症 (bithesis.bitnp.net/faq)。
- 对于硕博模板,参考学校规定调整了图表前后的间距,原先间距过大。
如果使用本科模板,或者不介意间距,可以不更新bithesis.cls
。
[3.8.2] - 2025-03-25
🐛 Bug Fixes
- Listings 代码编号中的分隔标签 (7c37def) by @YDX-2147483647 in #590
- (GT) [breaking] 参照规定调整浮动体附近的间距 (#587) (e485b46) by @YDX-2147483647
- (GT) 浮动体连续排列时的间距不能过窄 (7bd201d) by @YDX-2147483647 in #595
📚 Documentation
- 改正
misc/algorithmSeparation
的文档 (eb2b93d) by @YDX-2147483647 in #571 - 更新 [Bug] 模板 (5497443) by @YDX-2147483647 in #573
- 更新开发文档 (6c66799) by @YDX-2147483647 in #576
- 改正
cover/{label,value}Align
选项的文档 (b7a9dbd) by @YDX-2147483647 - Http → https (0f0d47b) by @YDX-2147483647 in #578
- 将 GitHub Discussions 链接更新为疑难杂症单独页面 (25d9f7a) by @YDX-2147483647 in #585
- 链接优先指向 🥑 疑难杂症 (bithesis.bitnp.net/faq) (2ed79ae) by @YDX-2147483647
- 更正
const/heading/acknowledgements
选项的文档 (f7ce6de) by @YDX-2147483647 in #588 - 将生僻字、断字等“部分正确”的注释换成FAQ (4e27fa9) by @YDX-2147483647
⚙️ Miscellaneous Tasks
- 缓存链接检查结果 (b86ba69) by @YDX-2147483647
- Update version to 3.8.2 (5b9f990) by @YDX-2147483647 in #597
◀️ Revert
- (GT) 撤销 #587 修改的浮动体间距 (09f16ab) by @YDX-2147483647
v3.8.1 (Public Release)
Tip
若是初次使用,可先参考快速使用指南(本科/硕博)或者 Wiki 网站。有需要再进一步参考详细配置手册bithesis.pdf
。
[3.8.1] - 2025-01-03
🚀 Features
- 支持不编号的
\pubsection*
(7d372ea) by @YDX-2147483647 in #567
📚 Documentation
- (handbook) 增加链接 (e8708f2) by @YDX-2147483647
- 改进「攻读学位期间发表论文与研究成果清单」相关文档 (0fd8034) by @YDX-2147483647 in #559
- 修复GitHub议题模板 (8e2d6f5) by @YDX-2147483647
- 给
titleEn
示例添加括号 (c5c88e3) by @YDX-2147483647 in #565
⚙️ Miscellaneous Tasks
- Ignore binaries installed by git-cliff-action (426991b) by @YDX-2147483647 in #557
- Remove assets added accidentally (eb0adc8) by @YDX-2147483647
- Texlive 2024 (5c41393) by @everything411
- Update version to 3.8.1 (a6a1209) by @YDX-2147483647
New Contributors
- @everything411 made their first contribution