diff options
author | Karl Berry <karl@freefriends.org> | 2021-03-01 22:33:17 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2021-03-01 22:33:17 +0000 |
commit | 1a9973ac21867ce48a6366c4efb5da8ef3af95a7 (patch) | |
tree | bea18682ae9002025a70de27360f07e4bfffd3bc /Master/texmf-dist/doc/latex/elpres/elpres-manual.tex | |
parent | da764e6f9f0f5e222a9011bcf9156c4a1001e52d (diff) |
elpres (1mar21)
git-svn-id: svn://tug.org/texlive/trunk@58015 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/elpres/elpres-manual.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/elpres/elpres-manual.tex | 194 |
1 files changed, 108 insertions, 86 deletions
diff --git a/Master/texmf-dist/doc/latex/elpres/elpres-manual.tex b/Master/texmf-dist/doc/latex/elpres/elpres-manual.tex index 3a5a2d24b02..1e25345afaf 100644 --- a/Master/texmf-dist/doc/latex/elpres/elpres-manual.tex +++ b/Master/texmf-dist/doc/latex/elpres/elpres-manual.tex @@ -17,33 +17,16 @@ \usepackage{luaotfload} \usepackage{fontspec} -\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 (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}}}} +% \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[% @@ -53,11 +36,11 @@ SmallCapsFeatures={Numbers=OldStyle}]{NewCMMono10-Book.otf} \usepackage[nottoc]{tocbibind} -\title{\textsf{elpres} --- electronic presentations \\ with (pdf)\LaTeX} +\title{\textsf{elpres} --- electronic presentations \\ with (pdf/Lua)\LaTeX} \author{Volker Kiefel\thanks{volker dot kiefel at freenet dot de, \url{http://vkiefel.de/elpres.html}}} -\date{v0.7\\[1.8ex] - February 20, 2021% +\date{v0.8\\[1.8ex] + February 28, 2021% % --- \textcolor{DarkGreen}{update of this manual: % September 27, 2020} } @@ -88,6 +71,8 @@ SmallCapsFeatures={Numbers=OldStyle}]{NewCMMono10-Book.otf} \section{Introduction} +\label{sec:Introduction} + 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 @@ -136,18 +121,23 @@ which should preferrably be compiled with pdf\LaTeX\ or Lua\LaTeX. \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} -files should be copied -into a directory, where your \TeX-system can find it: -if an old \texttt{elpres} version of the existing \TeX\ system shall be -replaced by the current version, please copy these -into the appropriate position in the -``local'' \texttt{texmf} directory tree -(e.\,g. \verb+~/texmf-local/tex/latex/elpres+) and this manual -(\texttt{elpres-manual.pdf}) to \verb+~/texmf-local/doc/latex/elpres+. + \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 (or if the preinstalled \texttt{elpres} version + does not work properly\footnote{for details see the description on checking the + \texttt{elpres}-installation in section + \ref{sec:CheckInstallation}}), + \texttt{elpres.cls}, all \texttt{*.sty}, + \texttt{*.png} and \texttt{*.eps} files should be copied into a directory, + where the \TeX-system can find it: if an old \texttt{elpres} version of the + existing \TeX\ system shall be replaced by the current version, please copy + these into the appropriate position in the ``local'' \texttt{texmf} + directory tree (e.\,g. \verb+~/texmf/tex/latex/elpres+) and this manual + (\texttt{elpres-manual.pdf}) to \verb+~/texmf/doc/latex/elpres+, where + \texttt{~/texmf} may be \texttt{~/texmf-local} or an + analogous directory. + Then, the files database should be updated by entering (in case of a \TeX~Live installation) the command: @@ -160,7 +150,7 @@ installation) the command: or you may enter \verb+texhash ~/texmf-local+\footnote{The location for the ``local'', manually updated class and package files may be different, depending on the \TeX\ system and the OS.}. -Other \TeX-systems e.\,g.\ Mik\TeX\ have +Other \TeX-systems e.\,g.\ MiK\TeX\ have 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}'' @@ -216,8 +206,10 @@ the environments \texttt{psli} and \texttt{rsli} define ``slides'' in \subsection{A minimalistic example presentation} +\label{sec:MiniExample} -The following code may be used for your first ``experiments'' by adding +The following code (\texttt{minimal.tex}) +may be used for your first ``experiments'' by adding features described in later sections. \index{minimalistic example, presentation} @@ -269,6 +261,8 @@ features described in later sections. \end{verbatim} + + The preamble of the same presentation for Lua\LaTeX\ would read: \begin{verbatim} @@ -300,6 +294,30 @@ 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}. +\subsubsection*{Testing of the \texttt{elpres} installation} + +\label{sec:CheckInstallation} + +\begin{sloppypar} +With this example you may check, if \texttt{elpres} has been installed +correctly in your \TeX -system: copy the listing of \texttt{minimal.tex} into +a file and process it with \texttt{pdflatex}. The line +\verb+\usepackage{elpreswhitetealscheme}+ should not be commented out, +i.\,e. the package \texttt{elpreswhitetealscheme} should be active. +If processing of \texttt{minimal.tex} results in a message like +\end{sloppypar} + +\begin{verbatim} + ... `ep-ball-04' not found ... +\end{verbatim} + +the \TeX -system does not find the file \texttt{ep-ball-04.png} in the +appropriate place. In such a situation it is recommended to install the +current version of \texttt{elpres} in the correct subdirectories of +the ``local'' \texttt{texmf}-directory, details are described in section +\ref{sec:installation}. + + \subsection{Essential elements of an \texttt{elpres} presentation} @@ -1214,11 +1232,21 @@ Sometimes, it is desirable to generate a version of such a presentation without overlays effects, for example for preparation of a printed handout (see section \ref{secHandout}). The effect of these overlay-specific instuctions can be -inactivated with this series of commands: +inactivated with these commands: \end{sloppypar} \begin{verbatim} + \overlaysoff + \alertsoff +\end{verbatim} + +which should be written into the preamble following +\verb+\usepackage{overlays}+. This works with v2.12 (and probably later +versions) of \texttt{overlays}. With earlier versions you may copy the +commands + +\begin{verbatim} \renewenvironment{overlays}[1]{}{}% \renewenvironment{fragileoverlays}[1]{}{}% \renewcommand{\visible}[2]{#2}% @@ -1226,9 +1254,10 @@ inactivated with this series of commands: \renewcommand{\alert}[2]{#2}% \end{verbatim} -which should be copied or entered in the preamble following -\verb+\usepackage{overlays}+. - +into the preamble following \verb+\usepackage{overlays}+, however, +inactivation of \verb+\only+ by this method +has a different effect, so it is recommended to +update the \texttt{overlays} package. \subsection{Convert an \texttt{elpres}-presentation (PDF) into an Impress (LibreOffice) or Powerpoint presentation} \label{sec:convert-into-libreoff} @@ -1347,54 +1376,47 @@ 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, \texttt{cenumerate} and -\texttt{cdescription} environments added. +\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, +\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. -\textbf{v0.2c} (28.11.2004): Documentation completed (section -\ref{secHypertext} -added). -\textbf{v0.2d} (25.12.2004): Documentation completed (section -\ref{secBackgroundWallpaper} added). -\textbf{v0.2e} (15.04.2005): Documentation completed (sections -\ref{secBackgroundEsopic} and \ref{secHandout} added). -\textbf{v0.3} (12.08.2005): new (class) options for font selection: -\texttt{tmrfont} (Times Roman), \texttt{helvetfont} (Helvetica), -\texttt{cmfont} (Computer Modern), \texttt{sansfont} (Sans Serif: default). -Documentation updated, sections \ref{secInclGraphicsFiles} and -\ref{secTwoColumns} added. -\textbf{v0.4} (20.01.2018): New class options for different screen aspect -ratios \texttt{4x3}, \texttt{16x9}, \texttt{16x10}; ``compressed'' list -environments modified; documentation completed: -packages for use with \texttt{elpres}: \texttt{enumitem} (alternative list -environments), \texttt{overlays} (overlay support: incremental slides); -section \ref{secHandout} was completely rewritten. -\textbf{v0.4a} (24.01.2018): Documentation completed. -\textbf{v0.5} (12.07.2020): New class options: \texttt{nofonts} -(no font selection) and \texttt{navisymb} (inserts a panel of -symbols for navigation), new commands: \verb+auvimm+ (generates -a link to external audio, video files), \verb+\fromlinktext+ and -\verb+\totargettext+ (create links within a presentation). -Documentation has been partly rewritten. -\textbf{v0.6} (19.08.2020): -Access to the \texttt{fancyhdr} ``header fields'' (\verb+\lhead{}+, -\verb+\chead{}+ and \verb+\rhead{}+) is now explicitly blocked. -New command \verb+\slidetitlecolor{}+ for the text color of titles in -\texttt{psli}-slides. -New: style files for presentation schemes added. -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. +\verb+\distance{}+ command included. \textbf{v0.2c} (28.11.2004): +Documentation completed (section \ref{secHypertext} added). \textbf{v0.2d} +(25.12.2004): Documentation completed (section \ref{secBackgroundWallpaper} +added). \textbf{v0.2e} (15.04.2005): Documentation completed (sections +\ref{secBackgroundEsopic} and \ref{secHandout} added). \textbf{v0.3} +(12.08.2005): new (class) options for font selection: \texttt{tmrfont} (Times +Roman), \texttt{helvetfont} (Helvetica), \texttt{cmfont} (Computer Modern), +\texttt{sansfont} (Sans Serif: default). Documentation updated, sections +\ref{secInclGraphicsFiles} and \ref{secTwoColumns} added. \textbf{v0.4} +(20.01.2018): New class options for different screen aspect ratios +\texttt{4x3}, \texttt{16x9}, \texttt{16x10}; ``compressed'' list environments +modified; documentation completed: packages for use with \texttt{elpres}: +\texttt{enumitem} (alternative list environments), \texttt{overlays} (overlay +support: incremental slides); section \ref{secHandout} was completely +rewritten. \textbf{v0.4a} (24.01.2018): Documentation completed. +\textbf{v0.5} (12.07.2020): New class options: \texttt{nofonts} (no font +selection) and \texttt{navisymb} (inserts a panel of symbols for navigation), +new commands: \verb+auvimm+ (generates a link to external audio, video files), +\verb+\fromlinktext+ and \verb+\totargettext+ (create links within a +presentation). Documentation has been partly rewritten. \textbf{v0.6} +(19.08.2020): Access to the \texttt{fancyhdr} ``header fields'' +(\verb+\lhead{}+, \verb+\chead{}+ and \verb+\rhead{}+) is now explicitly +blocked. New command \verb+\slidetitlecolor{}+ for the text color of titles +in \texttt{psli}-slides. New: style files for presentation schemes added. +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. \textbf{v0.8} (28.02.2021): Installation instructions have +been updated in section \ref{sec:Introduction} and detailed instructions were +added to \texttt{README.md}. Section \ref{sec:inact-overl-comm} was updated. A +bug in the \texttt{elpres...scheme.sty} files was fixed (incorrect value for +\verb+\labelitemiv+). \printindex \end{document} - |