From 5a63067b933d3fe26fb7c40201bb5080e952da59 Mon Sep 17 00:00:00 2001
From: shahondin1624 <shahondin1624@gmail.com>
Date: Thu, 2 Apr 2026 10:54:21 +0200
Subject: [PATCH] Add foreword page and image placement commands

- Introductory page with quote, horizontal rule, and foreword text
- \fillerpage{path} for full-page centered filler images
- \songimage{path} for inline images within song pages
- \fullpageimage{path} for borderless full-page images
- Added graphicx and csquotes packages

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 songbook-style.sty | 38 ++++++++++++++++++++++++++++++++++++++
 songbook.tex       | 30 ++++++++++++++++++++++++++++++
 2 files changed, 68 insertions(+)

diff --git a/songbook-style.sty b/songbook-style.sty
index 8f7b335..d44cf28 100644
--- a/songbook-style.sty
+++ b/songbook-style.sty
@@ -18,6 +18,8 @@
 \RequirePackage{array}
 \RequirePackage{colortbl}
 \RequirePackage{rotating}
+\RequirePackage{graphicx}
+\RequirePackage{csquotes}
 \RequirePackage[minimal]{leadsheets}
 \ExplSyntaxOn
 \cs_new:cpn {leadsheets-library-musicsymbols-loaded} {}
@@ -202,3 +204,39 @@
   \writesongtoc
   \vspace{4mm}%
 }
+
+% ==========================================================================
+% Image placement
+% ==========================================================================
+
+% Full-page filler image (centered, scaled to fit, own page)
+% Usage: \fillerpage{images/drawing.png}
+\newcommand{\fillerpage}[1]{%
+  \clearpage
+  \thispagestyle{empty}%
+  \vspace*{\fill}%
+  \begin{center}%
+    \includegraphics[width=0.85\textwidth,height=0.85\textheight,keepaspectratio]{#1}%
+  \end{center}%
+  \vspace*{\fill}%
+  \clearpage
+}
+
+% Inline image within a page (e.g., at end of a song with remaining space)
+% Usage: \songimage{images/landscape.png}
+\newcommand{\songimage}[1]{%
+  \begin{center}%
+    \includegraphics[width=0.8\textwidth,keepaspectratio]{#1}%
+  \end{center}%
+}
+
+% Full-page image with no margins (bleeds to edges)
+% Usage: \fullpageimage{images/cover.png}
+\newcommand{\fullpageimage}[1]{%
+  \clearpage
+  \thispagestyle{empty}%
+  \newgeometry{margin=0pt}%
+  \noindent\includegraphics[width=\paperwidth,height=\paperheight]{#1}%
+  \restoregeometry
+  \clearpage
+}
diff --git a/songbook.tex b/songbook.tex
index 41a8a65..7c9462e 100644
--- a/songbook.tex
+++ b/songbook.tex
@@ -17,10 +17,40 @@
   \vfill
 \end{titlepage}
 
+% --- Foreword / Introductory page ---
+\thispagestyle{empty}
+{\large\bfseries\itshape
+\enquote{Das Volkslied ist nun einmal da --, daran k\"onnen wir nicht
+vorbei -- es ergreift uns stark und tief, und die Antwort auf
+das Warum? bleiben wir schuldig.}
+\par}
+\vspace{2mm}
+\noindent\rule{\textwidth}{0.4pt}
+\vspace{4mm}
+
+\small
+So hei\ss t es im Vorwort des wohl bekanntesten Liederbuchs
+in der Jugendbewegung, dem \textit{Zupfgeigenhansl}, aus dem Jahr 1913.
+
+Und auch wir erleben auf Fahrt und Lager immer wieder die Kraft des
+gemeinsamen Singens. Mit diesem Liederbuch haben wir eine Auswahl
+an Liedern aus unterschiedlichen Quellen zusammengetragen.
+
+Singen verbindet uns, macht Freude und ist ein entscheidendes Element
+unserer Lager und Fahrt.
+
+\vspace{5mm}
+Herzlichst Gut Pfad
+
+\clearpage
+
 % --- Table of Contents ---
 \printsongtoc
 \clearpage
 
+% --- Filler images can be placed between songs ---
+% Example: \fillerpage{images/drawing.png}
+
 % --- Songs (alphabetical) ---
 \input{songs/abend-wird-es-wieder}
 \input{songs/auf-auf-zum-froehlichen-jagen}