% beamertheme-niederrhein-doc.tex
% Documentation and demo of the package beamertheme-niederrhein.
% Compile: pdflatex, bibtex8, pdflatex, pdflatex
\documentclass[aspectratio=169]{beamer}
\usepackage[utf8]{inputenc}
\usepackage{beamertheme-niederrhein}

\shortauthor{Alexander Rachmann}
\coursename{beamertheme-niederrhein -- documentation}

\begin{document}

\titleslide{beamertheme-niederrhein}{Documentation and examples}{Version~\version}

\begin{frame}[fragile]{Installation}
  Two ways to load the package:
  \begin{itemize}
    \item Installed via CTAN/TeX Live: \texttt{\textbackslash usepackage\{beamertheme-niederrhein\}} is enough.
    \item Kept locally next to your own \texttt{.tex} file (no CTAN
      installation): \texttt{\textbackslash usepackage\{beamertheme-niederrhein\}} still
      works as long as \texttt{beamertheme-niederrhein.sty} and
      \texttt{hsnr-logo.png} sit in the same directory.
    \item Compiled with LuaLaTeX, the logo is embedded automatically --
      no external \texttt{hsnr-logo.png} needed. With pdfLaTeX/XeLaTeX,
      \texttt{hsnr-logo.png} is expected in the project directory.
  \end{itemize}
  \sourceline{See README.md for the full installation path.}
\end{frame}

\sectionslide{Basic Slide Types}

\begin{frame}[fragile]{Title Slide and Section Divider}
  Two commands structure a slide deck:
  \begin{itemize}
    \item \texttt{\textbackslash titleslide\{Title\}\{Subtitle\}\{Author\}} --
      this slide was produced with it.
    \item \texttt{\textbackslash sectionslide\{Text\}} -- produces a
      full-page section heading like the previous slide.
  \end{itemize}
  \sourceline{Own illustration.}
\end{frame}

\begin{frame}[fragile]{Content Slide, Source Line, and Citations}
  Ordinary content slides are plain \texttt{frame} environments:
  \begin{itemize}
    \item Text is not bold by default.
    \item Citations with \texttt{\textbackslash parencite\{key\}}, e.g.\
      \parencite{Kuhn2018} or \parencite{Meier2021}.
    \item For long content, use \texttt{[allowframebreaks]} and
      \texttt{\textbackslash framebreak}.
  \end{itemize}
  \sourceline{Source line with \textbackslash sourceline\{...\} --
  shown right-aligned above the footer, see \parencite{HSNR2026}.}
\end{frame}

\sectionslide{Image Slides}

\twoimages{Two images: \texttt{\textbackslash twoimages}}%
  {hsnr-beispiel-quer.png}{hsnr-beispiel-hoch.png}%
  {\texttt{\textbackslash twoimages\{Title\}\{Image1\}\{Image2\}\{Caption\}} --
  portrait and landscape images are both fitted automatically.}

\threeimages{Three images: \texttt{\textbackslash threeimages}}%
  {hsnr-beispiel-quer.png}{hsnr-beispiel-hoch.png}{hsnr-beispiel-quer.png}%
  {\texttt{\textbackslash threeimages\{Title\}\{TopLeft\}\{TopRight\}\{Bottom\}\{Caption\}}}

\fourimages{Four images: \texttt{\textbackslash fourimages}}%
  {hsnr-beispiel-quer.png}{hsnr-beispiel-hoch.png}{hsnr-beispiel-hoch.png}{hsnr-beispiel-quer.png}%
  {\texttt{\textbackslash fourimages\{Title\}\{TopLeft\}\{TopRight\}\{BottomLeft\}\{BottomRight\}\{Caption\}}}

\begin{frame}[fragile]{Image Slides -- Notes}
  All three image-slide commands share the same conventions:
  \begin{itemize}
    \item There is exactly \textbf{one} shared caption for the whole slide,
      never a caption per image.
    \item Each image keeps its aspect ratio via \texttt{keepaspectratio}
      and is constrained to the available space.
  \end{itemize}
\end{frame}

\begin{frame}[allowframebreaks]{References}
  \printbibliography[heading=none]
\end{frame}

\begin{frame}[fragile]{Further Notes}
  Three points that matter in practice:
  \begin{itemize}
    \item The title slide, section divider, and logo use a TikZ
      overlay -- compile twice after any change, otherwise text is
      missing on these slides.
    \item Bibliography: \texttt{pdflatex}, \texttt{bibtex8}, \texttt{pdflatex},
      \texttt{pdflatex} -- in this order.
    \item Print the theme's version with \texttt{\textbackslash version}
      resp.\ \texttt{\textbackslash themeversion}: currently version~\version.
  \end{itemize}
\end{frame}

\end{document}