fix: use Noto CJK fonts for cross-platform userguide PDF build, update CI workflow

Author: liweinan

.github/workflows/compile-userguide.yml

@@ -18,9 +18,21 @@ jobs:
         with:
           fetch-depth: 0
 
-      - name: Compile userguide PDF
+      - name: Install CJK fonts
+        run: |
+          apt-get update -qq
+          apt-get install -y -qq fonts-noto-cjk
+
+      - name: Compile userguide PDF (pass 1)
         working-directory: userguide
-        run: xelatex -interaction=nonstopmode userguide.tex
+        run: xelatex -interaction=nonstopmode userguide.tex || true
+
+      - name: Compile userguide PDF (pass 2 — for TOC)
+        working-directory: userguide
+        run: xelatex -interaction=nonstopmode userguide.tex || true
+
+      - name: Verify PDF was produced
+        run: test -f userguide/userguide.pdf
 
       - name: Commit updated PDF
         run: |

userguide/userguide.tex

@@ -1,9 +1,9 @@
 \documentclass[10pt,aspectratio=169,utf8]{beamer}
 
 \usepackage{ctex}
-\setCJKmainfont{Songti SC}
-\setCJKsansfont{Heiti SC}
-\setCJKmonofont{Heiti SC}
+\setCJKmainfont{Noto Serif CJK SC}
+\setCJKsansfont{Noto Sans CJK SC}
+\setCJKmonofont{Noto Sans CJK SC}
 
 \usepackage{graphicx}
 \usepackage{xcolor}