Finish Impressive Display HowTo Beamer presentation file.

1 files changed, 103 insertions, 33 deletions

diff --git a/data/impressive-display.tex b/data/impressive-display.tex
index b203392..e895ce2 100644
--- a/data/impressive-display.tex
+++ b/data/impressive-display.tex
@@ -26,9 +26,9 @@
 \beamertemplatenumberedsquaresectiontoc
 \beamertemplatetransparentcovered
 
-\title{Impressive Display}
+\title[Impressive Display]{Impressive Display HowTo (v0.2.990)}
 \institute[Debian Edu]{Debian Edu Dev Team}
-\author[Mike Gabriel]{Mike Gabriel \\ Daniel Teichmann \\ and others}
+\author[Debian Edu \\ Dev Team]{Mike Gabriel \\ Daniel Teichmann \\ and others}
 \date{Nov 2016}
 
 \begin{document}
@@ -47,11 +47,11 @@
 
     \parbox[t][2.4in][t]{3.5in}{
     \begin{itemize}
-    \item<alert@+| uncover@+->An Impressive Display can show information provided as PDF 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 on huge display screens.
-    \item<alert@+| uncover@+->Use it to \textbf{present slide shows, photo collections, etc.} at a Linux Day presentation booth.
-    \item<alert@+| uncover@+->Impressive Display has been \textbf{designed for automatic display} of PDF based information.
+    \item<alert@+| uncover@+->An \textbf{Impressive Display} can \textbf{show information} provided as PDF \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
+    \item<alert@+| uncover@+->Impressive Display has been \textbf{designed for automatic display} of PDF based information
     \end{itemize}
     }
   \end{beamerboxesrounded}
@@ -66,8 +66,9 @@
 
     \parbox[t][2.4in][t]{3.5in}{
     \begin{itemize}
-    \item<alert@+| uncover@+->Combine Impressive Display with a display manager (such as \textbf{NoDM} or \textbf{LightDM}) that allows passwordless user login.
-    \item<alert@+| uncover@+->Combine it with a \textbf{PXE booted diskless system} such as LTSP for deploying a farm of info displays at your location.
+    \item<alert@+| uncover@+->Combine Impressive Display \textbf{with a display manager} (such as NoDM or LightDM) \textbf{that allows passwordless user login}
+    \item<alert@+| uncover@+->Combine it with a \textbf{PXE booted diskless system} such as LTSP for \textbf{deploying a farm of info displays} at your location
+    \item<alert@+| uncover@+->Combine with Xephyr (a \textbf{nested Xserver}) \textbf{while testing / preparing your setup}
     \end{itemize}
     }
   \end{beamerboxesrounded}
@@ -82,9 +83,9 @@
 
     \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 from the \textbf{local file system or} from a \textbf{webserver}.
-    \item<alert@+| uncover@+->Impressive Display supports specific per-host configuration parameters; you can run various displays presenting different PDF content based on the same configuration set.
+    \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@+->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}
     }
   \end{beamerboxesrounded}
@@ -93,21 +94,55 @@
 
 \section[Installation]{Installation}
 
