aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFlorian Fischer <florian.fischer@muhq.space>2026-01-17 12:21:53 +0100
committerFlorian Fischer <florian.fischer@muhq.space>2026-01-17 12:23:24 +0100
commit6ae902b02230048f2f3ef964a7edac0bca768b9e (patch)
treee05475efd420fc8b22106a36be4ae809b8227664
parent21df588bea6429689f6d9a4e3e9cf7c75a434226 (diff)
downloadunterricht-6ae902b02230048f2f3ef964a7edac0bca768b9e.tar.gz
unterricht-6ae902b02230048f2f3ef964a7edac0bca768b9e.zip
add proper mermaid support
Use pdf as default format for pandoc-plot. This improves rendering and makes plot content accessable in the document.
-rw-r--r--common.mk2
-rw-r--r--pandoc/defaults/pandoc-plot.yml57
-rw-r--r--templates/slides.md12
3 files changed, 70 insertions, 1 deletions
diff --git a/common.mk b/common.mk
index 87433b69..644adb68 100644
--- a/common.mk
+++ b/common.mk
@@ -17,7 +17,7 @@ PANDOC_CITE_OPTIONS := --citeproc
PANDOC_FILTER_OPTIONS := --lua-filter "$(PANDOC_FILTER_DIR)/center-img.lua"
PANDOC_FILTER_OPTIONS += --lua-filter "$(PANDOC_FILTER_DIR)/include-files.lua"
PANDOC_FILTER_OPTIONS += --lua-filter "$(PANDOC_FILTER_DIR)/meta-vars.lua"
-PANDOC_FILTER_OPTIONS += --filter pandoc-plot
+PANDOC_FILTER_OPTIONS += --filter pandoc-plot -M plot-configuration=$(PANDOC_DIR)/defaults/pandoc-plot.yml
COMMON_PANDOC_OPTIONS := --data-dir="$(PANDOC_DIR)" --resource-path="$(COMMON_IMAGES):." $(PANDOC_FILTER_OPTIONS)
PANDOC := pandoc $(PANDOC_CITE_OPTIONS) $(COMMON_PANDOC_OPTIONS)
diff --git a/pandoc/defaults/pandoc-plot.yml b/pandoc/defaults/pandoc-plot.yml
new file mode 100644
index 00000000..f94954e2
--- /dev/null
+++ b/pandoc/defaults/pandoc-plot.yml
@@ -0,0 +1,57 @@
+# Dereived from the example configuration. Everything in this file is optional.
+# Please refer to the documentation to know about the parameters herein.
+#
+# The `executable` parameter for all toolkits can be either the
+# executable name (if it is present on the PATH), or
+# the full path to the executable.
+# E.g.:
+# executable: python3
+# executable: "C:\Python37\Scripts\python.exe"
+
+# The following parameters affect all toolkits
+# Directory where to save the plots. The path can be relative to pandoc-plot's
+# current working directory, or absolute.
+directory: .build/plots/
+
+# Whether or not to include a link to the source script in the caption.
+# Particularly useful for HTML output.
+source: false
+
+# When `strict: false`, pandoc-plot will leave code blocks untouched if a plot
+# could not be generated. This could happen if, for example, a toolkit is not
+# installed. If you want pandoc-plot to fail instead, use `strict: true`.
+strict: false
+
+# Default density of figures in dots per inches (DPI).
+# This can be changed in the document specifically as well.
+dpi: 300
+
+# Default format in which to save the figures. This can be specified
+# individually as well.
+format: PDF
+
+# Logging configuration
+logging:
+ # Possible verbosity values: debug, error, warning, info, silent
+ verbosity: warning
+ # If the filepath below is not present, then pandoc-plot will log to stderr
+ # Otherwise, log messages will be appended to the filepath.
+ # filepath: path/to/file.txt
+
+# The possible parameters for the Matplotlib toolkit
+matplotlib:
+ # preamble: matplotlib.py
+ tight_bbox: false
+ transparent: false
+ executable: python
+ command_line_arguments:
+
+# The possible parameters for the graphviz toolkit
+graphviz:
+ # preamble: graphviz.dot
+ executable: dot
+ command_line_arguments:
+
+mermaid:
+ executable: mmdc
+ command_line_arguments: --pdfFit -s 5 --backgroundColor=transparent
diff --git a/templates/slides.md b/templates/slides.md
index 26eba53a..445d9d02 100644
--- a/templates/slides.md
+++ b/templates/slides.md
@@ -114,3 +114,15 @@ Mache was anderes.
\rowcolor{red!30} red line & yeah \\
\rowcolor{blue!30} blue line & wuhu \\
\end{tabularx}
+
+## Timeline
+
+```{.mermaid}
+timeline
+ title History of Social Media Platform
+ 2002 : LinkedIn
+ 2004 : Facebook
+ : Google
+ 2005 : YouTube
+ 2006 : Twitter
+```