Fixing parallelization and LaTex->PDF workflow (mostly by giving up on the idea of supporting more unicode in the MD files)

Author: Staacks

.github/workflows/conditional_convert_via_pandoc.yaml

@@ -60,7 +60,7 @@ jobs:
             .github/workflows/pandoc_texlive_packages.txt
       - name: Run Pandoc
         run: |
-          echo "$list_changed_files"
+          echo $list_changed_files
           bash ./pandoc.sh $list_changed_files
 #      - name: Commit files # transfer the new files into the repository
 #        run: |

.github/workflows/pandoc_texlive_packages.txt

@@ -17,6 +17,7 @@ babel
 babel-greek
 xeCJK
 lualatexja
+lualatex-math
 framed
 fontspec
 selnolig

content/de/instructions/inelastischer-stoss/inelastischer-stoss.md

@@ -1,4 +1,4 @@
----
+--- 
 translationKey: "Inelastic Collision Instruction"
 title: "(In)elastischer Stoß"
 date: 2024-12-17T11:42:40+01:00
@@ -75,7 +75,7 @@ Der Reiter „Energie“ zeigt die zu den berechneten Höhen gehörenden Energie
 
 ## Physikalischer Hintergrund und Analysedetails
 
-Phyphox zeichnet Audiodaten des Smartphone-Mikrofons auf und analysiert sie sequentiell (wie in der Konfiguration „akustische Stoppuhr“). Die Samples werden auf einen Bereich von -1 bis 1 normalisiert, wobei die genaue Bedeutung dieser Amplitude je nach Aufnahmehardware des Smartphones variieren kann. Wenn ein Sample die vom Benutzer eingestellte Trigger-Schwelle überschreitet, wird dies als Ereignis gezählt und die Zeit vermerkt. Die Zeit basiert auf der Abtastrate, die typischerweise 48 kHz (oder in einigen Fällen 44,1 kHz) beträgt. Das ergibt eine theoretische zeitliche Auflösung von \(21\,\mathrm{μs}\) (bzw. \(23\,\mathrm{μs}\)). In der Praxis ist diese Auflösung jedoch durch Unterschiede in den Geräuschen verschiedener Aufpralle, Dispersion und die Form der Schallwelle begrenzt. Während phyphox intern exakte Werte nutzt, werden daher nur drei Dezimalstellen (1 ms) angezeigt.
+Phyphox zeichnet Audiodaten des Smartphone-Mikrofons auf und analysiert sie sequentiell (wie in der Konfiguration „akustische Stoppuhr“). Die Samples werden auf einen Bereich von -1 bis 1 normalisiert, wobei die genaue Bedeutung dieser Amplitude je nach Aufnahmehardware des Smartphones variieren kann. Wenn ein Sample die vom Benutzer eingestellte Trigger-Schwelle überschreitet, wird dies als Ereignis gezählt und die Zeit vermerkt. Die Zeit basiert auf der Abtastrate, die typischerweise 48 kHz (oder in einigen Fällen 44,1 kHz) beträgt. Das ergibt eine theoretische zeitliche Auflösung von \(21\,\mathrm{\mu s}\) (bzw. \(23\,\mathrm{\mu s}\)). In der Praxis ist diese Auflösung jedoch durch Unterschiede in den Geräuschen verschiedener Aufpralle, Dispersion und die Form der Schallwelle begrenzt. Während phyphox intern exakte Werte nutzt, werden daher nur drei Dezimalstellen (1 ms) angezeigt.
 
 Nach einem Ereignis werden die folgenden Audiosamples verworfen, bis die im unter „Mindestverzögerung“ eingestellte Zeit verstrichen ist. Danach wird das nächste Sample oberhalb der Schwelle als nächstes Ereignis erfasst. Die Zeitdifferenzen zwischen den aufeinanderfolgenden Ereignissen werden als „Zeit 1“, „Zeit 2“ usw. angezeigt.
 
@@ -104,7 +104,7 @@ Die anfängliche Höhe \( h_0 \) wird extrapoliert, indem angenommen wird, dass
 
 In der Praxis wird die anfängliche Höhe häufig unterschätzt, da bei höheren Aufprallgeschwindigkeiten mehr Energie in Wärme umgewandelt wird. Der erste Aufprall hat typischerweise die höchste Geschwindigkeit und verliert damit einen höheren Anteil seiner Energie. Die Annahme eines gleichen Verlustfaktors führt somit zu einer Unterschätzung der potentiellen Energie vor dem ersten Aufprall und damit zu einer Unterschätzung der Anfangshöhe.
 
- 
+
 ## Probleme und Lösungen
 
 * **Phyphox erfasst nicht alle Aufpralle.**  

