feat: update LaTeX tools and add build scripts

Renames LaTeX tools and updates settings for SYSUThesis.
Adds Makefile for building and cleaning project files.
Introduces build.lua and create_release.py for automated builds.
Renames logo files for consistency.

Author: DapengFeng

.vscode/settings.json

@@ -3,14 +3,14 @@
       {
           "name": "latexmk (xelatex)",
           "tools": [
-              "unpack-thuthesis",
+              "unpack-sysuthesis",
               "xelatexmk"
           ]
       },
       {
           "name": "latexmk (lualatex)",
           "tools": [
-              "unpack-thuthesis",
+              "unpack-thesis",
               "lualatexmk"
           ]
       },
@@ -23,13 +23,13 @@
   ],
   "latex-workshop.latex.tools": [
       {
-          "name": "unpack-thuthesis",
+          "name": "unpack-sysuthesis",
           "command": "xetex",
           "args": [
               "-file-line-error",
               "-halt-on-error",
               "-interaction=nonstopmode",
-              "thuthesis.ins"
+              "sysuthesis.ins"
           ],
           "env": {}
       },
@@ -69,7 +69,7 @@
       }
   ],
   "latex-workshop.latex.watch.files.ignore": [
-      "**/thuthesis.cls",
+      "**/sysuthesis.cls",
       "**/*.bbx",
       "**/*.bbl",
       "**/*.cbx",
@@ -100,5 +100,4 @@
       "**/Library/Application Support/MiKTeX/texmfs/**",
       "/dev/null"
   ],
-  "ros.distro": "humble",
 }

CHANGELOG.md

@@ -1,47 +1,52 @@
-# Changelog
-
-此处记载了 SYSUThesis 中所有值得留意的改动，格式参照 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)。
-
-点击版本号即可在 GitHub 上查看相邻版本间的代码变动。
-
-## [Unreleased]
-
-## [v1.2.0] - 2024-06-06
-### Update
- - 更新lyx模板
-### Merge
- - 合并ThuThesis v7.5.1
-
-## [v1.1.1] - 2023-10-18
-### Add
- - 添加封面和封底扫描版
-### Merge
- - 合并ThuThesis v7.4.0
-
-## [v1.1.0] - 2022-11-16
-### Merge
-- 合并ThuThesis v7.3.1
-
-## [v1.0.1] - 2021-10-09
-### Added
-- 增加SYSU Logo
-- 增加课程实验报告模板
-- 增加Lyx模板
-
-## [v1.0.0] - 2021-06-16
-### Released
-- sysuthesis v1.0.0 发布
-
-### Added
-- 支持\makecover[1]插入扫描封面
-
-### Changed
-- 改变研究生的titlepage和copyrightpage
-
-
-[Unreleased]: https://github.com/DapengFeng/sysuthesis/compare/v1.2.0...HEAD
-[v1.2.0]:     https://github.com/DapengFeng/sysuthesis/releases/tag/v1.2.0
-[v1.1.1]:     https://github.com/DapengFeng/sysuthesis/releases/tag/v1.1.1
-[v1.1.0]:     https://github.com/DapengFeng/sysuthesis/releases/tag/v1.1.0
-[v1.0.1]:     https://github.com/DapengFeng/sysuthesis/releases/tag/v1.0.1
-[v1.0.0]:     https://github.com/DapengFeng/sysuthesis/releases/tag/v1.0.0
+# Changelog
+
+此处记载了 SYSUThesis 中所有值得留意的改动，格式参照 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)。
+
+点击版本号即可在 GitHub 上查看相邻版本间的代码变动。
+
+## [Unreleased]
+
+## [v1.2.1] - 2024-12-14
+### Merge
+  - 合并ThuThesis v7.5.2
+
+## [v1.2.0] - 2024-06-06
+### Update
+ - 更新lyx模板
+### Merge
+ - 合并ThuThesis v7.5.1
+
+## [v1.1.1] - 2023-10-18
+### Add
+ - 添加封面和封底扫描版
+### Merge
+ - 合并ThuThesis v7.4.0
+
+## [v1.1.0] - 2022-11-16
+### Merge
+- 合并ThuThesis v7.3.1
+
+## [v1.0.1] - 2021-10-09
+### Added
+- 增加SYSU Logo
+- 增加课程实验报告模板
+- 增加Lyx模板
+
+## [v1.0.0] - 2021-06-16
+### Released
+- sysuthesis v1.0.0 发布
+
+### Added
+- 支持\makecover[1]插入扫描封面
+
+### Changed
+- 改变研究生的titlepage和copyrightpage
+
+
+[Unreleased]: https://github.com/DapengFeng/sysuthesis/compare/v1.2.1...HEAD
+[v1.2.1]:     https://github.com/DapengFeng/sysuthesis/compare/v1.2.0...v1.2.1
+[v1.2.0]:     https://github.com/DapengFeng/sysuthesis/releases/tag/v1.2.0
+[v1.1.1]:     https://github.com/DapengFeng/sysuthesis/releases/tag/v1.1.1
+[v1.1.0]:     https://github.com/DapengFeng/sysuthesis/releases/tag/v1.1.0
+[v1.0.1]:     https://github.com/DapengFeng/sysuthesis/releases/tag/v1.0.1
+[v1.0.0]:     https://github.com/DapengFeng/sysuthesis/releases/tag/v1.0.0

