From 9df6e561410b27b99ab5bccf59ca4e98056f62b5 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 13 Oct 2010 23:31:13 +0000 Subject: present 1.0 (13oct10) git-svn-id: svn://tug.org/texlive/trunk@20080 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/plain/present/HowToTalkTeX.pdf | Bin 898215 -> 1158986 bytes .../texmf-dist/doc/plain/present/HowToTalkTeX.tex | 133 +++++++++++++-------- Master/texmf-dist/doc/plain/present/README | 20 +++- Master/texmf-dist/doc/plain/present/background.png | Bin 0 -> 201894 bytes Master/texmf-dist/tex/plain/present/present.tex | 66 +++++++--- 5 files changed, 150 insertions(+), 69 deletions(-) create mode 100644 Master/texmf-dist/doc/plain/present/background.png (limited to 'Master/texmf-dist') diff --git a/Master/texmf-dist/doc/plain/present/HowToTalkTeX.pdf b/Master/texmf-dist/doc/plain/present/HowToTalkTeX.pdf index ef01feca012..ee95501836a 100644 Binary files a/Master/texmf-dist/doc/plain/present/HowToTalkTeX.pdf and b/Master/texmf-dist/doc/plain/present/HowToTalkTeX.pdf differ diff --git a/Master/texmf-dist/doc/plain/present/HowToTalkTeX.tex b/Master/texmf-dist/doc/plain/present/HowToTalkTeX.tex index 6012ec92cf1..9714988d578 100644 --- a/Master/texmf-dist/doc/plain/present/HowToTalkTeX.tex +++ b/Master/texmf-dist/doc/plain/present/HowToTalkTeX.tex @@ -1,22 +1,28 @@ % +% % HOW TO DO A TALK IN TeX % % Author: Matthias Meister -% Version 1.0, August 2010 +% Version 2.0, October 2010 % % This file is part of a work distributed under the LaTeX Project Public License % \input present % Load presentation specific macros - +\setcolour\textcolour +\setbgcolour\backgroundcolour +\overfullrule=0pt +%\WideAspect \vskip20mm plus 5mm minus 5mm \line{\pagelink{NextPage}{\hfil\titlefont How To Do A Talk In \TeX\hfil}} \vskip 5mm plus 2mm minus 1mm \line{\hfil\font\subtitlefont=cmssbx10 at 15pt\subtitlefont One Of Many Solutions\hfil} -\vskip 30mm plus 2mm minus 1mm +\vskip 5mm plus 2mm minus 1mm +\line{\hfil\linkbarfont Version 2.0\hfil} +\vskip 20mm plus 2mm minus 1mm \line{\hfil\normalfont Matthias Meister\hfil}\target{title} \vskip 5mm plus 2mm minus 1mm -\line{\hfil\normalfont Regensburg, August 2010\hfil} +\line{\hfil\normalfont Regensburg, October 2010\hfil} \NewSlide \pageno=1% Don't want to count the titlepage \normalfont @@ -28,31 +34,28 @@ \SlideFoot % "Activates" the footline, titlepage had an empty footline \vglue7mm \leftskip5mm -\item{$\bullet$}\textcolor{text}{Make it possible to prepare presentations in \TeX} +\item{$\bullet$}Make it possible to prepare presentations in \TeX \vskip3mm -\item{$\bullet$}\textcolor{text}{Without having to learn lots of extra syntax} +\item{$\bullet$}Without having to learn lots of extra syntax \vskip3mm -\item{$\bullet$}\textcolor{text}{By using simple macros that can easily be adapted to one's needs, maybe for each presentation prepared} +\item{$\bullet$}By using simple macros that can easily be adapted to one's needs, maybe for each presentation prepared \vskip3mm -\item{$\bullet$}\textcolor{text}{Without restricting the possibilities that \TeX\ offers} +\item{$\bullet$}Without restricting the possibilities that \TeX\ offers \NewSlide \SlideTitle{\hfil Requirements} -\definecolor{code}{rgb}{0.8,0.0,0.8} \font\cdfo=cmtt12 -\def\cf{\color{code}\cdfo} -\item{+} {\cf miniltx.tex} -\item{+} {\cf color.tex} -\item{+} {\cf color.sty} - -\leftskip=0pt -\vskip3mm -These files are available from \weblink{www.ctan.org}{www.ctan.org}. You might already have (some of) them. -\vskip3mm +\def\codecolour{0 0.0 1.0} +\def\cf{\setcolour\codecolour\cdfo} You need the program {\cf pdftex}, which probably is included in your \TeX-distribution. \vskip3mm -You also need a pdf-viewer with fullscreen display capabilities, e.g. {\cf xpdf}. +You need the file {\cf present.tex}, which is to be {\cf\char'134input} at the beginning of your source code. +\vskip3mm +You furthermore need a pdf-viewer with fullscreen display capabilities, e.g. {\cf xpdf}. +\vskip5pt +\att{Warning: Some pdf-viewers do not handle links in a document properly.} \vskip5pt -\att{Some pdf-viewers do not handle links in a document properly.} +Version 2.0 does no longer require the +files {\cf miniltx.tex}, {\cf color.tex}, {\cf color.sty}. %% %% %% @@ -99,13 +102,14 @@ pdf-file with {\cf pdftex}, for viewing it with a pdf-viewer. \SlideTitle{\hfil Fonts} {\cf present.tex} defines the following fonts:\vskip5pt {\openup2pt -\halign{#\hfil\kern10pt&#\hfil\kern10pt&#\hfil\cr +\halign{#\hfil\kern5pt&#\hfil\kern5pt&#\hfil\cr Font Command & Purpose & Default Value\cr {\cf\char'134 titlefont} & presentation title & {\cf cmssbx10 at 20pt}\cr {\cf\char'134 slidetitlefont} & title of a slide & {\cf cmssbx10}\cr {\cf\char'134 normalfont} & ordinary text & {\cf cmss12}\cr {\cf\char'134 linkbarfont} & text in {\cf\char'134 LinkBar} & {\cf cmss8}\cr {\cf\char'134 it} & italic text & {\cf cmti12}\cr +{\cf\char'134 rm} & roman text in math & {\cf cmr}\cr }} \vskip10pt Of course you can define further font commands or redefine the existing ones. @@ -115,47 +119,54 @@ The default fonts are used in this presentation, so you see what they look like. %%% %%% \SlideTitle{\hfil Colours} -Colour effects are handled by the {\cf color.sty}-package included via {\cf color.tex}. - -The following colours are -defined in {\cf present.tex}: +Colours are defined as control sequences, e.g. \vskip5pt -{\cf background}, for the slide background +{\cf\char'134def\char'134mycolour\char'173}{\it R G B\/}{\cf\char'175} \vskip5pt -{\cf text}, for the text, and +where {\it R G B} are the red, green, and blue values of the colour defined, with +$0\leq R, G, B\leq 1$. \vskip5pt -{\cf attention}, an \att{attention} colour. +Colours are used in these ways: \vskip5pt -Colour names can be defined and redefined by +{\cf\char'134setcolour\char'134mycolour} + +to set the colour of following text , grouping is respected \vskip5pt -{\cf\char'134 definecolor\char'173}{\it NAME\/}{\cf\char'175\char'173 rgb\char'175\char'173}{\it R,G,B\/}% -{\cf\char'175} +{\cf\char'134coloured\char'134mycolour\char'173}{\it Stuff\/}{\cf\char'175} + +to set {\it Stuff} in colour {\cf\char'134mycolour} \vskip5pt -where {\it NAME} is a colour name to be defined, like {\cf background} or {\cf mycolour}, and {\it R}, -{\it G}, and {\it B} are -the red, green, and blue values describing the colour; $0\leq\hbox{ {\it R}, {\it G}, {\it B} }\leq 1$. +{\cf\char'134setbgcolour\char'134mycolour} + +to set the colour of the background \NewSlide %%% %%% %%% -Once defined, the colours are employed as follows: -\vskip3pt -{\cf\char'134 pagecolor\char'173 background\char'175} sets the colour of the slide background to {\cf background}. -\vskip3pt -{\cf\char'134 color\char'173 text\char'175} sets the colour of subsequent text to {\cf text}. -\vskip3pt -{\cf\char'134 textcolor\char'173 text\char'175\char'173}{\it Stuff\/}{\cf\char'175} prints {\it Stuff} -in colour {\cf text}. +The following colours are +defined in {\cf present.tex}: +\vskip5pt +{\cf \char'134backgroundcolour}, for the slide background +\vskip5pt +{\cf \char'134textcolour}, for the text, and +\vskip5pt +{\cf \char'134attentioncolour}, an \att{attention} colour. + +You draw attention to \att{Stuff} by saying +{\cf\char'134att\char'173}{\it Stuff\/}{\cf\char'175}. +\vskip5pt +If a predefined colour is redefined, {\cf\char'134setcolour} +must also be used for the change to take effect for text. \vskip5pt -The colour {\cf attention} is mainly used in the macro {\cf\char'134 att}, which prints -\att{Stuff} in attention colour by saying -{\cf\char'134 att\char'173}{\it Stuff\/}{\cf \char'175}. +Colour handling is different from version 1.0 of {\cf present.tex}. +The additional files {\cf miniltx.tex}, {\cf color.tex}, {\cf color.sty} are \att{no longer} required. \NewSlide %%% %%% %%% \SlideTitle{\hfil Paper Size} -The paper size is determined by the parameters {\cf\char'134 pdfpagewidth} and +The paper size is determined by the dimensions +\vskip3pt {\cf\char'134 pdfpagewidth} and {\cf\char'134 pdfpageheight}. \vskip10pt If you say {\cf\char'134 StandardAspect}, you get a page 120mm wide and 90mm high. @@ -165,7 +176,7 @@ If you say {\cf\char'134 WideAspect}, you get a page 144mm wide and 90mm high. %%% %%% %%% -\SlideTitle{\hfil Images} +\SlideTitle{\vbox to 0pt{\kern-5mm\image[width10mm]{Stern.png}\vss}\hfil Images} Images can be included with \vskip5pt {\cf\char'134 image[}{\it dimensions}{\cf]\char'173}{\it filename}{\cf\char'175} @@ -191,7 +202,6 @@ E.g. pdf, png, jpg should work. %%% %%% %%% -\pagecolor{background} \SlideTitle{\hfil Slide Structure} Each slide has a headline, a body, and a footline. \vskip5pt @@ -264,7 +274,7 @@ if a slide is to be shown incrementally.} the presentation where it is used. \vskip5pt {\cf\char'134 link\char'173}{\it NAME\/}{\cf\char'175\char'173}{\it Stuff\/}{\cf\char'175} -makes {\it Stuff} a link to the target named {\it NAME}. +turns {\it Stuff} into a link to the target named {\it NAME}. \vskip5pt {\cf\char'134 weblink\char'173}{\it URI\/}{\cf\char'175\char'173}{\it Stuff\/}{\cf\char'175} makes {\it Stuff} a link to the specified {\it URI}. @@ -285,10 +295,10 @@ A further possibility can be found \link{Further}{here (click)}. %%% %%% {\cf\char'134 linkarea\char'173}{\it dest}{\cf\char'175\char'173}{\it rect}{\cf\char'175\char'173}{\it border}{\cf -\char'175\char'173}{\it color}{\cf\char'175}\target{Further} +\char'175\char'173}{\it colour}{\cf\char'175}\target{Further} \vskip5pt Creates a rectangular area which is a link to target {\it dest}; {\it rect} consists of -four space-separated numbers for lower left and upper right corner, {\it border} is the border width, and {\it color} is the +four space-separated numbers for lower left and upper right corner, {\it border} is the border width, and {\it colour} is the border colour, specified as three space-separated values for red, green, and blue, all between 0 and 1. \vskip5pt \linkarea{title}{150 30 180 60}{2}{0.8 0 0} @@ -300,9 +310,28 @@ Notice also that {\cf\char'134 LinkBar} has been redefined (on the previous slid %%% %%% %%% +\SlideTitle{\hfil Background Images} +\SetBackground{background.png} +You can set images for the background with +\vskip5pt +{\cf\char'134 SetBackground\char'173}{\it filename}{\cf\char'175} +\vskip5pt +where +{\it filename} is the name of the image file. +\vskip5pt +The background image is unset (i.e. the background colour will show again) with {\cf\char'134 UnsetBackground}. +\vskip5pt +The background image is scaled to width and height of the slide. It should have an appropriate aspect ratio. +\vskip5pt +\att{As you see some combinations of text colour and background image can cause visibility problems.} +\NewSlide +\UnsetBackground +%%% +%%% +%%% \SlideTitle{\hfil Concluding Remarks} PDF provides the possibility to include movies, and to launch applications (which could be a movie player) via clickable -elements. The usability for a presentation depends on how to manage the player together with a full-screen display of the +elements. The usability for a presentation depends on how to manage the player together with a fullscreen display of the slides. Movie support is not officially included in {\cf present.tex}. \vskip5pt If you prepare a pdf-image for a presentation which is to be shown on some different computer, it would be best to diff --git a/Master/texmf-dist/doc/plain/present/README b/Master/texmf-dist/doc/plain/present/README index 62e6f654ae3..b57fce78260 100644 --- a/Master/texmf-dist/doc/plain/present/README +++ b/Master/texmf-dist/doc/plain/present/README @@ -1,5 +1,5 @@ present.tex -Version 1.0, August 2010 +Version 2.0, October 2010 Some simple macros for preparing presentations in TeX Copyright 2010 Matthias Meister @@ -15,14 +15,15 @@ HowToTalkTeX.tex is the corresponding source; together with the pdf it is an example of how the macros are used to prepare a talk. -Required: miniltx.tex, color.tex, color.sty, pdftex +Required: pdftex The macros in present.tex allow the user to: +) set a colour for the background and for the text -+) include images ++) set background images +) include links between parts of the presentation +) include weblinks +) include links to local files ++) include images The macros as such are simple enough so that users should not find it difficult to adapt them to their needs. @@ -30,3 +31,16 @@ not find it difficult to adapt them to their needs. A documentation for pdftex and the PDF-Reference might occasionally be useful in the context of those macros which have PDF-code in their replacement text. + +----------------------- + +Changes with respect to version 1.0: + +*) An image can be set on the slide background. +*) Added control word \rm for using roman type + at correct size within math. +*) Rewritten colour support; miniltx.tex, color.tex, + color.sty no longer required. As a result, control + sequences for handling colour have changed. + + diff --git a/Master/texmf-dist/doc/plain/present/background.png b/Master/texmf-dist/doc/plain/present/background.png new file mode 100644 index 00000000000..d78f8b107c3 Binary files /dev/null and b/Master/texmf-dist/doc/plain/present/background.png differ diff --git a/Master/texmf-dist/tex/plain/present/present.tex b/Master/texmf-dist/tex/plain/present/present.tex index be5f7210e0c..4f2e9e0626b 100644 --- a/Master/texmf-dist/tex/plain/present/present.tex +++ b/Master/texmf-dist/tex/plain/present/present.tex @@ -2,7 +2,7 @@ % % present.tex % Some macros for preparing presentations in TeX, using pdftex -% Version 1.0 +% Version 2.0 % Copyright 2010 Matthias Meister % % This work may be distributed and/or modified under the @@ -32,13 +32,13 @@ % therefore should remain unchanged, too) % % With reference to the definitions in the LaTeX Project Public License, for the -% purposes of this work a 'Base Interpreter' is a program implemeting the TeX +% purposes of this work a 'Base Interpreter' is a program implementing the TeX % language. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\input color % We would like colour on the screen - % color.sty and miniltx required (see www.ctan.org) +\catcode`\@=11 + \parindent0pt % Indentation probably not good for presentation \parskip0pt % Neither is automatic extra space between paragraphs @@ -103,7 +103,6 @@ % % Definitions to allow referencing the last page of a document % -\catcode`\@=11 \newwrite\wl@stpage \newread\rl@stpage \def\bye{% @@ -118,20 +117,36 @@ \openin\rl@stpage=\jobname.lp \ifeof\rl@stpage\closein\rl@stpage\message{RUN AGAIN to get correct number of last page!} \else\read\rl@stpage to \LP\fi -\catcode`\@=12 % % Define some colours % -\definecolor{background}{rgb}{0.6,0.6,1.0} % Define some colour names -\definecolor{text}{rgb}{0.0,0.0,0.8} % -\definecolor{attention}{rgb}{1,0,0} % - % and use them to -\pagecolor{background} % set the color of the background -\color{text} % and of ordinary text +% The commands below handle colour without color.tex, directly with pdftex +% Added October 3rd, 2010 + +% Define colours +\def\backgroundcolour{0.8 0.8 0.8} % Colour of page background +\def\textcolour{0.0 0.0 0.0} % Colour of text +\def\attentioncolour{1 0 0} % Colour for "Attention" + +\newdimen\vsh@ft % vertical shift for background image, vsh@ft+\voffset=-25.4mm +\newdimen\hsh@ft % horizontal shift for background image, hsh@ft+\hoffset=-25.4mm +\vsh@ft=-13mm +\hsh@ft=-5mm + +\newcount\colst@ck +\colst@ck=\pdfcolorstackinit page {\textcolour rg \textcolour RG} +\def\popst@ck{\pdfcolorstack\colst@ck pop} +\def\setcolour#1{\pdfcolorstack\colst@ck push {#1 rg #1 RG}\aftergroup\popst@ck} +\long\def\coloured#1#2{{\setcolour#1#2}} +\long\def\att#1{\coloured\attentioncolour{#1}} +\def\bgc@lset{\relax} +\def\setbgcolour#1{\def\bgc@lset{\begingroup\pdfcolorstack\colst@ck push {#1 rg #1 RG}\aftergroup\popst@ck +\vbox to 0pt{\kern\vsh@ft\hbox to 0pt{% +\kern\hsh@ft\vrule depth0pt height\pdfpageheight width\pdfpagewidth\hss}\vss} +\nointerlineskip +\endgroup}} -\def\att#1{\textcolor{attention}{#1}} % Macro for printing #1 in "attention" colour for - % emphasis \def\NewSlide{\vfill\eject} % Begin a new slide; slide number increases @@ -238,4 +253,27 @@ attr {/Border [0 0 0]} user {/Subtype /Link /A <>}% \footline{} % Set some \StandardAspect % defaultvalues +% +% Added 28. August 2010. Not part of version 1.0 +% +% Setting / unsetting a background image. If no background image is used, the background shows background colour +% +\def\h@lpr{\relax} +\def\BIM@G{\relax} +\def\SetBackground#1{\def\BIM@G{#1}} +\def\UnsetBackground{\def\BIM@G{\relax}} +\output{% +\shipout\vbox{% +\bgc@lset +\ifx\BIM@G\h@lpr \else +{\vbox to 0pt{\kern\vsh@ft\hbox to 0pt{\kern\hsh@ft\image[width\pdfpagewidth height\pdfpageheight]{\BIM@G}\hss}\vss}% +\nointerlineskip}\fi +\makeheadline +\pagebody +\makefootline} +\advancepageno +\ifnum\outputpenalty>-20000\else\dosupereject\fi} +\def\rm{\fam=0} %% Added 14. September 2010. Use roman font in math. + +\catcode`\@=12 -- cgit v1.2.3