From f35565737733e319e7293a9fafe1b78e87f8a14e Mon Sep 17 00:00:00 2001 From: Norbert Preining 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