summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/elpres
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2021-02-21 03:01:41 +0000
committerNorbert Preining <norbert@preining.info>2021-02-21 03:01:41 +0000
commitf35565737733e319e7293a9fafe1b78e87f8a14e (patch)
tree197b08b39b09262f4e71486f610106580871631d /macros/latex/contrib/elpres
parentb94dba90d83866ccb6db5273d214512e859c3179 (diff)
CTAN sync 202102210301
Diffstat (limited to 'macros/latex/contrib/elpres')
-rw-r--r--macros/latex/contrib/elpres/README.md13
-rw-r--r--macros/latex/contrib/elpres/ctan-lion.png (renamed from macros/latex/contrib/elpres/bitmaps/ctan-lion.png)bin81950 -> 81950 bytes
-rw-r--r--macros/latex/contrib/elpres/elpres-manual.pdfbin139563 -> 133448 bytes
-rw-r--r--macros/latex/contrib/elpres/elpres-manual.tex474
-rw-r--r--macros/latex/contrib/elpres/elpres.cls7
-rw-r--r--macros/latex/contrib/elpres/ep-ball-01.eps (renamed from macros/latex/contrib/elpres/bitmaps/ep-ball-01.eps)0
-rw-r--r--macros/latex/contrib/elpres/ep-ball-01.png (renamed from macros/latex/contrib/elpres/bitmaps/ep-ball-01.png)bin7561 -> 7561 bytes
-rw-r--r--macros/latex/contrib/elpres/ep-ball-02.eps (renamed from macros/latex/contrib/elpres/bitmaps/ep-ball-02.eps)0
-rw-r--r--macros/latex/contrib/elpres/ep-ball-02.png (renamed from macros/latex/contrib/elpres/bitmaps/ep-ball-02.png)bin6705 -> 6705 bytes
-rw-r--r--macros/latex/contrib/elpres/ep-ball-03.eps (renamed from macros/latex/contrib/elpres/bitmaps/ep-ball-03.eps)0
-rw-r--r--macros/latex/contrib/elpres/ep-ball-03.png (renamed from macros/latex/contrib/elpres/bitmaps/ep-ball-03.png)bin5084 -> 5084 bytes
-rw-r--r--macros/latex/contrib/elpres/ep-ball-04.eps (renamed from macros/latex/contrib/elpres/bitmaps/ep-ball-04.eps)0
-rw-r--r--macros/latex/contrib/elpres/ep-ball-04.png (renamed from macros/latex/contrib/elpres/bitmaps/ep-ball-04.png)bin6581 -> 6581 bytes
-rw-r--r--macros/latex/contrib/elpres/ep-ball-05.eps (renamed from macros/latex/contrib/elpres/bitmaps/ep-ball-05.eps)0
-rw-r--r--macros/latex/contrib/elpres/ep-ball-05.png (renamed from macros/latex/contrib/elpres/bitmaps/ep-ball-05.png)bin6883 -> 6883 bytes
15 files changed, 391 insertions, 103 deletions
diff --git a/macros/latex/contrib/elpres/README.md b/macros/latex/contrib/elpres/README.md
index d2eef2239a..36b5aa01cc 100644
--- a/macros/latex/contrib/elpres/README.md
+++ b/macros/latex/contrib/elpres/README.md
@@ -1,4 +1,4 @@
-Elpres v0.6 2020-08-19
+Elpres v0.7 2021-02-20
Short description
=================
@@ -19,16 +19,11 @@ tcolorbox and footmisc are useful.
A homepage for the elpres project: http://vkiefel.de/elpres.html with
additional material.
-Changes in v0.6
+Changes in v0.7
===============
-* New: presentation schemes added as style (.sty) files: they define colors
- and design of list environments
-* New command \slidetitlecolor{}
-* Large parts of the manual rewritten
-* New "recipes" for use of presentations included in the manual: printing of
- handout documents, colored text boxes, printing of presentations with
- overlays
+* New command `\pagenrconst`
+* Parts of the manual rewritten
License
=======
diff --git a/macros/latex/contrib/elpres/bitmaps/ctan-lion.png b/macros/latex/contrib/elpres/ctan-lion.png
index c24d9a98f2..c24d9a98f2 100644
--- a/macros/latex/contrib/elpres/bitmaps/ctan-lion.png
+++ b/macros/latex/contrib/elpres/ctan-lion.png
Binary files differ
diff --git a/macros/latex/contrib/elpres/elpres-manual.pdf b/macros/latex/contrib/elpres/elpres-manual.pdf
index 64f164ed7e..51859b5301 100644
--- a/macros/latex/contrib/elpres/elpres-manual.pdf
+++ b/macros/latex/contrib/elpres/elpres-manual.pdf
Binary files differ
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}
diff --git a/macros/latex/contrib/elpres/elpres.cls b/macros/latex/contrib/elpres/elpres.cls
index f5334dd234..4775670f9f 100644
--- a/macros/latex/contrib/elpres/elpres.cls
+++ b/macros/latex/contrib/elpres/elpres.cls
@@ -1,5 +1,5 @@
\NeedsTeXFormat{LaTeX2e}
-\ProvidesClass{elpres}[2020/08/15 class for plain electronic presentations]
+\ProvidesClass{elpres}[2021/02/20 class for plain electronic presentations]
%
% 2004/06/19 v0.1 - initial version
%
@@ -27,6 +27,9 @@
% 2020/08/15 v0.6 - command `slidetitlecolor' added, color scheme files
% added, most parts of the documentation rewritten
%
+% 2021/02/20 v0.7 - command `pagenrconst' added, parts of the documentation
+% (manual) rewritten
+%
% Options: select fonts
\newcommand{\fontna}{initialisiert}
@@ -216,6 +219,8 @@
\newcommand{\fromlinktext}[2]{\hyperlink{#2}{#1}}
\newcommand{\totargettext}[2]{\hypertarget{#2}{#1}}
+\newcommand{\pagenrconst}{\addtocounter{page}{-1}}
+
%% (External): Default colors for defined slide elements, the are modified in
%% style files -- these color names may be used by authors of presentations
diff --git a/macros/latex/contrib/elpres/bitmaps/ep-ball-01.eps b/macros/latex/contrib/elpres/ep-ball-01.eps
index 470e60d831..470e60d831 100644
--- a/macros/latex/contrib/elpres/bitmaps/ep-ball-01.eps
+++ b/macros/latex/contrib/elpres/ep-ball-01.eps
diff --git a/macros/latex/contrib/elpres/bitmaps/ep-ball-01.png b/macros/latex/contrib/elpres/ep-ball-01.png
index a5d924cc66..a5d924cc66 100644
--- a/macros/latex/contrib/elpres/bitmaps/ep-ball-01.png
+++ b/macros/latex/contrib/elpres/ep-ball-01.png
Binary files differ
diff --git a/macros/latex/contrib/elpres/bitmaps/ep-ball-02.eps b/macros/latex/contrib/elpres/ep-ball-02.eps
index 4e303e38fa..4e303e38fa 100644
--- a/macros/latex/contrib/elpres/bitmaps/ep-ball-02.eps
+++ b/macros/latex/contrib/elpres/ep-ball-02.eps
diff --git a/macros/latex/contrib/elpres/bitmaps/ep-ball-02.png b/macros/latex/contrib/elpres/ep-ball-02.png
index 12eb6d5d29..12eb6d5d29 100644
--- a/macros/latex/contrib/elpres/bitmaps/ep-ball-02.png
+++ b/macros/latex/contrib/elpres/ep-ball-02.png
Binary files differ
diff --git a/macros/latex/contrib/elpres/bitmaps/ep-ball-03.eps b/macros/latex/contrib/elpres/ep-ball-03.eps
index 1ef7966faf..1ef7966faf 100644
--- a/macros/latex/contrib/elpres/bitmaps/ep-ball-03.eps
+++ b/macros/latex/contrib/elpres/ep-ball-03.eps
diff --git a/macros/latex/contrib/elpres/bitmaps/ep-ball-03.png b/macros/latex/contrib/elpres/ep-ball-03.png
index eaa48a44d2..eaa48a44d2 100644
--- a/macros/latex/contrib/elpres/bitmaps/ep-ball-03.png
+++ b/macros/latex/contrib/elpres/ep-ball-03.png
Binary files differ
diff --git a/macros/latex/contrib/elpres/bitmaps/ep-ball-04.eps b/macros/latex/contrib/elpres/ep-ball-04.eps
index 1ce6d1746e..1ce6d1746e 100644
--- a/macros/latex/contrib/elpres/bitmaps/ep-ball-04.eps
+++ b/macros/latex/contrib/elpres/ep-ball-04.eps
diff --git a/macros/latex/contrib/elpres/bitmaps/ep-ball-04.png b/macros/latex/contrib/elpres/ep-ball-04.png
index aa523a121e..aa523a121e 100644
--- a/macros/latex/contrib/elpres/bitmaps/ep-ball-04.png
+++ b/macros/latex/contrib/elpres/ep-ball-04.png
Binary files differ
diff --git a/macros/latex/contrib/elpres/bitmaps/ep-ball-05.eps b/macros/latex/contrib/elpres/ep-ball-05.eps
index f2a90d8e30..f2a90d8e30 100644
--- a/macros/latex/contrib/elpres/bitmaps/ep-ball-05.eps
+++ b/macros/latex/contrib/elpres/ep-ball-05.eps
diff --git a/macros/latex/contrib/elpres/bitmaps/ep-ball-05.png b/macros/latex/contrib/elpres/ep-ball-05.png
index e499046da7..e499046da7 100644
--- a/macros/latex/contrib/elpres/bitmaps/ep-ball-05.png
+++ b/macros/latex/contrib/elpres/ep-ball-05.png
Binary files differ