summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBenjamin Schlüter <bschlueter@posteo.de>2017-03-22 17:02:38 +0100
committerBenjamin Schlüter <bschlueter@posteo.de>2017-03-22 17:02:38 +0100
commitc57f2e6c0423ffd538a6c391c911c17e85668ef2 (patch)
tree7b5b9e8aa7198b205610f751afe655dc675e8ab8
parent8bbf416d066a23c2cd69bf379d1a3e0184c8861d (diff)
downloadsurf-display-c57f2e6c0423ffd538a6c391c911c17e85668ef2.tar.gz
surf-display-c57f2e6c0423ffd538a6c391c911c17e85668ef2.tar.bz2
surf-display-c57f2e6c0423ffd538a6c391c911c17e85668ef2.zip
Partially wrote/rewrote midori-display.tex based off of *.tex for impressive-display.
-rw-r--r--data/midori-display.tex232
1 files changed, 232 insertions, 0 deletions
diff --git a/data/midori-display.tex b/data/midori-display.tex
index e69de29..6acbf43 100644
--- a/data/midori-display.tex
+++ b/data/midori-display.tex
@@ -0,0 +1,232 @@
+\documentclass[english,smaller,t]{beamer}
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage[right]{eurosym}
+\usepackage{lmodern}
+
+\newcommand{\noun}[1]{\textsc{#1}}
+
+\usepackage[english]{babel}
+\usepackage[babel]{csquotes}
+\MakeAutoQuote{»}{«}
+
+\pdfimageresolution150
+\def\EUR{\,\euro}
+
+%\usepackage{beamerthemesplit}
+%\usetheme{Warsaw}
+%\usetheme{Berkeley}
+%\usetheme{Marburg}
+%\usetheme{Goettingen}
+%\usetheme{AnnArbor}
+\usetheme{PaloAlto}
+%\usecolortheme{beaver}
+%\usecolortheme{dolphin}
+\usecolortheme{wolverine}
+\beamertemplatenumberedsquaresectiontoc
+\beamertemplatetransparentcovered
+
+\title[Midori Display]{Midori Display HowTo (v0.0.1)}
+\institute[Debian Edu]{Debian Edu Dev Team}
+\author[Debian Edu \\ Dev Team]{Mike Gabriel \\ Daniel Teichmann \\ Benjamin Schlüter \\ and others}
+\date{Mar 2017}
+
+\begin{document}
+
+\frame{\titlepage}
+%\frame{\tableofcontents}
+
+\section[About]{About Midori Display}
+
+\frame[label=about]
+{
+ \frametitle{About Midori Display}
+ \framesubtitle{What can I use Midori Display for?}
+
+ \begin{beamerboxesrounded}[shadow=true]{Setup PDF presentation Screens at School, University \& your Office}
+
+ \parbox[t][2.4in][t]{3.5in}{
+ \begin{itemize}
+ \item<alert@+| uncover@+->An \textbf{Midori Display} can be used to \textbf{provide controlled public internet access} while running in KIOSK-mode \textbf{for passerbys and visitors}
+ \item<alert@+| uncover@+->At schools for example, it can be used to enable \textbf{students and visitors} to search the school-homepage or research something for \textbf{classes}
+ \item<alert@+| uncover@+->At theaters or other venues, you can provide access to \textbf{a pre-configured set of websites} to e.g. make the \textbf{schedule for the next show} available
+ \item<alert@+| uncover@+->Midori Display has been \textbf{designed for easy and secure access} to websites and web based information
+ \end{itemize}
+ }
+ \end{beamerboxesrounded}
+}
+
+\frame[label=extend]
+{
+ \frametitle{About Midori Display}
+ \framesubtitle{How can I extend Midori Display?}
+
+ \begin{beamerboxesrounded}[shadow=true]{Combine Midori Display with other FLOSS Components}
+
+ \parbox[t][2.4in][t]{3.5in}{
+ \begin{itemize}
+ \item<alert@+| uncover@+->Combine Midori 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}
+}
+
+\frame[label=howitworks]
+{
+ \frametitle{About Midori Display}
+ \framesubtitle{How does it work?}
+
+ \begin{beamerboxesrounded}[shadow=true]{Midori Display runs as an X11 session manager}
+
+ \parbox[t][2.4in][t]{3.5in}{
+ \begin{itemize}
+ \item<alert@+| uncover@+->\textbf{Midori 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@+->Midori 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}
+}
+
+
+\section[Installation]{Installation}
+
+\frame[label=debinstall]
+{
+ \frametitle{Installation\,\ldots}
+ \framesubtitle{\ldots\,on a standalone Debian-like system.}
+
+ \begin{beamerboxesrounded}[shadow=true]{Installation: Debian GNU/Linux (and alike)}
+
+ \parbox[t][2.4in][t]{3.5in}{
+ \begin{itemize}
+ \item<alert@+| uncover@+->\textbf{Install a minimal} Debian (or derivative) \textbf{system without X11} / Graphical Login Manager
+ \item<alert@+| uncover@+->Install Midori Display and NoDM: \\ \small \texttt{apt-get install midori-display nodm}
+ \item<alert@+| uncover@+->\textbf{Edit \texttt{/etc/default/nodm}}, set \texttt{NODM\_ENABLED=true} and \texttt{NODM\_USER=midori-display}
+ \item<alert@+| uncover@+->\textbf{Check that \texttt{midori-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{Midori 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=ltspchroot]
+{
+ \frametitle{Installation\,\ldots}
+ \framesubtitle{\ldots\,in an LTSP chroot.}
+
+ \begin{beamerboxesrounded}[shadow=true]{Install LTSP based info screen farm running Midori 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/midori-display}
+ \end{itemize}
+ }
+ \end{beamerboxesrounded}
+}
+
+\section[Configuration]{Configuration}
+
+\frame[label=systemconfig]
+{
+ \frametitle{Configuration\,\ldots}
+ \framesubtitle{\ldots system-wide}
+
+ \begin{beamerboxesrounded}[shadow=true]{Configure Midori Display -- system-wide}
+
+ \parbox[t][2.4in][t]{3.5in}{
+ \begin{itemize}
+ \item<alert@+| uncover@+->The \textbf{system-wide configuration} of Midori Display is done \textbf{in \texttt{/etc/default/midori-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 Midori Display -- on a per-user basis}
+
+ \parbox[t][2.4in][t]{3.5in}{
+ \begin{itemize}
+ \item<alert@+| uncover@+->The \textbf{per-user configuration} of Midori Display is done \textbf{in \texttt{\$HOME/.midori-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/.midori-display/secrets/default.secrets}
+ \item<alert@+| uncover@+->\textbf{Credentials} can also be \textbf{specified per info screen}: \\ \small \texttt{\$HOME/.midori-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}
+}
+\section[Testing]{Testing your Setup}
+
+\frame[label=testing]
+{
+ \frametitle{Testing Midori 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@+->\textbf{Install Midori Display} locally \textbf{on your PC or notebook}; you can launch Midori Display under your normal user account
+ \item<alert@+| uncover@+->\textbf{Use FAKE\_HOSTNAME variable to simulate a specifc display host} when testing infoscreen farm setups
+ \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: \\ \small \texttt{export DISPLAY=:1 \\ FAKE\_HOSTNAME=<display-host> midori-display}
+ \end{itemize}
+ }
+ \end{beamerboxesrounded}
+}
+
+\section[Authors]{Authors and Contributors}
+
+\frame[label=label]
+{
+ \frametitle{Authors, Contributors \& Sponsors}
+
+ \begin{beamerboxesrounded}[shadow=true]{Authors \& Contributors}
+
+ \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.letsplay007@gmail.com> \\ \ \ \ \ Benjamin Schlüter <bschlueter@posteo.de>
+% \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/midori-display/}
+ \end{itemize}
+ }
+ \end{beamerboxesrounded}
+}
+
+\end{document}