From f35565737733e319e7293a9fafe1b78e87f8a14e Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Sun, 21 Feb 2021 03:01:41 +0000
Subject: CTAN sync 202102210301

---
 macros/latex/contrib/elpres/elpres-manual.tex | 474 +++++++++++++++++++++-----
 1 file changed, 381 insertions(+), 93 deletions(-)

(limited to 'macros/latex/contrib/elpres/elpres-manual.tex')

diff --git a/macros/latex/contrib/elpres/elpres-manual.tex b/macros/latex/contrib/elpres/elpres-manual.tex
index f9357f2044..3a5a2d24b0 100644
--- a/macros/latex/contrib/elpres/elpres-manual.tex
+++ b/macros/latex/contrib/elpres/elpres-manual.tex
@@ -1,34 +1,66 @@
 %      -*-  coding:utf-8 -*-
 \documentclass[11pt,a4paper]{article}
 
-\setlength{\parskip}{0.6ex}
-\setlength{\parindent}{0mm}
+% to be compiled with lualatex
+
+\usepackage{parskip}
 \usepackage[a4paper,hmargin=2.4cm,bottom=3.2cm]{geometry}
+\usepackage{makeidx}
 \usepackage{url}
 \usepackage{framed}
 \usepackage{graphicx}
-\usepackage{xcolor}
+\usepackage[x11names,svgnames]{xcolor}
 \usepackage{enumitem}
 
+\usepackage{microtype}
+
 \usepackage{luaotfload}
 \usepackage{fontspec}
-\setsansfont{Latin Modern Sans}
-\setmonofont{Latin Modern Mono}
-\setmainfont{Latin Modern Roman}
 
+\setmainfont[%
+ItalicFont=NewCM10-BookItalic.otf,%
+BoldFont=NewCM10-Bold.otf,%
+BoldItalicFont=NewCM10-BoldItalic.otf,%
+SmallCapsFeatures={Numbers=OldStyle}]{NewCM10-Book.otf}
+
+\setsansfont[%
+ItalicFont=NewCMSans10-BookOblique.otf,%
+BoldFont=NewCMSans10-Bold.otf,%
+BoldItalicFont=NewCMSans10-BoldOblique.otf,%
+SmallCapsFeatures={Numbers=OldStyle}]{NewCMSans10-Book.otf}
+
+\setmonofont[ItalicFont=NewCMMono10-BookItalic.otf,%
+BoldFont=NewCMMono10-Bold.otf,%
+BoldItalicFont=NewCMMono10-BoldOblique.otf,%
+SmallCapsFeatures={Numbers=OldStyle}]{NewCMMono10-Book.otf}
+
+\makeindex
 