Makefile

@@ -0,0 +1,70 @@
+# Makefile for SYSUThesis
+
+PACKAGE = sysuthesis
+THESIS  = sysuthesis-example
+SPINE   = spine
+
+SOURCES = $(PACKAGE).ins $(PACKAGE).dtx
+CLSFILE = dtx-style.sty $(PACKAGE).cls
+
+LATEXMK = latexmk
+SHELL  := /usr/bin/env bash
+
+# make deletion work on Windows
+ifdef SystemRoot
+	RM = del /Q
+else
+	RM = rm -f
+endif
+
+.PHONY: all all-dev clean distclean dist thesis viewthesis doc viewdoc cls check FORCE_MAKE
+
+thesis: $(THESIS).pdf
+
+all: thesis
+
+all-dev: doc all
+
+cls: $(CLSFILE)
+
+$(CLSFILE): $(SOURCES)
+	xetex $(PACKAGE).ins
+
+doc: $(PACKAGE).pdf
+
+$(PACKAGE).pdf: cls FORCE_MAKE
+	$(LATEXMK) $(PACKAGE).dtx
+
+$(THESIS).pdf: cls FORCE_MAKE
+	$(LATEXMK) $(THESIS)
+
+viewdoc: doc
+	$(LATEXMK) -pv $(PACKAGE).dtx
+
+viewthesis: thesis
+	$(LATEXMK) -pv $(THESIS)
+
+
+clean:
+	$(LATEXMK) -c $(PACKAGE).dtx $(THESIS)
+	-@$(RM) -rf *~ main-survey.* main-translation.* _markdown_sysuthesis* sysuthesis.markdown.*
+
+cleanall: clean
+	-@$(RM) $(PACKAGE).pdf $(THESIS).pdf
+
+distclean: cleanall
+	-@$(RM) $(CLSFILE)
+	-@$(RM) -r dist
+
+check: FORCE_MAKE
+ifeq ($(version),)
+	@echo "Error: version missing: \"make [check|dist] version=X.Y.Z\""; exit 1
+else
+	@[[ $(shell grep -E -c '$(version) Sun Yat-sen University Thesis Template|\\def\\version\{$(version)\}' sysuthesis.dtx) -eq 3 ]] || (echo "bump version with \"l3build tag\" before release"; exit 1)
+endif
+
+dist: check all-dev
+	# use l3build for CTAN release (zip with .tds.zip)
+	l3build ctan --config utils/build-ctan
+	# use gulp for GitHub release (zip with generated file)
+	python3 utils/create_release.py --version="v$(version)"

build.lua

