chore: 所有latexmkrc统一启用 SyncTeX 并关闭-shell-escape

若要关闭 SyncTeX，运行`latexmk`时可加上参数`-synctex=0`；启用`-shell-escape`也是如此。

Resolves #544

Author: YDX-2147483647

.github/workflows/release.yml

@@ -54,21 +54,6 @@ jobs:
             undergraduate-thesis-en,
             reading-report,
           ]
-        include:
-          - template: graduate-thesis
-            cls: bithesis
-          - template: undergraduate-thesis
-            cls: bithesis
-          - template: lab-report
-            cls: bitreport
-          - template: paper-translation
-            cls: bithesis
-          - template: presentation-slide
-            cls: bitbeamer
-          - template: undergraduate-thesis-en
-            cls: bithesis
-          - template: reading-report
-            cls: bithesis
 
     steps:
       - uses: actions/checkout@v4
@@ -83,7 +68,7 @@ jobs:
       - name: Copy manual to the template folder.
         run: |
           mv bithesis.pdf ./templates/${{ matrix.template }}
-          mv ${{ matrix.cls }}.cls ./templates/${{ matrix.template }}
+          make copy-only
       - name: Install zip
         uses: montudor/action-zip@v1
       - name: Zip files under ./${{ matrix.template }}

.gitignore

@@ -285,6 +285,11 @@ wiki/.vuepress/dist
 bithesis.zip
 bithesis
 
+# Generated by `make copy`
+/templates/*/latexmkrc
+/tests/*/latexmkrc
+/handbook/latexmkrc
+
 !templates/*.pdf
 overleaf
 *.zip

DEVELOPMENT.md

@@ -27,7 +27,7 @@
 
 如果改动仅仅涉及某个模板，那么相对简单一些：
 
-1. 初次开发前，运行 `make copy`，这会生成 `*.cls` 并更新到 `templates/` 下。
+1. 初次开发前，运行 `make copy`，这会生成 `*.cls` 等并更新到 `templates/` 下。
 2. 编辑模板。
 3. 测试，确保你的改动能够正确编译；并且不会影响到其他效果。
 

Makefile

@@ -1,6 +1,10 @@
 # 以下命令仅保证能在 Linux 或 macOS 环境下执行。
 # 如果你是 Windows 用户，可以使用 Git Bash 或者 Cygwin 来执行；
 # 或者可以考虑将此脚本移植为 PowerShell。
+
+# Required for brace expansion
+SHELL = /bin/bash
+
 PACKAGE = bithesis
 
 SOURCES = $(PACKAGE).ins $(PACKAGE).dtx
@@ -67,18 +71,21 @@ test: doc copy FORCE_MAKE
 regression-test: cls
 	$(REGRESSION_TEST_COMMAND)
 
+.PHONY: copy-only
+copy-only:
+	cp {bithesis.cls,assets/latexmkrc} $(SCAFFOLDDIR)/undergraduate-thesis
+	cp {bithesis.cls,assets/latexmkrc} $(SCAFFOLDDIR)/undergraduate-thesis-en
+	cp {bithesis.cls,assets/latexmkrc} $(SCAFFOLDDIR)/paper-translation
+	cp {bithesis.cls,assets/latexmkrc} $(SCAFFOLDDIR)/graduate-thesis
+	cp {bithesis.cls,assets/latexmkrc} $(SCAFFOLDDIR)/reading-report
+	cp {bithesis.cls,assets/latexmkrc} $(TESTDIR)/doctor-thesis
+	cp {bithesis.cls,assets/latexmkrc} $(TESTDIR)/autorefs
+	cp {bithesis.cls,assets/latexmkrc} ./handbook
+	cp {bitreport.cls,assets/latexmkrc} $(SCAFFOLDDIR)/lab-report
+	cp {bitbeamer.cls,assets/latexmkrc} $(SCAFFOLDDIR)/presentation-slide
+
 .PHONY: copy
-copy: cls
-	cp bithesis.cls $(SCAFFOLDDIR)/undergraduate-thesis
-	cp bithesis.cls $(SCAFFOLDDIR)/undergraduate-thesis-en
-	cp bithesis.cls $(SCAFFOLDDIR)/paper-translation
-	cp bithesis.cls $(SCAFFOLDDIR)/graduate-thesis
-	cp bithesis.cls $(SCAFFOLDDIR)/reading-report
-	cp bithesis.cls $(TESTDIR)/doctor-thesis
-	cp bithesis.cls $(TESTDIR)/autorefs
-	cp bithesis.cls ./handbook
-	cp bitreport.cls $(SCAFFOLDDIR)/lab-report
-	cp bitbeamer.cls $(SCAFFOLDDIR)/presentation-slide
+copy: cls copy-only
 
 # Generate scaffolds for overleaf
 .PHONY: overleaf

assets/latexmkrc

@@ -0,0 +1,10 @@
+# https://mirror.ctan.org/support/latexmk/example_rcfiles/xelatex_latexmkrc
+$pdf_mode = 5;
+$dvi_mode = 0;
+$postscript_mode = 0;
+
+# 明确 *.bbl 由其它文件生成，可被删除。（latexmk 未能从 *.fls 检测）
+$bibtex_use = 2;
+
+# 启用 SyncTeX
+$xelatex = "xelatex -synctex=1 %O %S";