MakingslidesinLATEXwithProsperFr - PDF document

MakingslidesinLATEXwithProsperFr´ed´ericGoualardPeterMøllerNeergaardIRIN,Universit´edeNantesBostonUniversityNantes,FranceBoston,USAAbstractTheprosperclasspermitsproducinghighqualityslides;itisalsoeasilyextendable.Thisdocumentationismeanttobeausermanualaswellasatechnicalnotedescribinghowtocreateyourownstyles.1UsingtheclassLATEXlesusingtheprosperclassmaybeeventuallytranslatedintotwodifferentformats:•theAdobe®PostScriptTMformatforprintingtransparencies;•theAdobe®PortableDocumentFormat(PDF)fordisplayingslidesoncomputerswithAcrobat®Readerinfull-screenmode.WhentranslatedintoPDFles,prosperslidesbenetfromadditionalpossibil-itiessuchastransitioneffectsbetweenslidesandincrementaldisplayofaslidewithseveralanimationeffects.Thecurrentlysupportedtransitionsare:•Split:twolinessweepacrossthescreenrevealingthenewslide;•Blinds:multiplelines,evenlydistributedacrossthescreen,appearandsyn-chronouslysweepinthesamedirectiontorevealthenewslide;•Box:aboxsweepsfromthecenter,revealingthenewslide;•Wipe:asinglelinesweepsacrossthescreenfromoneedgetotheother,reveal-ingthenewslide;•Dissolve:theoldpageimagedissolvestorevealthenewslide;•Glitter:similartoDissolve,excepttheeffectsweepsacrosstheimageinawidebandmovingfromonesideofthescreentotheother;•Replace:theeffectissimplytoreplacetheoldpagewiththenewpage.Figure1presentsabird's-eyeviewofthestructureofaLATEXleusingtheprosperclass.1 2OptionsoftheclassTheprosperclasssupportsthefollowingoptions(defaultoptionsareprecededbyablacktriangleI,whiletheothersareprecededbyablacksquare):\end{slide}Material for the slide\begin{slide}[transition]{slide title}LegendMandatory or default choice\maketitleAffiliation\begin{document}subtitle...Title of the presentationOptions\documentclass[ ]{prosper}Names of the authors\author{ }caption text\slideCaption{ }Options:finalslideBWslideColorpspdf\end{document}\end{slide}Material for the slide\begin{slide}[transition]{slide title}\subtitle{ }n\overlays{ }{accumulatenoaccumulatedistillerFigure1:StructureofaLATEXleusingprosperdraft.Theleiscompiledindraftmode:guresarereplacedbyboundingboxes;thecaptionatthebottomofeveryslidedisplaysthedateandtimeofthecompil-ingtogetherwiththelename;Ifinal.Theleiscompiledinnalmode:guresareinsertedattheirposition;thecaptiononeveryslidecontainsthetextgiven(optionally)bytheuserwiththemacro\slideCaption,exceptifthemacro\displayVersionappearsinthepreamble(inthatcase,thesamecaptionasinthedraftmodeisused);IslideColor.Slideswillusemanycolors.Tobeusedwithcautionwhentheslidesaretobeprintedonablack&whitedevice;slideBW.Slideswillusearestrictedsetofcolors.Shouldbeusedwheneverthepresentationismeanttobeprintedinblack&white;2 total.Thecaptionatthebottomofeveryslidedisplaysthenumberofthecurrentslidealongwiththetotalnumberofslides;Inototal.Onlythenumberofthecurrentslideappearsinthecaption;nocolorBG.Thebackgroundoftheslideiswhitewhateverthestylemaybe.Itisagoodideatousethisoptionforprintingslidesinblack&white;IcolorBG.Thecolorofthebackgrounddependsonthecurrentstyle;ps.TheLATEXleiscompiledtoproduceaPostScriptTMleforprinting;Ipdf.TheLATEXleiscompiledtoproduceaPDFleforapresentationwithavideoprojector;accumulate.Macros\onlySlide,\untilSlideand\fromSlideinter-prettheirargumentinpsmode.Notethatitispossibletolocallymodifytheop-tionsettingbyusingmacrosnAccumulatetrueandnAccumulatefalse;Inoaccumulate.Macros\onlySlide,\untilSlideand\fromSlidedonotinterprettheirargumentinpsmode;distiller.ThePostScript®leistobetranslatedintoaPDFleusingAdobe®Distiller;YandY.TheLATEXleistobeprocessedwithYandYLATEX;Ips2pdf.ThePostScript®leistobetranslatedintoaPDFleusingAFPLps2pdf;vtex.TheLATEXleistobeprocessedwithMicroPressVisualTEX;noFooter.Donotaddanycaptionatthebottomoftheslides.3Predenedmacrosandenvironments3.1MacrostoappearinthepreambleTheprosperclass(re-)denessomestandardmacros.Thosegivenhereunderaretobeputinthepreamble(thatis,before\begin{document}):ntitle.Titleofthepresentation;nsubtitle.Subtitleofthepresentation;nauthor.Author(s)ofthepresentation;nemail.E-mailaddressoftheauthor(s);ninstitution.Nameoftheinstitute/companytheauthor(s)come(s)from;3 nslideCaptionfcg.Captiontobeputatthebottomofeveryslide(nameoftheevent/conference...).Thetitleofthepresentationisusedasthedefaultcaptionwhenevertheauthordonotoverrideitbyprovidinghisowncaptionbyusingthismacro;nLogo(x,y)fmylogogornLogofmylogog.Thelogogivenbymylogowillbeputattheposition(x,y)oneachslide(resp.atadefaultpositiondenedbyeachslidestyle).Thereferencepointisbottomleft.Anexampleofuseis:\Logo(2,5){\includegraphics[width=1cm]{irinLOGO.eps}})ndisplayVersion.Displaysadraftcaption(withthenameofthele,thetitleofthepresentation,thenameoftheauthor(s),andthedate/timeofthelastLATEXcompiling)insteadofthecaptiondenedbytheuserevenwheninnalmode;nDefaultTransitionftransg:denitionofthedefaulttransitionmodebe-tweenslides.Bydefault,theReplacemodeisused;nNoFrenchBabelItemize.Tobeusedwhenloadingthebabelstylewiththe“french”optioninordertohavetheabilitytochooseonesownitems.Thefrenchitemizeglueispreserved;ncollapsedBookmarksfalse.Sincev.2.0,alloverlayshaveabookmark.Ifyoucallthismacrointhepreamble,thetreeofbookmarksisexpanded,otherwiseitiscollapsedandonlythebookmarksfortherstslideofeachoverlayarevisible.3.2TheslideenvironmentFigure1describestheslideenvironment.Anoptionalargumentisthetransitioneffectfordisplayingtheslide.ThedefaulttransitionisR(Replace).3.3SomeitemizeenvironmentsTheItemizeenvironmentcorrespondstotheLATEXitemizeenvironmentwherethetextisjustied.Inprosper,theitemizeenvironmenthasbeenredenedsuchthattextisnotjustiedinit(abetterchoiceforslides).Therealsoexistsanitemstepenvironmentwhereeachitemisdisplayedincre-mentally(inPDFmode).Thisenvironmentonlyoffersafacilitytoaddoverlaysandisquitelimitedinuse.Inparticular,nonestingofitemstepenvironmentisallowed.Itacceptsanoptionalargumentcorrespondingtotheoverlayleveltostartfrom.3.4Macrostobeusedoutofanyslideenvironmentnpart[transition]fxxg.Createsaslideonlycontainingthetextxxverticallyandhorizontallycenteredinthefonttitle.Thetransitiontransition—ifgiven—willbeusedforthisslide.4 3.5MacrosthatmayappearinaslideenvironmentnFontTitlefCgfBWg.Usethismacrotochangethefont/colortobeusedforslidetitles.Therstargumentisforcolorslides,thesecondforblackandwhiteones;nFontTextfCgfBWg.Usethismacrotochangethefont/colortobeusedforslidetext.Therstargumentisforcolorslides,thesecondforblackandwhiteones;nfontTitlefxxg.Writesitsargumentusingthetitlefontandcolor;nfontTextfxxg.Writesitsargumentusingthetextfontandcolor;nColorFootfcolg.Thefooteristobewrittenwithcolorcol;nPDFtransitionftrg.Usestrasthetransitioneffectfromthepreviousslidetothecurrentslide;nmyitemflvlgfdefg.Denestheitemoflevellvl(wherelvlmaybe1,2or3)tobedef.Bydefault,itisagreenlozengeforalllevels.Thefollowingcodedenetheitemstobe3Dbulletsofdifferentsizeandcolor(thecorrespondingPostScriptTMlesareprovidedintheimg/directoryoftheprosperdistribu-tion):}3.6OverlaysOverlaysaddanimatedeffectstoslidesinPDFmode.Theymaybeusedtodisplayaslideincrementally(inseveralsteps),formakingappearanddisappearsomeelementsonaslide...Touseoverlays,onehastoembedthecorrespondingslideenvironmentintoannoverlaysmacroasfollows:\overlays{n}{Therstargument(n)oftheoverlaysmacrostandsforthenumberofstepscomposingtheanimation.Thefollowingmacrosmaybeusedtocontrolwhatshouldappearoneachslidecomposinganslidesoverlay:•nfromSlidefpgfmatg.Putsmatonslidespthroughn;•nonlySlidefpgfmatg.Putsmatonslideponly;•nuntilSlidefpgfmatg.Putsmatonslides1throughp;•nFromSlidefpg.Allthematerialaftertheoccurrenceofthemacrowillbeputonslidespthroughn;5 •nOnlySlidefpg.Allthematerialaftertheoccurrenceofthemacrowillbeputonslideponly;•nUntilSlidefpg.Allthematerialaftertheoccurrenceofthemacrowillbeputonslides1throughp.Allthosemacrosareonlyreallymeaningfulinpdfmode;inpsmode,theydonothingorinterprettheirargument,dependingontheoptionno/accumulate.Macros\fromSlide,\onlySlide,and\untilSlideacceptstaredversionswhichtypesetthematmaterialinazerodimensionbox(i.e.thepositionpointerisnotmoved).Thestaredversionsshouldbeusedforreplacementpurposes.Forexample,thepieceofcode:\onlySlide*{1}{\includegraphics{example-1.eps}}%ouldputimageexample-1.epsontherstslide;thisimagewouldthenbere-placedbyexample-2.epsonthesecondslide,andbyexample-3.epsonthethirdslide.Notethe%commentsignattheendofeachline:itpreventsLATEXfrominsertingsomespace—duetothecarriagereturn—whichwouldinduceaslightdis-placementbetweeneachimageontheslides.Importantnote:keepinmindthat\FromSlide,\OnlySlide,\UntilSlide,andtheun-staredversionsof\fromSlide,\onlySlide,and\untilSlidein-terprettheargumentmatforeachslidecomposingtheoverlayevenifitisnotdis-played(thisismandatoryinordertoknowthesizeoftheboxthatneedsbereservedfortheun-displayedmaterial).Thefollowingmacrospermitchoosingthematerialtoputonaslidedependingonthechosenmode(psorpdf):•nPDForPSfifpdfgfifpsg.Interpretsmaterialifpdfifthechosenmodeispdf,otherwiseinterpretsifps;•nonlyInPSfmatg.Interpretsmaterialmatonlyifthemodeisps;•nonlyInPDFfmatg.Interpretsmaterialmatonlyifthemodeispdf.Thesemacrosmaybeusedasfollows:\overlays{3}{%slidewillbedisplayedinthreestepswiththreedifferentguresinpdfmode;inpsmode,therewillbeonlyoneslidecontaininggureexample.eps.6 4WarningTheprosperslidestylesarenotboundtoprovidethesamedisplayarea.Conse-quently,usingdifferentstylesmayrequiresomeadjustmentinthetextandgraphicspositioning.TheCompilationProcessThecompilationprocessslightlydiffersdependingontheintendeduseoftheslides.ItissketchedinFig.2.Ifyouplantoprintslidesontransparencies,youshouldselectthepsoptionandcreateaPostScriptTMle,whileifyouwanttodisplaythemwithacomputerandanoverheadprojector,youshouldselectthepdfoptionandcreateaPDFlefromthePostScriptTMle.TranslationofaPostScriptTMleintoaPDFleisdonebytheprogramps2pdfincludedintheGhostScriptdistribution.LaTeXDVIPostScriptPDFlatexOn-screen displayTransparenciesps2pdfdvipsoneAdobe distillerdvips...Figure2:CompilationprocessImportantnote:PDFleshouldbemaderesolutionindependentbyusingvectorialfontsonly(noTEXbitmapfonts).Todoso,youhavetouseaGhostScriptversionatleastequalto6.0.Youalsoneedtocreatea.dvipsrcleinyourhomedirectorywiththefollowinglines:p+psfonts.cmzp+psfonts.amzLast,prosperstyleshavebeendevisedtobeusedwithA4Europeanpaperformat.Consequently,youwillhavetoinstructGhostScripttousetheappropriateformatbydeningtheGSOPTIONSenvironmentvariableto"-sPAPERSIZE=a4".Ifyouusebashasyourmainshell,thisisdonebyaddingthelineexportGS_OPTIONS="-sPAPERSIZE=a4"inyour.bash_profilele.YouwillneedAdobe®Acrobat®Reader(acroread)todisplayPDFles.ItisavailableforfreeontheAdobe®website.Acrobat®Readerprovidesafull-screenmodethatisparticularlyhandyforpresentations.7 6DevisingnewslidestylesDevisingnewprosperstylesisaneasytaskprovidedyouknowthebasicsofVanZandt'sPSTrickspackage(refertoPSTricks:PostScriptTMmacrosforGenericTEX,User'sGuide,TimothyVanZandt).Inordertodeviseyourownstylenamedfoo,yoursthavetocreatealePPRfoo.stywhichwillcontainitsdenition.RefertopredenedstylesforsomeexamplesandtoSection6.4.Awordofcaution:youarefreetocreateanewstylebymodifyinganexistingone.Inthatcase,itisMANDATORYrenamingyourle;doNEVEREVERmodifyastylewithoutrenamingit(isthatclearenough?).Youshouldalsowriteyournameandemailaddressinanyofyourstylessuchthatusersknowwhotogetintouchwithwhentheyusethestyle.Pleasechooseanameforyourstylethatisuniqueintheprosperdistribution(withrespecttobothpredenedandcontributedstylessofar).Pleasesendslidestylesyouareproudof.Iwilladdthemtothedistributioninthecontrib/directory.NotethatIwillonlyconsiderforadditionstylesthatareindeedoriginal.ModifyingthecolorsorthefontsofanexistingoneisdenitelynotsufcientsincethiscanbedonebyusersintheirLATEXlebyusingtheprovidedhooksforcustomization.6.1PredenedtestsThefollowingtestsmaybeusedinyourstyleleinordertomodifyitsbehaviouraccordingtotheactiveoptions.Thegeneralschemeis:\ifxxxx%%The``then''part\else%%The``else''part\finifDVItoPS.TruewhentheDVIlewillbeeventuallytranslatedintoaPostScriptTMle,falsewhenthenaltargetisthePDFformat;nifisDraft.Truewhentheleiscompiledindraftmode;nifinColor.TruewhentheoptionslideColorhasbeenchosen;nifallPages.Truewhentheoptiontotalhasbeenchosen;nifcolorBG.TruewhentheoptioncolorBGhasbeenchosen;nifshowVersion.Truewheneverthemacro\displayVersionappearsinthepreamble;nifInOverlays.Trueifthecurrentslideenvironmentisembeddedintoanoverlaysmacro.8 6.2MacrostocustomizeorcreateastylenslideCaptionfcapg.Denitionofacaptiontoappearoneveryslide;nPDFCroppingBoxflxlyuxuyg.DenitionofaPostScriptTMboundingboxtocropslidesforenhancingtheirappearanceon4=3devicessuchasmonitors(onlyusedinPDFmode);nNewSlideStyle[width]fanchorgfposgfdefing.Denesanewslidestylewhosedenitionisgivenbythemacro\definandwhosecontentsareahaswidthwidthandisputatposition(pos)withanchoranchor.Ifnowidthisgiven,adefaultwidthof11cmisused;nLogoPositionfposg.Defaultpositionforalogoifnoneisgivenbytheuser;nPutLogo.Amacrotobeputattheendofthemacrothatdenesyourownstyle.6.3LengthsnslideWidth.Denesthewidthofthetextareaintheslide.Shouldnotbemodi-edbytheuser.CorrespondstotherstargumentofmacroNewSlideStyle.6.4Example:thetroispointsstyle\NeedsTeXFormat{LaTeX2e}[1995/12/01]points'styleforProsper---}\typeout{(c)2000FredericGoualard,CWI,TheNetherlands}\typeout{CVSId:$Id:prosper-doc.tex,v1.132001/10/2415:11:25exuperyExp$}\typeout{}\RequirePackage{amssymb}Loadingpackagesnecessarytodefinethisslidestyle.\IfFileExists{pst-grad}{\RequirePackage{pst-grad}}{\RequirePackage{gradient}}\newgray{mygrey}{.5}.72.525}\newrgbcolor{orange}{1.000.650.00}\FontTitle{%\usefont{T1}{ptm}{m}{sl}\fontsize{22pt}{20pt}\selectfont\orange}{%\usefont{T1}{ptm}{m}{sl}\fontsize{22pt}{20pt}\selectfont\blue}\FontText{%\mellow\usefont{T1}{phv}{m}{n}\fontsize{14.4pt}{14pt}\selectfont}{%\black\usefont{T1}{phv}{m}{n}\fontsize{14.4pt}{14pt}\selectfont}\ColorFoot{\mellow}Positionningofthetitleofaslide.\newcommand{\slidetitle}[1]{%9 \rput[l](-0.4,3.7){\parbox{10cm}{\fontTitle{#1}}}}Positionningforalogo\LogoPosition{-1,-1.1}Definitionofthisstyleforslides.\newcommand{\TPFrame}[1]{%\ifinColor(12.5,9)\fiw]%(-1,-.5)(11.6,8.3)%Mandatory{#1}}\NewSlideStyle{t}{5.3,2.9}{TPFrame}40594800}\RequirePackage{semhelv}CopyrightinformationCopyright©2000-2003byFr´ed´ericGoualardandPeterMllerNeergaard,allrightsreserved.Thisprogrammaybedistributedand/ormodiedundertheconditionsoftheLaTeXProjectPublicLicense,eitherversion1.2ofthislicenseor(atyouroption)anylaterversion.Thelatestversionofthislicenseisinhttp://www.latex-project.org/lppl.txtandversion1.2orlaterispartofalldistributionsofLaTeXversion1999/12/01orlater.8TheProsperhomepageTheofcialProsperhomepageislocatedatSourceForge(tm):http://prosper.sourceforge.net/10 Youwillndthereadditionalinformation,CVStarballs,news,uptodatedistribu-tionsofProsper...IfyouplanusingProsperonaregularbasis,youshouldconsidersubscribingtothelistsprosper-usersandprosper-announce.Directionstosubscribetothemareavailableonthehomepage.9TroubleshootingsIfyouexperiencesomeproblemwheninstallingorusingProsper,pleasegorsttotheProsperhomepagetocheckwhetherthereissomehintonhowtosolveitinoneofthelistarchives.Ifyoudonotndanyanswertoyourproblem,sendamailtotheprosper-userslist.Mailsaskingforhelpsentdirectlytotheauthorswillnotbetakenintoconsidera-tion.ThereisalsoaleTROUBLESHOOTINGSinthedistributionlistingsolutionstocommonlyencounteredproblems.Prosperreliesonsomerecentversionsofsomepackagesandsoftware(mainlyhyperrefandAladdinGhostScript).Checkthehomepagetondlinkstothere-quiredversions.10BugsreportsBugsaretobereportedbyllingtheappropriateformsavailableattheProsperhome-page.ContributorsAVKprovidedthepatchstosupportMicroPressVTeX.11