-\frame[label=install]
+\frame[label=debinstall]
 {
-  \frametitle{Installation\ldots}
-  \framesubtitle{\ldots\,on one system.}
+  \frametitle{Installation\,\ldots}
+  \framesubtitle{\ldots\,on a standalone Debian-like system.}
 
-  \begin{beamerboxesrounded}[shadow=true]{Installation}
+  \begin{beamerboxesrounded}[shadow=true]{Installation: Debian GNU/Linux (and alike)}
 
     \parbox[t][2.4in][t]{3.5in}{
     \begin{itemize}
-    \item<alert@+| uncover@+->Install a minimal GNU/Linux system without X11 / Graphical Login Manager
-    \item<alert@+| uncover@+->Create a local user account with minimal privileges, e.\,g. \texttt{infoscreen}
-    \item<alert@+| uncover@+->On Debian/Ubuntu: \texttt{sudo apt-get install impressive-display nodm}
-    \item<alert@+| uncover@+->Edit \texttt{/etc/default/nodm}, set \texttt{NODM\_ENABLED=true} and \texttt{NODM\_USER=infoscreen}
-    \item<alert@+| uncover@+->Use \texttt{sudo update-alternatives --config x-session-manager} to check that \texttt{impressive-display} is the default X session manager
-    \item<alert@+| uncover@+->Start the NoDM display manager: \texttt{sudo invoke-rc.d nodm start}
+    \item<alert@+| uncover@+->\textbf{Install a minimal} Debian (or derivative) \textbf{system without X11} / Graphical Login Manager
+    \item<alert@+| uncover@+->Install Impressive Display and NoDM: \\ \small \texttt{apt-get install impressive-display nodm}
+    \item<alert@+| uncover@+->\textbf{Edit \texttt{/etc/default/nodm}}, set \texttt{NODM\_ENABLED=true} and \texttt{NODM\_USER=impressive-display}
+    \item<alert@+| uncover@+->\textbf{Check that \texttt{impressive-display} is the default X session manager}: \\ \small \texttt{update-alternatives \hbox{-}\hbox{-}config x-session-manager}
+    \item<alert@+| uncover@+->\textbf{Start NoDM}: \small \texttt{sudo invoke-rc.d nodm start}
+    \end{itemize}
+    }
+  \end{beamerboxesrounded}
+}
+
+\frame[label=rpminstall]
+{
+  \frametitle{Installation\,\ldots}
+  \framesubtitle{\ldots\,on a standalone RPM-based system.}
+
+  \begin{beamerboxesrounded}[shadow=true]{Installation on Fedora, openSUSE or similar}
+
+    \parbox[t][2.4in][t]{3.5in}{
+    \begin{itemize}
+    \item<alert@+| uncover@+->The \textbf{Impressive Display} tool \textbf{has not been packaged for the RPM world}
+    \item<alert@+| uncover@+->\textbf{Please} contact distribution maintainers and \textbf{request packaging}
+    \end{itemize}
+    }
+  \end{beamerboxesrounded}
+}
+
+\frame[label=rpminstall]
+{
+  \frametitle{Installation\,\ldots}
+  \framesubtitle{\ldots\,in an LTSP chroot.}
+
+  \begin{beamerboxesrounded}[shadow=true]{Install LTSP based info screen farm running Impressive Display}
+
+    \parbox[t][2.4in][t]{3.5in}{
+    \begin{itemize}
+    \item<alert@+| uncover@+->Create a \textbf{minimal LTSP chroot}, uninstall or \textbf{disable the LTSP Display Manager} (aka LDM)
+    \item<alert@+| uncover@+->\textbf{Make} the LTSP \textbf{chroot bootable over PXE}: the system should boot into a text-based logon screen
+    \item<alert@+| uncover@+->All LTSP \textbf{client systems must have a dedicated hostname} after PXE boot
+    \item<alert@+| uncover@+->Apply \textbf{installation steps for standalone hosts to} the LTSP \textbf{chroot}
+    \item<alert@+| uncover@+->\textbf{Set host-specific parameters} like PDF download URI, display resolution, etc. via the \texttt{\$\{DISPLAYS[@]\}} associative array, \textbf{for examples see:} \\ \small \texttt{/etc/default/impressive-display}
     \end{itemize}
     }
   \end{beamerboxesrounded}
@@ -115,16 +150,42 @@
 
 \section[Configuration]{Configuration}
 
-\frame[label=config]
+\frame[label=systemconfig]
 {
-  \frametitle{title}
-  \framesubtitle{subtitile}
+  \frametitle{Configuration\,\ldots}
+  \framesubtitle{\ldots system-wide}
 
-  \begin{beamerboxesrounded}[shadow=true]{Configuration}
+  \begin{beamerboxesrounded}[shadow=true]{Configure Impressive Display -- system-wide}
 
     \parbox[t][2.4in][t]{3.5in}{
     \begin{itemize}
-    \item<alert@+| uncover@+->Item...
+    \item<alert@+| uncover@+->The \textbf{system-wide configuration} of Impressive Display is done \textbf{in \texttt{/etc/default/impressive-display}}
+    \item<alert@+| uncover@+->You can \textbf{adapt various parameters}:
+    \begin{itemize}
+    \item<alert@+| uncover@+->\textbf{Basic options}:Pulseaudio support, uncluttering of the pointer device, screensaver options, slide transition options, etc.
+    \item<alert@+| uncover@+->\textbf{Default parameters}: PDF download URI, display resolution
+    \item<alert@+| uncover@+->\textbf{Display specific}: PDF download URI, display resolution, based on the display system's hostname
+    \item<alert@+| uncover@+->\textbf{Rush hours} (phases of frequent PDF content changes), \textbf{sleep hours} (phases of no PDF content updates)
+    \end{itemize}
+    \end{itemize}
+    }
+  \end{beamerboxesrounded}
+}
+
+\frame[label=userconfig]
+{
+  \frametitle{Configuration\,\ldots}
+  \framesubtitle{\ldots on a per-user basis}
+
+  \begin{beamerboxesrounded}[shadow=true]{Configure Impressive Display -- on a per-user basis}
+
+    \parbox[t][2.4in][t]{3.5in}{
+    \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@+->\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}
@@ -133,14 +194,21 @@
 
 \frame[label=testing]
 {
-  \frametitle{title}
-  \framesubtitle{subtitile}
+  \frametitle{Testing Impressive Display\,\ldots}
+  \framesubtitle{\ldots using a nested Xserver}
 
   \begin{beamerboxesrounded}[shadow=true]{Testing your Setup}
 
     \parbox[t][2.4in][t]{3.5in}{
     \begin{itemize}
-    \item<alert@+| uncover@+->Item...
+    \item<alert@+| uncover@+->\textbf{Install Impressive Display} locally \textbf{on your PC or notebook}; you can launch Impressive Display under your normal user account
+    \item<alert@+| uncover@+->Do a \textbf{graphical login with your normal user} account; when logged in, open two Terminal windows
+    \item<alert@+| uncover@+->Terminal 1: \textbf{Launch} a nested Xserver (like \textbf{Xephyr}): \\ \small \texttt{Xephyr -screen 1024x768 -ac :1}
+    \item<alert@+| uncover@+->Terminal 2, also under your normal user account:
+    \begin{itemize}
+    \item<alert@+| uncover@+->On Debian (and alike): \\ \small \texttt{export DISPLAY=:1 \\ STARTUP=impressive-display /etc/X11/Xsession}
+    \item<alert@+| uncover@+->On other distros: still unknown, please help improving this presentation file
+    \end{itemize}
     \end{itemize}
     }
   \end{beamerboxesrounded}
@@ -150,14 +218,16 @@
 
 \frame[label=label]
 {
-  \frametitle{title}
-  \framesubtitle{subtitile}
+  \frametitle{Authors, Contributors \& Sponsors}
 
   \begin{beamerboxesrounded}[shadow=true]{Authors \& Contributors}
 
     \parbox[t][2.4in][t]{3.5in}{
     \begin{itemize}
-    \item<alert@+| uncover@+->Item...
+    \item<alert@+| uncover@+->Authors (and copyright holders): \\ \ \ \ \ Mike Gabriel <mike.gabriel@das-netzwerkteam.de> \\ \ \ \ \ Daniel Teichmann <daniel.letsplay007@gmail.com>
+%    \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@+->Upstream code: \\ \ \ \ \ \scriptsize \url{https://code.it-zukunft-schule.de/cgit/impressive-display/}
     \end{itemize}
     }
   \end{beamerboxesrounded}