ci(build): support building inkscape figures in CI

jdujava · jdujava · commit 53716c68f24c · 2025-05-20T16:54:44.000+02:00
Signed-off-by: Jonas Dujava &lt;jonas.dujava@gmail.com&gt;
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -22,6 +22,8 @@ jobs:
         uses: xu-cheng/latex-action@v3
         with:
           root_file: thesis.tex
+          texlive_version: latest # must be `2024` or later (`latest` chosen by default)
+          extra_system_packages: coreutils icu inkscape # `coreutils` for `mktemp`, `icu` for `uconv`
       - name: Upload the artifact
         uses: actions/upload-artifact@v4
         with:
diff --git a/figures/Inkscape/inkscape-export-to-latex b/figures/Inkscape/inkscape-export-to-latex
@@ -18,11 +18,13 @@ if [ -f "$directory/add-watermark" ]; then
     author_name=$(sed -n 's/^[^%].*ThesisAuthorPlaintext}{}{\(.*\)}$/\1/p' preamble/data.tex)
     ## if the `\ThesisAuthorPlaintext` command is commented out, extract from the `\ThesisAuthor` command
     [ -z "$author_name" ] && author_name=$(sed -n 's/.*ThesisAuthor}{}{\(.*\)}$/\1/p' preamble/data.tex)
+    ## use just ASCII characters, see https://unix.stackexchange.com/a/653210
+    author_name=$(echo "$author_name" | uconv -x Latin-ASCII)
 
-    author_name=$(printf "%s" "$author_name" | iconv -f utf8 -t ascii//TRANSLIT) # use just ASCII characters
-    watermark_string="$(date +%Y) $author_name"                                  # prepend the year
+    watermark_string="$(date +%Y) $author_name"  # prepend the year
+    # watermark_string="$(date +%Y) Author's Name" # NOTE: or manually edit the watermark string here
 
-    # watermark_string="$(date +%Y) Author's Name" ## NOTE: or manually edit the watermark string here
+    ## use the `add-watermark` script to insert the watermark into the PDF
     "$directory"/add-watermark "$1-fixed.pdf" "$watermark_string"
 fi
 
diff --git a/preamble/misc/inkscape.tex b/preamble/misc/inkscape.tex
@@ -6,6 +6,7 @@
 \usepackage{filemod}
 \NewDocumentCommand{\exportInkscapeSVG}{O{./figures/Inkscape/} m}{%
     \filemodCmp{#1#2.pdf}{#1#2.svg}{}{% regenerate PDF+LaTeX code if SVG is newer
+        \ClassNote{TeXtured}{(Re)generating Inkscape SVG to PDF+LaTeX figure:\MessageBreak #1#2.svg}%
         \ShellEscape{#1inkscape-export-to-latex "#1#2"}% use `inkscape-export-to-latex` script in the same directory
     }%
 }

Original file line number	Diff line number	Diff line change
`@@ -6,6 +6,7 @@`
`6`	`6`	`\usepackage{filemod}`
`7`	`7`	`\NewDocumentCommand{\exportInkscapeSVG}{O{./figures/Inkscape/} m}{%`
`8`	`8`	`\filemodCmp{#1#2.pdf}{#1#2.svg}{}{% regenerate PDF+LaTeX code if SVG is newer`
	`9`	`+ \ClassNote{TeXtured}{(Re)generating Inkscape SVG to PDF+LaTeX figure:\MessageBreak #1#2.svg}%`
`9`	`10`	\ShellEscape{#1inkscape-export-to-latex "#1#2"}% use `inkscape-export-to-latex` script in the same directory
`10`	`11`	`}%`
`11`	`12`	`}`