content/en/instructions/inelastic-collision/inelastic-collision.md

@@ -1,4 +1,4 @@
----
+--- 
 translationKey: "Inelastic Collision Instruction"
 title: "(In)elastic Collision"
 date: 2024-12-17T11:42:40+01:00
@@ -73,7 +73,7 @@ The energy tab shows energy data corresponding to the heights that have actually
 
 ## Physics background and analysis details
 
-Phyphox records audio samples from the phone's microphone and considers them sequentially (like the "acoustic stopwatch" configuration). The samples are normalized to a range of -1 to 1, although the exact meaning can differ from phone to phone due to different recording hardware and processing. If a sample is above the trigger threshold set by the user, this is counted as an event and its time is noted. The time is based on the sampling rate of the recording, which is typically 48kHz (or in some cases 44.1kHz), resulting in a theoretical temporal resolution of \(21\,\mathrm{μs}\) (or \(23\,\mathrm{μs}\)). Note that in practice this resolution is severely limited by differences between the sounds from different bounces as well as dispersion and the shape of the waveform itself and phyphox only displays three decimals (1ms) while using the exact value internally.
+Phyphox records audio samples from the phone's microphone and considers them sequentially (like the "acoustic stopwatch" configuration). The samples are normalized to a range of -1 to 1, although the exact meaning can differ from phone to phone due to different recording hardware and processing. If a sample is above the trigger threshold set by the user, this is counted as an event and its time is noted. The time is based on the sampling rate of the recording, which is typically 48kHz (or in some cases 44.1kHz), resulting in a theoretical temporal resolution of \(21\,\mathrm{\mu s}\) (or \(23\,\mathrm{\mu s}\)). Note that in practice this resolution is severely limited by differences between the sounds from different bounces as well as dispersion and the shape of the waveform itself and phyphox only displays three decimals (1ms) while using the exact value internally.
 
 The next sound samples will be discarded until a minimum time interval set by "Minimum Delay" has passed. After this time the next sample above the threshold is noted as the next event and the time difference between subsequent events is shown as "Time 1", "Time 2", etc.
 

pandoc-generator/pandoc-single.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+# You can add more extensions if you're fine with --standalone only
+Only_Standalone_Output_Types="latex docx odt"
+# Pandoc creates an AST (Abstract Syntax Tree); reuse this by saving/reading from .ast
+# You can add individual pandoc conversions by calling them after the 'done' part. Keep in mind to finish all lines with backslash
+
+BASE="${1%.*}"
+FILENAME=$(basename -- "$1")
+LOGID="${FILENAME%.*}"
+SUPPORTDIR=$(dirname "$0")
+
+echo "PANDOC Processing $1 as $LOGID"
+
+pandoc --from markdown+tex_math_single_backslash --to native "$1" -o "$BASE.ast"
+for ext in ${Only_Standalone_Output_Types}; do
+    echo "$LOGID Genrating $ext"
+    pandoc --from native "$BASE.ast" --standalone --pdf-engine=lualatex -o "$BASE.$ext"
+done
+
+# HTML
+echo "$LOGID Generating pdf"
+pandoc --from native "$BASE.ast" --standalone --mathml -o "$BASE.html"; \
+
+# PDF
+echo "$LOGID Generating pdf"
+pandoc --from native "$BASE.ast" --standalone -H "$SUPPORTDIR/preamble.tex" --pdf-engine=pdflatex -o "$BASE.pdf"; \
+
+echo "$LOGID Cleaning up"
+rm "./$BASE.ast"
+
+echo "$LOGID Done."

pandoc-generator/preamble.tex

@@ -0,0 +1 @@
+% Not used at the moment, but can be used to customize the LaTeX-based PDF generation

pandoc.sh

@@ -1,11 +1,3 @@
 #!/bin/bash
-# You can add more extensions if you're fine with --standalone only
-Only_Standalone_Output_Types="latex pdf html docx odt"
-# Pandoc creates an AST (Abstract Syntax Tree); reuse this by saving/reading from .ast
-# You can add individual pandoc conversions by calling them after the 'done' part. Keep in mind to finish all lines with backslash
-parallel --jobs 0 \
-	pandoc --from markdown --to native './{}' -o './{.}.ast' ';'\
-	for i in "$Only_Standalone_Output_Types"';' do \
-		pandoc --from native './{.}.ast' --standalone -o './{.}.$i' ';' \
-    done';' \
-	rm './{.}.ast' ::: "$1"
+#Just a wrapper for parallelization, but separating this into its own script saves some nasty escaping escapates.
+parallel --jobs 0 --ungroup ./pandoc-generator/pandoc-single.sh ::: "$@"