@@ -0,0 +1,111 @@
+#!/usr/bin/env texlua
+
+module = "sysuthesis"
+
+-- supportdir = "./testfiles/support"
+checksuppfiles = {"*.tex"}
+
+docfiles = {
+  "CHANGELOG.md",
+  "sysuthesis-example.tex",
+  "spine.tex",
+  "sysusetup.tex",
+  "data",
+  "ref"
+}
+installfiles = {"*.cls", "*.bst", "*.bbx", "*.cbx", "logo", "scan"}
+sourcefiles = {"*.dtx", "*.ins", "*.bst", "*.bbx", "*.cbx", "logo", "scan"}
+tagfiles = {"*.dtx", "CHANGELOG.md", "package.json"}
+textfiles = {"*.md"}
+typesetdemofiles = {"sysuthesis-example.tex", "spine.tex"}
+
+checkengines = {"xetex"}
+stdengine = "xetex"
+
+-- include .tds.zip in build output
+packtdszip = true
+
+-- specify some files of their correct TDS locations
+tdslocations = {
+  "bibtex/bst/sysuthesis/*.bst",
+  "tex/latex/sysuthesis/logo/sysu_*.pdf",
+  "tex/latex/sysuthesis/scan/scan-*.pdf",
+}
+
+typesetexe = "xelatex"
+unpackexe = "xetex"
+bibtexexe = "bibtex"
+bibtexopts = ""
+biberopts = "--quiet"
+
+specialtypesetting = specialtypesetting or {
+  ["sysuthesis-example.tex"] = {
+    func = function (file)
+      local name = jobname(file)
+      local errorlevel = tex(file)
+      if errorlevel == 0 then
+        -- Return a non-zero errorlevel if anything goes wrong
+        errorlevel =(
+          bibtex(name) +
+          bibtex(name .. "-appendix-a") +
+          tex(file) +
+          bibtex(name) +
+          bibtex(name .. "-appendix-a") +
+          tex(file) +
+          tex(file)
+        )
+      end
+      return errorlevel
+    end
+  }
+}
+
+checkopts = "-file-line-error -halt-on-error -interaction=nonstopmode"
+typesetopts = "-shell-escape -file-line-error -halt-on-error -interaction=nonstopmode"
+
+lvtext = ".tex"
+
+maxprintline = 79 -- keep compatibility with existing test files
+
+function docinit_hook()
+  for _, file in pairs({"dtx-style.sty"}) do
+    cp(file, unpackdir, typesetdir)
+  end
+  return 0
+end
+
+function update_tag(file, content, tagname, tagdate)
+  local url = "https://github.com/DapengFeng/sysuthesis"
+  local date = string.gsub(tagdate, "%-", "/")
+  if string.match(file, "%.dtx$") then
+    if string.match(content, "%d%d%d%d/%d%d/%d%d [0-9.]+") then
+      content = string.gsub(content, "%d%d%d%d/%d%d/%d%d [0-9.]+",
+        date .. " " .. tagname)
+    end
+    if string.match(content, "\\def\\version{[0-9.]+}") then
+      content = string.gsub(content, "\\def\\version{[0-9.]+}",
+        "\\def\\version{" .. tagname .. "}")
+    end
+
+  elseif string.match(file, "CHANGELOG.md") then
+    local previous = string.match(content, "/compare/(.*)%.%.%.HEAD")
+    local gittag = 'v' .. tagname
+
+    if gittag == previous then return content end
+    content = string.gsub(content,
+      "## %[Unreleased%]",
+      "## [Unreleased]\n\n## [" .. gittag .."] - " .. tagdate)
+    content = string.gsub(content,
+      previous .. "%.%.%.HEAD",
+      gittag .. "...HEAD\n" ..
+      string.format("%-14s", "[" .. gittag .. "]:") .. url .. "/compare/"
+        .. previous .. "..." .. gittag)
+
+  elseif string.match(file, "package.json") then
+    content = string.gsub(content,
+      "\"version\": \"[0-9.]+\"",
+      "\"version\": \"" .. tagname .. "\"")
+  end
+
+  return content
+end