-%% for tth: remove "noitemsep" !!
+%% for tth (generate .html): comment out "noitemsep" temporarily !!
+
+% Commands for indication changes in updated versions:
+% changed, inserted
+\newcommand{\changedbegin}[1]{\textcolor{blue}{\fbox{\texttt{#1$>$}}}}
+\newcommand{\changedend}[1]{\textcolor{blue}{\fbox{\texttt{$<$#1}}}}
+\newcommand{\changedbeginA}[1]{\textcolor{DarkGreen}{\fbox{\texttt{#1$>$}}}}
+\newcommand{\changedendA}[1]{\textcolor{DarkGreen}{\fbox{\texttt{$<$#1}}}}
 
 
 \usepackage[%
+  bookmarksnumbered=true,
   colorlinks=true%
 ]{hyperref}
 
+\usepackage[nottoc]{tocbibind}
+
 \title{\textsf{elpres} --- electronic presentations \\ with (pdf)\LaTeX}
 \author{Volker Kiefel\thanks{volker dot kiefel at freenet dot de, 
        \url{http://vkiefel.de/elpres.html}}}
-\date{v0.6\\[1.8ex]
-      August 19, 2020}
+\date{v0.7\\[1.8ex]
+  February 20, 2021%
+  % --- \textcolor{DarkGreen}{update of this manual:
+  %   September 27, 2020}
+}
 
 
 
@@ -37,28 +69,37 @@
 \maketitle
 \thispagestyle{empty}
 
-{
-% \setlength{\parskip}{0ex}
-  \setlength{\parskip}{0.26ex}
 \tableofcontents
-}
 
-% \clearpage
 
-\vspace{8ex}
+% \section*{A note on this updated version of the \texttt{elpres} manual}
+
+% \begin{sloppypar}
+% In this updated version of the manual
+% paragraphs or sentences with changes until August 19, 2020
+% (compared to the ``official''
+% manual for v0.6) are marked
+% \changedbegin{changed} changed content \changedend{changed}
+% and new text is marked \changedbegin{inserted} new content
+% \changedend{inserted}. Additional changes until September 27, 2020:
+% \changedbeginA{inserted} new text \changedendA{inserted},
+% \changedbeginA{changed} modified text \changedendA{changed}.
+% \end{sloppypar}
 
 \section{Introduction}
 
-The \textsf{elpres} class is intended to be used for
+The \texttt{elpres} class is intended to be used for
 presentations on a computer screen, a
 beamer or a projector. It is derived from \LaTeX's \texttt{article} class and
 may be used with \LaTeX{}, pdf\LaTeX{} (and Lua\LaTeX ).
-The default ``virtual paper size''
-of document pages
-produced by this class: width=128mm, height=96mm corresponds to a
-4:3 (width:height) aspect ratio. Other aspect ratios for widescreen monitors
-may be selected
-by class options. The \textsf{elpres} class requires that the \texttt{ifthen},
+The default ``virtual paper size'' of document pages produced by this class:
+width=128mm, height=96mm corresponds to a 4:3 (width:height) aspect
+ratio.
+\index{aspect ratio|see{screen aspect ratio}}%
+\index{screen aspect ratio}%
+Other aspect ratios for widescreen monitors may be selected by class
+options.
+The \textsf{elpres} class requires that the \texttt{ifthen},
 \texttt{fancyhdr},
 \texttt{hyperref},
 \texttt{graphicx},
@@ -83,6 +124,10 @@ They can be used in users' presentation files.\footnote{To make copying easier,
 this manual is also available as \texttt{.html} document on the
 \texttt{elpres} website (\url{http://www.vkiefel.de/elpres.html})}
 
+Some extensions described in this manual work only with \texttt{pdf}-files
+which should preferrably be compiled with pdf\LaTeX\ or Lua\LaTeX.
+\index{Lualatex@Lua\LaTeX}
+\index{pdflatex@pdf\LaTeX}
 
 \section{Installation}
 
@@ -91,6 +136,7 @@ this manual is also available as \texttt{.html} document on the
 
 \begin{sloppypar}
 
+\index{installation|(}  
 If the \texttt{elpres} package has already been installed with the \TeX-system
 nothing needs to be done. If an updated  version shall be installed,
 \texttt{elpres.cls}, the \texttt{.sty}, \texttt{.png} and \texttt{.eps}
@@ -119,6 +165,7 @@ their own package updating mechanisms. The elpres manual file should be
 accessible with the command ``\mbox{\texttt{texdoc elpres}}''. If this
 still calls the old version of the manual, the command ``\texttt{texdoc -l elpres}''
 will prompt you to select either the old or the new version of the manual.
+\index{installation|)}
 
 \section{Usage}
 
@@ -129,12 +176,14 @@ The class is used with
    \documentclass[options]{elpres}
 \end{verbatim}
 
-\textbf{\texttt{Elpres}-specific options}: for font selection
+\index{elpres@\texttt{elpres}!options}
+\textbf{\texttt{Elpres}-specific options}: font selection:
  \texttt{tmrfont} (Times Roman), \texttt{helvetfont}
-(Helvetica), \texttt{cmfont} (Computer Modern), \texttt{sansfont} (Sans
-Serif: default) and \texttt{nofonts} (no font selection, 
-intended for use of \texttt{elpres} with Lua\LaTeX\
-with its own font selection mechanisms) are used.
+(Helvetica), \texttt{cmfont} (Computer Modern) and \texttt{sansfont} (Sans
+Serif: default). The option \texttt{nofonts} (no font selection) 
+is intended for use of \texttt{elpres} with Lua\LaTeX\
+\index{Lualatex@Lua\LaTeX}
+with its own font selection mechanisms.
 Options for different screen aspect ratios: \texttt{4x3}
 (default), \texttt{16x9}, \texttt{16x10}. The option \texttt{navisymb}
 adds symbols for navigation to the presentation. 
@@ -144,25 +193,35 @@ e.\,g.  \texttt{10pt}, \texttt{11pt}, \texttt{12pt} for
 selection of font size. 
 
 
+\index{elpres@\texttt{elpres}!commands}
 \textbf{\texttt{Elpres}-specific commands}:
 \verb+\distance+ vertically adjusts  text on a slide.
 The \verb+\auvimm+\footnote{for \textbf{au}dio \textbf{vi}deo \textbf{m}edia}
 command inserts a link to an external audio or video file.
 Two commands: \verb+\fromlinktext+ and \verb+\totargettext+
+\index{fromlinktext@\verb+\fromlinktext+}
+\index{totargettext@\verb+\totargettext+}
 can be used for internal links within a presentation.
 With \verb+\slidetitlecolor+, the text color of slides (\texttt{psli})
 can be changed.
+With the command \verb+\pagenrconst+, the page number of
+the current slide can be set to the page number of the previous slide.
 
-
+\index{elpres@\texttt{elpres}!environments}
 \textbf{\texttt{Elpres}-specific environments}:
 the environments \texttt{psli} and \texttt{rsli} define ``slides'' in
 \texttt{elpres}; \texttt{citemize}, \texttt{cenumerate} and
 \texttt{cdescription} provide vertically compressed lists.
+\index{slides in elpres@slides in \texttt{elpres}}
 
 \subsection{A minimalistic example presentation}
 
+
 The following code may be used for your first ``experiments'' by adding
-features described in latex sections.
+features described in later sections.
+
+\index{minimalistic example, presentation}
+\index{simple example, presentation|see{minimalistic example, presentation}}
 
 \begin{verbatim}
    \documentclass[12pt,pdftex,4x3]{elpres}
@@ -170,7 +229,6 @@ features described in latex sections.
    \usepackage[document]{ragged2e}
 
    % \usepackage{elpreswhitebluescheme}
-   % \usepackage{elpreswhitetealscheme}
    % \usepackage{elpresbluelightgrayscheme}
    % \usepackage{elpresgrayscheme}
    % \usepackage{elpreswhiteredscheme}
@@ -210,6 +268,34 @@ features described in latex sections.
    \end{document}
 \end{verbatim}
 
+
+The preamble of the same presentation for Lua\LaTeX\ would read:
+
+\begin{verbatim}
+   % LuaLaTeX: Please use utf-8 encoding!
+   \documentclass[12pt,nofonts,4x3]{elpres}
+   \usepackage[document]{ragged2e}
+   \usepackage{fontspec}
+   
+   \setmonofont{TeX Gyre Cursor}              %% based on 'Courier'
+   \setsansfont[Scale=0.92]{Tex Gyre Heros}   %% similar to 'Helvetica'
+   \setmainfont{TeX Gyre Termes}              %% 'Roman' style serif font
+   \renewcommand{\familydefault}{\sfdefault}
+   
+   % \usepackage{elpreswhitebluescheme}
+   \usepackage{elpreswhitetealscheme}
+   % \usepackage{elpresbluelightgrayscheme}
+   % \usepackage{elpresgrayscheme}
+   % \usepackage{elpreswhiteredscheme}
+   
+   \begin{document}
+   % ...
+   \end{document}
+\end{verbatim}
+
+\index{Lualatex@Lua\LaTeX}
+The use of Lua\LaTeX\ with \texttt{elpres} is heavily recommended
+due to the superior font selection mechanisms.
 You may copy the code examples from this manual more easily from the
 \texttt{.html} version of this manual available at
 \url{http://vkiefel.de/elpres/elpres-manual.html}.
@@ -217,21 +303,26 @@ You may copy the code examples from this manual more easily from the
 
 \subsection{Essential elements of an \texttt{elpres} presentation}
 
+\index{title page}
 The \textbf{title page} slide can be created with
 the \texttt{titlepage}  environment (or \texttt{rsli}, see below), \LaTeX's 
 \verb+\maketitle+ command is not available.
+\index{psli environment@\texttt{psli} environment}
 \textbf{Slides} may be created with the
 \texttt{psli}-environment\footnote{\texttt{psli}: \textbf{pl}ain
   \textbf{sl}ide}, you may add
 the title of the slide with the optional parameter. 
 The contents of the slide are centered vertically.
 
+
+\index{rsli environment@\texttt{rsli} environment}
 Another environment generating a \textbf{slide} is
 \texttt{rsli}\footnote{\texttt{rsli}: \textbf{ra}w \textbf{sl}ide}:
 slides are written 
 without title,
 contents are not vertically centered. 
 
+\index{distance@\verb+\distance+}
 The \verb+\distance{number}+ command allows to introduce vertical space into
 slides constructed with the \texttt{rsli} and \texttt{titlepage} environments.
 You should use pairs of \verb+\distance{}+ commands with numbers indicating
@@ -248,7 +339,9 @@ inserted only after a second run of \LaTeX.
 
 By default, \LaTeX\ produces justified paragraphs with lines of equal length,
 this may often not be appropriate for the usually very short lines of text
-in presentations. The \LaTeX\ \verb+\raggedright+ command has its own
+in presentations. The \LaTeX\ \verb+\raggedright+ command
+\index{raggedright@\verb+\raggedright+}
+has its own
 deficiencies: by inhibiting hypenation in texts with rather short lines,
 the right margin will often look too
 ragged. A solution is to use the \verb+\RaggedRight+ command of the
@@ -261,6 +354,7 @@ As the spaces between lines may be too great with the \texttt{itemize}
 environment,
 the \texttt{elpres} package provides a ``vertically compressed''
 \texttt{citemize}-environment:
+\index{citemize environment@\texttt{citemize} environment}
 
 \begin{verbatim}
    \begin{citemize}
@@ -271,6 +365,9 @@ the \texttt{elpres} package provides a ``vertically compressed''
 
 Similarly, a \texttt{cenumerate} and a \texttt{cdescription} environment may
 be used.
+\index{cenumerate environment@\texttt{cenumerate} environment}
+\index{cdescription environment@\texttt{cdescription} environment}
+
 
 % neu Dezember 2017
 Another solution for the customization of \texttt{itemize}
@@ -309,8 +406,11 @@ Similarly, the \texttt{enumitem} package is also able to modify the
 
 By default, the \textbf{text color of the titles} of
 \texttt{psli}-slides is black,
+\index{slidetitlecolor@\verb+\slidetitlecolor+}
+\index{title, text color}
 it may be changed by redefining the ``value'' of the \verb+\slidetitlecolor{}+
 command like
+\index{slidetitlecolor@\verb+\slidetitlecolor+}
 
 \begin{verbatim}
    \slidetitlecolor{blue}
@@ -319,6 +419,7 @@ command like
 in the preamble. Of course, you may also use the named colors of the
 \texttt{xcolor} package (see section \ref{sec:use-colors}).
 
+\index{page number}
 By default the \textbf{page number} appears at the right bottom of the slide
 (in the ``footer'' in the terminology of the \texttt{fancyhdr} package)
 this position can be addressed by the \verb+\rfoot{}+ command: the
@@ -337,8 +438,10 @@ you can overwrite the default page number with an ``empty'' \verb+\rfoot{}+
 command and put it to the center or the left margin of the footer
 (\verb+\cfoot{\footnotesize \thepage}+ or 
 \verb+\lfoot{\footnotesize \thepage}+). These ``footer fields''
-are also suitable to enter a \textbf{logo} visible on all pages
-(in form of a graphics file using
+\index{footer fields on slides}
+are also suitable to enter a \textbf{logo}
+\index{logo graphics file}
+visible on all pages (in form of a graphics file using
 \verb+\includegraphics[]{}+) or text with the name of the speaker's
 institution.
 \end{sloppypar}
@@ -375,6 +478,8 @@ The complete lists of named colors are found in the \texttt{xcolor} manual.
 
 \subsection{Include graphics files}
 
+\index{graphics files}
+\index{includegraphics@\texttt{\textbackslash includegraphics}}
 Graphics files/pictures can be included with the
 \texttt{includegraphics}-command of the \texttt{graphicx}-package. Please be
 aware that the dimensions of the pages are \mbox{128mm x 96mm} and
@@ -410,6 +515,8 @@ driver related option (e.\,g. \texttt{pdftex} or \texttt{dvips})
 
 \label{secTwoColumns}
 
+\index{columns}
+\index{minipage environment@\texttt{minipage} environment}
 Text and graphics may be arranged in two or more columns with
 \texttt{minipage} environments:
 
@@ -436,6 +543,8 @@ documentation.
 
 \label{secOverlay}
 
+\index{incremental slides|see{overlays}}
+\index{overlays|(}
 If the contents of slides are to be made visible step
 by step this can be achieved by a series of output PDF or (PS) files (carrying
 the same page number) usually called \emph{overlays}. It may also be of
@@ -527,11 +636,23 @@ If you use one of the \emph{presentation schemes} described in section
 \ref{sec:pres-scheme}, the necessary adjustments
 for the background color will be made automatically.
 For more details on \texttt{overlays}, see the documentation of the package.
+\index{overlays|)}
+
+Sometimes it is desirable to prepare \textbf{two or more consecutive
+slides with the same page
+number} independent
+of the overlays package  (``manual overlays slides''). Therefore,
+the page number of the current slide
+can be set to the page number of the previous slide/page
+with the command \verb+\pagenrconst+.
+\index{pagenrconst@\verb+\pagenrconst+}
 
+% \pagenrconst
 
 \subsection{Navigation symbols}
 \label{sec:NavigationSymbols}
 
+\index{navigation symbols panel|(}
 With the \texttt{navisymb} option of \texttt{elpres} a panel with navigation
 symbols appears
 in the right lower corner of the presentation:\\
@@ -554,21 +675,53 @@ with \texttt{evince} (Linux).
 Some of these functions also work in presentation-mode
 of the ``internal'' PDF-viewer in recent versions of the
 \texttt{Firefox}-browser (Linux, Windows).
+\index{navigation symbols panel|)}
+
 
 
 \subsection{Run multimedia content from a presentation}
 \label{sec:MultimediaContent}
 
 
-The command \verb+\auvimm{text}{media-file}+ inserts \texttt{text} with a
-link (``poster''), which allows to start the default application
-for an audio or video media file
-(\texttt{media-file}).  This worked flawlessly on the computers of the author of
-this manual with Adobe Acrobat Reader (Windows) and with \texttt{evince} and
-\texttt{Impress!ve}\footnote{Can be started from the terminal:
-  \texttt{impressive}} (Linux).\footnote{The \texttt{\textbackslash auvimm}
-  command uses the \texttt{\textbackslash href} command of the
-  \texttt{hyperref} package} An example for using this command:
+% https://tex.stackexchange.com/questions/345431/how-to-include-multimedia-files-in-beamer
+
+\index{multimedia files|(}
+\index{audio files|see{multimedia files}}
+\index{video files|see{multimedia files}}
+In this section inclusion of video and audio files
+into a presentation will be described. With the
+\verb+\auvimm{}{}+
+\index{auvimm@\verb+\auvimm+}
+command described below you will
+be able to lauch an external application for playing the video or audio
+file. This will work in many situations for video and audio files
+on Windows (Adobe Acrobat) and Linux (e.\,g. using
+\index{Acrobat pdf viewer}
+\texttt{evince} and
+\index{evince pdf file viewer@\texttt{evince} pdf file viewer})
+systems in fullscreen mode.
+Under certain conditions it is possible to define a ``poster area'' on a
+slide and the pdf viewer starts (after clicking with the mouse pointer into
+this area) the
+presentation of the video within this frame.
+The advantage of this technique is that it avoids that
+window with the external application is started.
+On Linux systems the \texttt{pdfpc}
+\index{pdfpc viewer@\texttt{pdfpc} viewer}
+viewer allows this, a detailed description
+is shown below. In both sitauations, however, the multimedia file is not
+incorprated into the pdf-file and must be available on the computer
+at the time of the presentation, ideally in the same directory as the
+\texttt{.pdf}-file.
+
+The command \verb+\auvimm{text}{media-file}+ inserts \texttt{text} with a link
+(``poster''), which allows to start the external default application for an
+audio or video media file (\texttt{media-file}).  This worked flawlessly on
+the computers of the author of this manual with Adobe Acrobat Reader (Windows)
+and with \texttt{evince} (Linux).\footnote{The
+  \texttt{\textbackslash auvimm} command uses the \texttt{\textbackslash href}
+  command of the \texttt{hyperref} package}
+An example for using this command:
 
 \begin{verbatim}
    \auvimm{[sound-file]}{./audiofile.mp3}
@@ -576,15 +729,17 @@ this manual with Adobe Acrobat Reader (Windows) and with \texttt{evince} and
 
 This produces the (text-based) ``button'' or ``poster'' \texttt{[sound-file]}.
 You may also insert an image file as a poster with a graphics file using
-\texttt{\textbackslash inlcudegraphics}:
+\verb+\includegraphics+:
 
 \begin{verbatim}
    \auvimm{\includegraphics{/path/to/poster.png}}{./audiofile.mp3}
 \end{verbatim}
 
-If you hit the poster with the mouse pointer it will call the default
-application for audio files. If this does not work, it may be necessary to
-write as ``launch'' command:
+If you hit the poster area with the mouse pointer, it will launch the default
+application for audio files in a seperate window. This should be possible
+even if the pdf-viewer works if fullscreen-mode at the time of presentation.
+If this does not work, it may be necessary to
+insert as ``launch'' command:
 
 \begin{verbatim}
    \auvimm{[video-file]}{run:./videofile.mp4}
@@ -599,21 +754,47 @@ a call to an external program might be blocked due security reasons in Acrobat
 Reader.
 
 \begin{leftbar}
-This \texttt{\textbackslash auvimm}-command should be considered experimental.
-Its behavior depends on the pdf-viewer and the configuration of the OS.
+This \verb+\auvimm{}+-command should be considered experimental.
+Its behavior depends on the \texttt{pdf}-viewer and the configuration of the OS.
 \end{leftbar}
 
 
+On Linux systems, the \texttt{pdfpc}
+\texttt{pdf}-viewer\footnote{\url{https://pdfpc.github.io/}: \texttt{pdfpc} --- A
+  presenter console with multi-monitor support for PDF files} allows
+presentation of a video embedded into a ``poster area''\footnote{e.\,g. defined
+by a bitmap image with the same aspect ratio as the video}
+on a slide
+without starting the external viewer in a separate window. This is supported
+with the \verb+\pdfpcmovie{}{}+-command from the
+\texttt{pdfpc-movie}-package and with \verb+\auvimm{}{}+
+using the ``\texttt{run:./video-file}'' launch-command. An example
+with \verb+\auvimm{}{}+:
+
+\begin{verbatim}
+   \auvimm{\includegraphics[width=0.4\textwidth]{poster.png}}{run:./video.mp4}
+\end{verbatim}
+
+This \texttt{pdfpc}-specific extension seems to work only for video files,
+but not for audio files. A possible solution is to convert an audio file into
+a ``video format'', e.\,g. with the \texttt{ffmpeg} program.
+\index{multimedia files|)}
+
 
 \subsection{Prepare a ``handout'' from a presentation}
 
 \label{secHandout}
 
-In advance of a lecture it is often expected that you
-prepare a ``handout'' from your presentation with more than one
-pages on a printed page. Therefore
-you have several options, two of them are described
-here.
+In advance of a lecture it is often expected that you prepare a ``handout''
+from your presentation with more than one pages on a printed page. Therefore
+you have several options, three of
+them are described here.
+If a presentation contains overlay-slides generated with the \texttt{overlays}
+package as described in section \ref{secOverlay}, it should be recompiled
+with the commands described in section \ref{sec:inact-overl-comm}
+added to the preamble
+in order to inactivate the overlays-specific commands.
+
 
 \subsubsection{\LaTeX\ article document with a series of single-page pdf-files included}
 
@@ -621,7 +802,8 @@ One solution to this problem is (1) to generate a series of single-page
 pdf-files and (2) to create a pdf\LaTeX\ document with the single
 pages included.
 
-\textbf{(1)} can be done with \texttt{gs} (the Ghostscript program):
+\textbf{(1)} can be done with \texttt{gs} (the \texttt{ghostscript} program):
+\index{ghostscript@\texttt{ghostscript}}
 
 \begin{verbatim}
    gs -dNOPAUSE -dBATCH -sDEVICE=pdfwrite  -sOutputFile=page_%03d.pdf in.pdf
@@ -633,6 +815,7 @@ website\footnote{\url{https://www.ghostscript.com/doc/current/Use.htm}}.
 On Windows systems the name of the ghostscript command may be
 \texttt{gswin32c.exe} or  \texttt{gswin64c.exe}.
 An alternative to \texttt{gs} is the \texttt{pdftk} tool:
+\index{pdftk@\texttt{pdftk}}
 
 \begin{verbatim}
     pdftk in.pdf  burst output  page_%03d.pdf
@@ -664,6 +847,45 @@ The syntax of \texttt{pdftk} is explained in the documentation
    \end{document}
 \end{verbatim}
 
+
+\subsubsection{Create handout with the \texttt{pdfpages} package}
+
+\label{sec:handout-pdfpages}
+
+\index{handout|(}
+Another, more comfortable option is to use the \texttt{pdfpages} package.
+Here, it is not necessary to split up the presentation into single pages.
+An example (in ``portait format'') which generates pages with 2x4 slides
+(all slides except slide 2) using the
+\verb+\includepdf[]{}+ command:
+
+\begin{verbatim}
+   \documentclass[12pt]{article}
+   \usepackage[a4paper,hmargin=2cm,bottom=3.2cm]{geometry}
+   \usepackage{pdfpages}
+   \begin{document}
+   \includepdf[pages={1,3-last},nup=2x4,frame=true,%
+   scale=0.78,%
+   pagecommand={\thispagestyle{plain}}]{presentation.pdf}
+   \end{document}
+\end{verbatim}
+
+Details on the optional parameters of \verb+\includepdf+ can
+be found in the documentation of the \texttt{pdfpages} package. This code:
+
+\begin{verbatim}
+   \documentclass[12pt,landscape]{article}
+   \usepackage[a4paper,hmargin=2cm,bottom=3.2cm]{geometry}
+   \usepackage{pdfpages}
+   \begin{document}
+   \includepdf[pages={1,3-last},nup=3x2,frame=true,%
+   scale=0.78,%
+   pagecommand={\thispagestyle{plain}}]{presentation.pdf}
+   \end{document}
+\end{verbatim}
+
+generates pages in ``landscape format'' with 3x2 slides.
+
 \subsubsection{Convert presentation pdf-file directly into handout file with \texttt{pdfjam}}
 
 With the following command:
@@ -674,7 +896,9 @@ With the following command:
 
 \begin{sloppypar}
 \texttt{pdfjam}\footnote{which regerettably is only available on
-Linux or other Unix-like systems}
+  Linux or other Unix-like systems,
+  on Windows systems, the procedure described
+  above in section \ref{sec:handout-pdfpages} can be used as alternative}
 creates a ``handout'' PDF document (\texttt{new.pdf}) fom
 \texttt{in.pdf} with the slides nr. 1-4,6-22
 arranged in  two columns and four rows.
@@ -682,8 +906,9 @@ With the additional option ``\texttt{--frame~true}'',
 \texttt{pdfjam} draws a box
 around each slide. More details can be found in the \texttt{pdfjam}
 man page and the project
-website\footnote{https://github.com/DavidFirth/pdfjam/blob/master/README.md}. 
+website\footnote{\url{https://github.com/DavidFirth/pdfjam/blob/master/README.md}}. 
 \end{sloppypar}
+\index{handout|)}
 
 
 
@@ -691,6 +916,7 @@ website\footnote{https://github.com/DavidFirth/pdfjam/blob/master/README.md}.
 
 \label{secHypertext}
 
+\index{hypertext elements|(}
 You may use two commands \verb+\fromlinktext{}{}+ and \verb+\totargettext{}{}+
 for ``hypertext features''.  As an example: as you normally will not insert
 \verb+\section{}+-like commands and therefore do not generate a ``table of
@@ -740,6 +966,8 @@ color model:
 This defines a light gray color for the link border, more details on
 \verb+\hypersetup{}+ are
 described in the documentation of the \texttt{hyperref} package.
+\index{hypertext elements|)}
+
 
 \subsection{Fill background of a presentation with bitmaps}
 
@@ -747,6 +975,7 @@ described in the documentation of the \texttt{hyperref} package.
 
 \subsubsection{\texttt{Wallpaper} package}
 
+\index{wallpaper background|(}
 To create a slide background with a graphical wallpaper 
 background using bitmap files you may use the \texttt{wallpaper}
 package\footnote{written by Michael H.F. Wilkinson and available on CTAN}. 
@@ -766,7 +995,7 @@ file \texttt{background.png}, enter
 \end{verbatim}
 
 before the contents of the presentation\footnote{i.\,e. following
-\texttt{\textbackslash begin\{document\}}}. 
+\textbackslash begin\{document\}}. 
 This works best with bitmaps with an appropriate aspect ratio, in the case of
 an 4x3 screen format a bitmap picture of 640x480 pixel would fit perfectly. 
 Moreover bitmap files may be
@@ -800,12 +1029,17 @@ Another package which allows you to paint the background with a picture is
 \verb+\ClearShipoutPicture+ clears the background beginning with the current
 page.
 Details of \texttt{eso-pic}'s commands can be found in the documentation.
+\index{wallpaper background|)}
 
 
 \subsection{Presentation schemes}
 
 \label{sec:pres-scheme}
 
+\index{presentation schemes|(}
+\index{color schemes|see{presentation schemes}}
+\index{schemes, color|see{presentation schemes}}
+
 \texttt{Elpres} provides predefined \textbf{presentation schemes}:
 color and layout schemes which are applied to a presentation with
 \verb+usepackage{}+. Their naming follows the convention
@@ -883,6 +1117,7 @@ Presentation schemes available in the current version of \texttt{elpres}:
 
 In all of these schemes, the colors of borders for internal and external
 links have been adjusted.
+\index{presentation schemes|)}
 
 
 % Die Farben in LibreOffice / rgb (266) / rgb (1)
@@ -894,9 +1129,12 @@ links have been adjusted.
 \section{Recipes for use of \texttt{elpres}}
 \label{sec:elpres-recipes}
 
+\index{recipes for elpres presentations@recipes for \texttt{elpres} presentations}
+
 \subsection{Colored text boxes}
 \label{sec:colored-text-boxes}
 
+\index{text boxes, colored}
 Colored text boxes often help the presentation author to highlight small text
 fragments and to make slides more ``readable'' and more attractive.
 
@@ -922,6 +1160,8 @@ commands (\texttt{xcolor} package):
    \end{psli}
 \end{verbatim}
 
+The advantage of these simple colored text boxes: they  are compatible
+with incremental slides using the \texttt{overlays} package.
 
 \subsubsection{Text boxes with the \texttt{tcolorbox} package}
 \label{sec:tcolorbox-boxes}
@@ -954,8 +1194,12 @@ An example with a titled colored textbox:
    
 \end{verbatim}
 
-The manual of the \texttt{tcolorbox} provides perfect instuction for the use
-of this package.
+The manual of the \texttt{tcolorbox} provides perfect instruction for the use
+of this package. 
+These text boxes may yield problems
+with incremental slides using the \texttt{overlays} package.
+
+
 
 \subsection{Inactivate \texttt{overlays} commands}
 \label{sec:inact-overl-comm}
@@ -989,9 +1233,12 @@ which should be copied or entered in the preamble following
 \subsection{Convert an \texttt{elpres}-presentation (PDF) into an Impress (LibreOffice) or Powerpoint presentation}
 \label{sec:convert-into-libreoff}
 
+\index{Powerpoint presentation} \index{Impress (LibreOffice) presentation}
 Sometimes it is unclear, if organizers of a (scientific) meeting allow
-presentations with pdf-files but insist on files in Powerpoint format. This is
-an unpleasant situation, but sometimes it is better to be prepared.
+presentations with \texttt{.pdf}-files or insist on files in Powerpoint
+format. This is an unpleasant situation for a lecturer, but in such a situation
+it is better, to be
+prepared.
 
 There is no elegant way for a reliable solution.
 First, you may use one of the free or commercial online conversion
@@ -999,60 +1246,95 @@ tools (intended to convert \texttt{.pdf} into
 \texttt{.ppt} or \texttt{.pptx}-files). Results are often not satisfactory.
 
 An alternative, more reliable way preferred
-by the author of this manual (although a little awkward) is:
+by the author of this manual:
 
 
 \begin{enumerate}
-\item convert the pdf-file of the presentation into a series of bitmap
-  graphics files, (e.\,g. in \texttt{.png} format)
-\item import these image \texttt{.png} files into pages of an empty Impress
+\item convert the \texttt{.pdf}-file of the presentation into a series of bitmap
+  image files, (e.\,g. in \texttt{.png} format)
+\item import these image \texttt{.png} files into ``empty'' slides
+  of an Impress
   (LibreOffice or OpenOffice) presentation and save the presentation in
-  \texttt{.ppt} or \texttt{.pptx}-Format
+  \texttt{.odp}, \texttt{.ppt} or \texttt{.pptx}-Format
 \end{enumerate}
 
 \textbf{Details on step 1 --- generate \texttt{.png} images:}
 
-Please copy the following command (ignoring the line-break) into a single line
-at the terminal command prompt or copy them into one line of a short shell
-script (Windows: a \texttt{.bat} file) and ``run'' or execute the shell
+Please copy the following two
+commands (please ignore the line-breaks in the lines
+beginning with ``\texttt{gs}'')\footnote{\i.\,e. ``\texttt{gs ... input.pdf}'' should
+  be entered as one line and ``\texttt{gs ... temp.pdf}'' should be entered as a
+  second line}
+into a short shell
+script (Windows: a \texttt{.bat} or \texttt{.cmd} script) and ``run'' or execute the shell
 script:
 
 \begin{verbatim}
-   gs -dNOPAUSE -dBATCH -sDEVICE=png256 -r300
-          -sOutputFile=page_%03d.png input.pdf
+   gs -dNOPAUSE  -dBATCH -sDEVICE=pdfwrite  -dDEVICEWIDTHPOINTS=793.7 
+      -dDEVICEHEIGHTPOINTS=595.3 -dPDFFitPage -sOutputFile=temp.pdf input.pdf
+
+   gs -dNOPAUSE -dBATCH -sDEVICE=png256 -r300 -dTextAlphaBits=4 
+      -sOutputFile=page_%03d.png temp.pdf
 \end{verbatim}
 
 \begin{sloppypar}
   Please do not forget to adjust the name of the input file
-  \texttt{input.pdf}.  This command generates a series of \texttt{.png}-files
+  (\texttt{input.pdf} in the script above).
+  The first command adjusts the page size of the \texttt{.pdf}-file to
+  \texttt{28~x~21~cm} (which is written into the temporary file
+  \texttt{temp.pdf}:
+  this format avoids resizing of the images in LibreOffice (see below)).
+  The second command generates a series of \texttt{.png}-files:
   \texttt{page\_001.png}, \texttt{page\_002.png} ... \texttt{page\_0nn.png}.
+  Instead of the \texttt{png256} driver, \texttt{png16m} can be used.
   On Windows systems the name of the ghostscript command is
-  \texttt{gswin32c} or \texttt{gswin64c}.
+  \texttt{gswin32c} or \texttt{gswin64c} (instead of \texttt{gs}).
 \end{sloppypar}
 
-If you wish a better resolution of the \texttt{.png} change \texttt{-r300} to
-\texttt{-r600} or even \texttt{-r1200}:
-
-\begin{verbatim}
-   gs -dNOPAUSE -dBATCH -sDEVICE=png256 -r600 
-           -dTextAlphaBits=4 -sOutputFile=page_%03d.png input.pdf
-\end{verbatim}
-
-The additional option  \texttt{-dTextAlphaBits=4} improves font
-antialiasing.\footnote{Details can be found in the docume3ntation of gs
+If you wish a higher resolution of the \texttt{.png} images,
+change \texttt{-r300} to
+\texttt{-r600}.
+% \begin{verbatim}
+%    gs -dNOPAUSE -dBATCH -sDEVICE=png256 -r600 
+%            -dTextAlphaBits=4 -sOutputFile=page_%03d.png input.pdf
+% \end{verbatim}
+The option  \texttt{-dTextAlphaBits=4} improves font
+antialiasing.\footnote{Details can be found in the documentation of gs
   \url{https://www.ghostscript.com/doc/current/Use.htm}}
 
 \textbf{Details on step 2 --- Import \texttt{.png} images:}
 
 Open an empty presentation with LibreOffice Impress, adjust the appropriate
-slide format (e.\,g. 4:3), import the first \texttt{.png} file with
-\emph{Insert~/ Image}, then adjust the size of the included image with
-\emph{Format~/ Object~and~Shape~/ Position~and~Size (F4)} in the
-\emph{Position~and~Size} dialog box please enter: \emph{Postion~X}:
-\texttt{0.0cm}, \emph{Postion~Y}: \texttt{0.0cm}, \emph{Width}:
-\texttt{28.0cm}, activate the checkbox \emph{Keep~ratio}.\footnote{Menu
-  structure of LibreOffice v6.3}. The presentation can now be saved
-in one of the Microsoft Powerpoint formats \texttt{.ppt} or \texttt{.pptx}.
+slide format (e.\,g. 4:3), import the \texttt{.png} files with
+\emph{Insert~/ Image}
+% , then adjust the size of the included image with
+% \emph{Format~/ Object~and~Shape~/ Position~and~Size (F4)} in the
+% \emph{Position~and~Size} dialog box please enter: \emph{Postion~X}:
+% \texttt{0.0cm}, \emph{Postion~Y}: \texttt{0.0cm}, \emph{Width}:
+% \texttt{28.0cm}, activate the checkbox \emph{Keep~ratio}
+into consecutive empty slides.\footnote{Menu
+  structure of LibreOffice v6.4}. The presentation can now be saved
+in the format of Impresss (\texttt{.odp}) or
+one of the Microsoft Powerpoint formats (\texttt{.ppt} or \texttt{.pptx}).
+
+
+\subsection{The \texttt{pdfpc}-viewer: add notes}
+
+\index{pdfpc viewer@\texttt{pdfpc} viewer}
+\index{notes for slides, pdfpc viewer@notes for slides, \texttt{pdfpc} viewer}
+The pdf-vierwer \texttt{pdfpc} for
+Linux\footnote{\url{https://pdfpc.github.io/}}
+(see section \ref{sec:MultimediaContent})
+is a comfortable program which
+allows output of presentations to two monitors or a monitor and a
+beamer/projector.  The normal presentation window is assigned to the
+beamer/projector, the other output for the presenter shows the actual slide,
+the next slide and an area for notes. As you are viewing a certain slide,
+press \texttt{n} to start editing a note. The editing mode is stopped with
+\texttt{Esc}.  The text of these notes is stored in the file
+\texttt{filename.pdfpc}.  Further information can be found in the \texttt{man}
+page. 
+
 
 \section{License}
 
@@ -1061,12 +1343,14 @@ This class is distributed under the \textsl{\LaTeX{} Project Public License}
 \url{http://www.latex-project.org/lppl.txt}. No warranty is provided for this
 work (as stated in the LPPL).
 
+
+
 \section{Version history}
 
 \textbf{v0.1} (19.6.2004):  initial version.
 \textbf{v0.2} (1.9.2004): page numbers now changed to footnotesize, left and
-right margins slightly changed, `cenumerate' and `cdescription' environments
-added.
+right margins slightly changed, \texttt{cenumerate} and
+\texttt{cdescription} environments added.
 \textbf{v0.2a} (19.9.2004): Section ``License'' added to the documentation.
 \textbf{v0.2b} (17.10.2004): Documentation completed: description of the
 \verb+\distance{}+ command included.
@@ -1105,7 +1389,11 @@ Documentation has been significantly
 completed: sections \ref{sec:footerlayout},
 \ref{sec:use-colors}, \ref{sec:pres-scheme} and \ref{sec:elpres-recipes} added,
 section \ref{sec:installation} on installation rewritten.
+\textbf{v0.7} (20.02.2021): 
+parts of the manual (this file) have been rewritten and an index
+has been included. The command \verb+\pagenrconst+ has been added.
 
+\printindex
 
 \end{document}
 
-- 
cgit v1.2.3

