From c0c9fce969a88fb7cca303ebd691e3b939eb818a Mon Sep 17 00:00:00 2001
From: Julius Freudenberger <julius+git@jfreudenberger.de>
Date: Sat, 22 Feb 2025 20:56:25 +0200
Subject: [PATCH] Explain including of vector graphics and PDF pages

---
 codebeispiele/include-pdf.tex | 15 +++++++++++++++
 codebeispiele/include-svg.tex |  5 +++++
 workshop.tex                  | 22 ++++++++++++++++++++++
 3 files changed, 42 insertions(+)
 create mode 100644 codebeispiele/include-pdf.tex
 create mode 100644 codebeispiele/include-svg.tex

diff --git a/codebeispiele/include-pdf.tex b/codebeispiele/include-pdf.tex
new file mode 100644
index 0000000..be09eb4
--- /dev/null
+++ b/codebeispiele/include-pdf.tex
@@ -0,0 +1,15 @@
+\usepackage{pdfpages} % In der Präambel
+\includepdf[pages=-]{<filename>.pdf}
+
+\includepdf[pages=-,landscape]{<filename>.pdf} % Seite im Querformat
+\includepdf[pages=3,{},8-11]{<filename>.pdf} % Seiten 3,
+    % eine leere Seite und die Seiten 8 bis einschl. 11
+
+\includepdf[pages=-,addtotoc={
+  1, % PDF-Seite, auf der das Label platziert werden soll
+  section, % Abschnittsname (oder chapter, subsection)
+  2, % Level des Abschnitts (in Buch chapter -> 1;
+        % in Artikel section -> 1)
+  Überschrift, % erscheint unter diesem Text im TOC
+  label % kann zum Referenzieren genutzt werden
+}]{<filename>.pdf}
diff --git a/codebeispiele/include-svg.tex b/codebeispiele/include-svg.tex
new file mode 100644
index 0000000..8776ef7
--- /dev/null
+++ b/codebeispiele/include-svg.tex
@@ -0,0 +1,5 @@
+% Präambel
+\usepackage{graphicx}
+\usepackage{svg}
+
+\includesvg{<filename>}
diff --git a/workshop.tex b/workshop.tex
index e17470e..4c84b84 100644
--- a/workshop.tex
+++ b/workshop.tex
@@ -609,6 +609,28 @@
   \end{itemize}
 \end{frame}
 
+\begin{frame}[fragile]{Externe Dateien einbinden -- SVG}
+  \begin{itemize}
+    \item Nicht nativ möglich -- \LaTeX{} nutzt für Vektorgraphiken PDF
+    \item Pakete ermöglichen jedoch automatische Konvertierung
+    \item Nutzt dafür Inkscape und ImageMagick (\verb|convert|)
+    \item dafür ist wieder die Option \verb|-shell-escape| nötig!
+    \inputminted{latex}{codebeispiele/include-svg.tex}
+    \item Alternativ Vektordateien direkt als PDF bereitstellen und mit \verb|\includegraphics| einbinden
+  \end{itemize}
+\end{frame}
+
+\begin{frame}[fragile]{Externe Dateien einbinden -- PDF}
+  \begin{itemize}
+    \item PDF-Dateien als ganze Seiten einfügen (bspw. externe Dokumente im Anhang)
+      \only<1>{\inputminted[lastline=6]{latex}{codebeispiele/include-pdf.tex}}
+      \only<2>{
+    \item PDF zum Inhaltsverzeichnis hinzufügen
+      \inputminted[firstline=8]{latex}{codebeispiele/include-pdf.tex}
+    }
+  \end{itemize}
+\end{frame}
+
 \begin{frame}{Nächste Projekte für \LaTeX{}?}
   \begin{itemize}
     \item Wissenschaftliches Dokumentieren