From 2bd17e7692d1df772963dddb9a43a897d47fce64 Mon Sep 17 00:00:00 2001
From: Dominik George <nik@velocitux.com>
Date: Fri, 1 Jul 2022 12:40:48 +0200
Subject: Document dynamic list backend and AlekSIS integration in how-to

---
 data/impressive-display.tex | 29 ++++++++++++++++++++++++-----
 1 file changed, 24 insertions(+), 5 deletions(-)

diff --git a/data/impressive-display.tex b/data/impressive-display.tex
index c3d42cf..7974da8 100644
--- a/data/impressive-display.tex
+++ b/data/impressive-display.tex
@@ -47,7 +47,7 @@
 
     \parbox[t][2.4in][t]{3.5in}{
     \begin{itemize}
-    \item<alert@+| uncover@+->An \textbf{Impressive Display} can \textbf{show information} provided as PDF \textbf{to people passing by}
+    \item<alert@+| uncover@+->An \textbf{Impressive Display} can \textbf{show information} provided as PDF, images or videos \textbf{to people passing by}
     \item<alert@+| uncover@+->At schools for example, it can be used to display \textbf{substitute teacher schedules} to students and teachers
     \item<alert@+| uncover@+->At theaters or other venues, you can provide \textbf{information screens} about what's going on at your location
     \item<alert@+| uncover@+->Use it to \textbf{present slide shows, photo collections, etc.} at a Linux Day presentation booth
@@ -84,7 +84,8 @@
     \parbox[t][2.4in][t]{3.5in}{
     \begin{itemize}
     \item<alert@+| uncover@+->\textbf{Impressive Display} registers itself as an available \textbf{X session manager}. Make it the default (or the only session manager installed)
-    \item<alert@+| uncover@+->Feed it with a presentation-like PDF file. The \textbf{PDF} can be obtained \textbf{from} the \textbf{local file system or} from a \textbf{webserver}
+    \item<alert@+| uncover@+->Feed it with a presentation-like PDF file or a list of image and video files. The \textbf{PDF} can be obtained \textbf{from} the \textbf{local file system or} from a \textbf{webserver}
+    \item<alert@+| uncover@+->Serve a \textbf{dynamic or static list of such files} from any web-based backend
     \item<alert@+| uncover@+->Impressive Display supports \textbf{host-specific configuration parameters}; you can run \textbf{various displays} presenting different PDF content \textbf{based on the same configuration} set
     \end{itemize}
     }
@@ -183,13 +184,31 @@
     \begin{itemize}
     \item<alert@+| uncover@+->The \textbf{per-user configuration} of Impressive Display is done \textbf{in \texttt{\$HOME/.impressive-display/config}}
     \item<alert@+| uncover@+->All \textbf{system-wide parameters can be overriden by the user}
-    \item<alert@+| uncover@+->For PDF URIs that require \textbf{authentication before PDF content retrieval}, put \textbf{credentials into}: \\ \small \texttt{\$HOME/.impressive-display/secrets/default.secrets}
+    \item<alert@+| uncover@+->For URIs that require \textbf{authentication before PDF content retrieval}, put \textbf{credentials into}: \\ \small \texttt{\$HOME/.impressive-display/secrets/default.secrets}
     \item<alert@+| uncover@+->\textbf{Credentials} can also be \textbf{specified per info screen}: \\ \small \texttt{\$HOME/.impressive-display/secrets/<hostname>.secrets}
     \item<alert@+| uncover@+->The \textbf{\texttt{*.secrets} files use the \texttt{.netrc} file format} (see \texttt{man 5 netrc})
     \end{itemize}
     }
   \end{beamerboxesrounded}
 }
+
+\frame[label=listbackend]
+{
+  \frametitle{Configuration\,\ldots}
+  \framesubtitle{\ldots of multiple URLs from a backend}
+
+  \begin{beamerboxesrounded}[shadow=true]{Configure list of files -- from a web backend}
+
+    \parbox[t][2.4in][t]{3.5in}{
+    \begin{itemize}
+    \item<alert@+| uncover@+->Use any server-side tool you like (PHP script, Flask app, etc.) to serve a list of URIs
+    \item<alert@+| uncover@+->Serve it with a \texttt{.txt} extension ans as \texttt{text/plain}
+    \item<alert@+| uncover@+->The list can contain an arbitrary number of URLs pointing to PDFs, images, videos, or further lists
+    \item<alert@+| uncover@+->The AlekSIS® School Information System contains a backend with UI to manage content
+    \end{itemize}
+    }
+  \end{beamerboxesrounded}
+}
 \section[Testing]{Testing your Setup}
 
 \frame[label=testing]
@@ -221,9 +240,9 @@
 
     \parbox[t][2.4in][t]{3.5in}{
     \begin{itemize}
-    \item<alert@+| uncover@+->Authors (and copyright holders): \\ \ \ \ \ Mike Gabriel <mike.gabriel@das-netzwerkteam.de> \\ \ \ \ \ Daniel Teichmann <daniel@teichm-sh.de>
+    \item<alert@+| uncover@+->Authors (and copyright holders): \\ \ \ \ \ Mike Gabriel <mike.gabriel@das-netzwerkteam.de> \\ \ \ \ \ Daniel Teichmann <daniel@teichm-sh.de> \\ \ \ \ \ Dominik George <dominik.george@teckids.org>
 %    \item<alert@+| uncover@+->Other contributors: \\ none, so far\,\ldots
-    \item<alert@+| uncover@+->Development sponsored by: \\ \ \ \ \ Katharineum zu Lübeck (Germany) \\ \ \ \ \ Fritz-Reuter-Schule Eckernförde (Germany) \\ \ \ \ \ Ernst-Barlach-Gymnasium Kiel (Germany)
+    \item<alert@+| uncover@+->Development sponsored by: \\ \ \ \ \ Katharineum zu Lübeck (Germany) \\ \ \ \ \ Fritz-Reuter-Schule Eckernförde (Germany) \\ \ \ \ \ Ernst-Barlach-Gymnasium Kiel (Germany) \\ \ \ \ \ Teckids e.V. (Germany)
     \item<alert@+| uncover@+->Upstream code: \\ \ \ \ \ \scriptsize \url{https://code.it-zukunft-schule.de/cgit/impressive-display/}
     \end{itemize}
     }
-- 
cgit v1.2.3