WhenproducingDVIoutputpdfpagescannotinsertpagesofaPDFdocu-ments.Butins - PDF document

ThepdfpagesPackageAndreasMatthiasandreas.matthias@gmail.com2019/11/21AbstractThispackagesimpliestheinsertionofexternalmulti-pagePDForPSdoc-uments.ItsupportspdfTeX,VTeX,XeTeX,LuaTeX,andpTeX.Contents1Introduction12Usage22.1PackageOptions............................22.2Commands...............................22.3TheLayout...............................102.4HintsforUsersofplatex........................112.5Pitfalls..................................113RequiredPackages114Acknowledgment121IntroductionWhencreatingPDFdocuments,itissometimesusefultoinsertpagesofexternalPDFdocuments.Thiscanbedonewiththe\includegraphicscommandfromthegraphicspackage.Butasimple\includegraphics{doc.pdf}normallypro-duces`Overfull\hbox'and`Overfull\vbox'warnings,becausethesizeoftheinsertedpagesdoesnotmatchtheprintspace.ThepdfpagespackagemakesiteasytoinsertpagesofexternalPDFdocumentswithoutworryingabouttheprintspace.Herearesomefeaturesofthepdfpagespackage:Severallogicalpagescanbearrangedontoeachsheetofpaperandthelayoutcanbechangedindividually.Alotofhypertextoperationsaresupported,likelinkstotheinsertedpages,linkstotheoriginalPDFdocument,threads,etc.WhenworkingwithVTeXthesameispossiblewithPostScriptdocuments,too.NotethatPostScriptdocumentsareonlysupportedbyVTeXandnotbypdfLaTeX. Thislehasversionnumberv0.5o,lastrevised2019/11/21.1 WhenproducingDVIoutputpdfpagescannotinsertpagesofaPDFdocu-ments.Butinsteadofinterruptingexecutionpdfpageswillinsertemptypages.Thisfeatureisimportantwhenusingpackageslikepst-pdf,whichneedtopro-duceDVIoutputattherstrun.LinksandotherinteractivefeaturesofPDFdocumentsWheninclud-ingpagesofaPDFonlythesocalledcontentstreamofthesepagesiscopiedbutnolinks.UptonowtherearenoTeX-engines(pdfTeX,XeTeX,...)avail-ablethatcancopylinksorotherinteractivefeaturesofaPDFdocument,too.Thus,allkindsoflinks1willgetlostduringinclusion.(Using\includepdf,\includegraphics,orotherlow-levelcommands.)However,there'saglimmerofhope.SomelinksmaybeextractedandlaterreinsertedbyapackagecalledpaxwhichcanbedownloadedfromCTAN[3].Havealookatit!2Usage2.1PackageOptions\usepackage[hoptionsi]{pdfpages}hoptioni{final:Insertspages.Thisisthedefault.draft:Doesnotinsertpages,butprintsaboxandthelenameinstead.demo:InsertsemptypagesinsteadoftheactualPDFs.nodemo:Disables`demo'.enable-survey:Activatessurveyfunctionalities.(ex-perimental,subjecttochange)2.2CommandsInsertspagesofanexternalPDFdocument.\includepdf\includepdf[hkey=vali]{hlenamei}hkey=vali{Acommaseparatedlistofoptionsusingthehkeyi=hvalueisyntax.hlenamei{FilenameofthePDFdocument.(Thelenamemustnotcontainanyblanks!)Thefollowinglistdescribesallpossibleoptionsof\includepdf.Alloptionsareusingthehkey=valueisyntax.Mainoptions:pagesSelectspagestoinsert.Theargumentisacommaseparatedlist,containingpagenumbers(pages={3,5,6,8}),rangesofpagenumbers(pages={4-9})oranycombination.Toinsertemptypagesuse{}. 1ActuallynotonlylinksbutallkindsofPDFannotationswillgetlost.2 E.g.:pages={3,{},8-11,15}willinsertpage3,anemptypage,andpages8,9,10,11,and15.Pagerangesarespeciedbythefollowingsyntax:hmi-hni.Thisselectsallpagesfromhmitohni.Omittinghmidefaultstotherstpage;omit-tinghnidefaultstothelastpageofthedocument.Anotherwaytoselectthelastpageofthedocument,istousethekeywordlast.(Thisisonlypermittedinapagerange.)E.g.:pages=-willinsertallpagesofthedocument,andpages=last-1willinsertallpagesinreverseorder.(Default:pages=1)nupPutsmultiplelogicalpagesontoeachsheetofpaper.Thesyntaxofthisoptionis:nup=hxnupixhynupi.Wherehxnupiandhynupispecifythenumberoflogicalpagesinhorizontalandverticaldirection,whicharearrangedoneachsheetofpaper.(Default:nup=1x1)landscapeSpeciestheformatofthesheetofpaper,whichisrotatedby90degrees.Thisdoesnotaectthelogicalpages,whichwillnotberotatedbythe`landscape'option.Torotatethelogicalpagesusethe`angle'option(e.g.`angle=90').Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:landscape=false)Layoutoptions:deltaPutssomehorizontalandverticalspacebetweenthelogicalpages.Theargumentshouldbetwodimensions,separatedbyspace.SeeChapter2.3andFigure1.(Default:delta=00).osetDisplacestheoriginoftheinsertedpages.Theargumentshouldbetwodimensions,separatedbyspace.In`oneside'documentspositivevaluesshiftthepagestotherightandtothetopmargin,respectively,whereasin`twoside'documentspositivevaluesshiftthepagestotheouterandtothetopmargin,respectively.SeeChapter2.3andFigure1.(Default:offset=00)framePutsaframearoundeachlogicalpage.Theframeismadeoflinesofthickness\fboxrule.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:frame=false)columnPdfpagesnormallyuses`row-major'layout,wheresuccessivepagesareplacedinrowsalongthepaper.Thecolumnoptionchangestheout-putintoa`column-major'layout,wheresuccessivepagesarearrangedincolumnsdownthepaper.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:column=false)columnstrictBydefaultthelastpageisnotsetinastrict`column-major'lay-out,ifthelogicalpagesdonotllupthewholepage.Thecolumnstrictoptionforcesastrict`column-major'layoutforthelastpage.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:columnstrict=false) 1 4 2 5 3 columnstrict=true 1 3 5 2 4 columnstrict=false3 openrightThisoptionputsanemptypagebeforetherstlogicalpage.Incombinationwithnup=2x1,nup=2x2,etc.,thismeansthattherstpageisontherightside.Thesameeectcanbeachievedwiththepagesoption,ifanemptypageisinsertedinfrontoftherstpage.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:openright=false)pagecommandDeclaresLATEXcommands,whichareexecutedoneachsheetofpaper.(Default:pagecommand=f\thispagestylefemptygg)turnBydefaultpagesinlandscapeformataredisplayedinlandscapeorien-tation(ifthePDFviewersupportsthis).Withturn=falsethiscanbeprohibited.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:turn=true)noautoscaleBydefaultpagesarescaledautomatically.Thiscanbesup-pressedwiththenoautoscaleoption.Incombinationwiththescaleoption(fromgraphicx)theuserhasfullcontroloverthescalingprocess.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:noautoscale=false)tpaperAdjuststhepapersizetotheoneoftheinserteddocument.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:fitpaper=false)re ectRe ectsincludedpages.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:reflect=false)signatureCreatesbookletsbyrearrangingpagesintosignaturesandsettingnup=1x2ornup=2x1,respectively.Thisoptiontakesoneargumentspec-ifyingthesizeofthesignature,whichshouldbeamultipleof4.Anexamplefordocumentsinportraitorientation:\includepdf[pages=-,signature=8,landscape]{portrait-doc.pdf}Anexamplefordocumentsinlandscapeorientation:\includepdf[pages=-,signature=8]{landscape-doc.pdf}signature*Similartosignature,butnowforright-edgebinding.bookletThisoptionisjustashortcutofthe`signature'option,ifyouchooseasignaturevaluesolargethatallpagestintoonesignature.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:booklet=false)picturecommandDeclarespicturecommandswhichareexecutedoneverypagewithinapictureenvironmentwiththebasepointatthelowerleftcornerofthepage.(Thebasepointdoesnotchangeifthepageisrotated,e.g.bythelandscapeoption.)(Default:picturecommand=fg)picturecommand*Likepicturecommand,butwiththerestrictionthatpicturecommand*executesitspicturecommandsonlyontheveryrstpage.(Default:picturecommand*=fg)pagetemplateBydefaulttherstinsertedpagewillbeusedasatemplate.Thismeansthatallfurtherpagesarescaledsuchthattheymatchwithinthecontourofthisrstpage.Thisoptionallowstodeclareanotherpagetobeusedasatemplate;whichisonlyusefulifaPDFdocumentcontainsdierentpagesizesorpageorientations.Theargumentshouldbeapagenumber.(Default:pagetemplate=hfirstinsertedpagei)4 templatesizeThisoptionissimilartothepagetemplateoption,butitsargumentsspecifythesizeofthetemplatedirectly.Itssyntaxis:templatesize={hwidthi}{hheighti}Note:Thetwolengthsshouldbeabitlargerthandesired,tokeepawayfromroundingerrors.(Default:templatesize=hsizeofthefirstinsertedpagei)rotateoversizeThisoptionallowstorotateoversizedpages.E.g.pagesinlandscapeorientationareoversizedrelativelytotheirportraitcounter-part,becausetheydonotmatchwithinthecontourofaportraitpagewithoutrotatingthem.Bydefaultoversizedpagesarescaleandarenotrotated.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:rotateoversize=false)doublepagesInsertseverypagetwice.Thisisusefulfor2-upprinting,ifonewantstocutthestackofpaperafterwardstogettwocopies.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:doublepages=false)doublepagestwistWhereaswithdoublepagesthecuttingedgeisonceontheinnersideandonesontheouterside,doublepagestwistturnsthepagessuch,thatthecuttingedgeisalwaysontheinnerside.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:doublepagestwist=false)doublepagestwistoddTurnsthepagessuch,thatthecuttingedgeisalwaysontheouterside.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:doublepagestwistodd=false)doublepagestwist*Likedoublepagestwistbutfordoublesideprinting.Ei-ther`true'or`false'(ornovalue,whichisequivalentto`true').(Default:doublepagestwist*=false)doublepagestwistodd*LikedoublepagestwistoddbutfordoublesideprintingEither`true'or`false'(ornovalue,whichisequivalentto`true').(Default:doublepagestwistodd*=false)duplicatepagesDuplicateseachpagentimes,withnbeingtheargumenttothisoption.(Default:duplicatepages=2)Miscellaneousoptions:lastpageInDVImodepdfpagescannotdeterminethenumberofpagesoftheincludeddocument.Sothisoptionissuitabletospecifythenumberofpages.ThisoptionisonlyusedinDVImodeandhasnomeaninginanyothermode.Theargumentshouldbeapagenumber.(Default:lastpage=1)Hypertextoptions:linkInsertedpagesbecomeatargetofahyperlink.Thenameofthelinkis`hfilenamei.hpagenumberi'.Thelenameextensionofhlenameimustnotbestripped.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:link=false)linknameChangesthedefaultlinknamecreatedbytheoptionlink.Insteadofhlenameithevalueofthisoptionisused.E.g.linkname=mylinkproducesthelinknames`mylink.hpagenumberi'.5 threadCombinesinsertedpagestoanarticlethread.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:thread=false)threadnameSeveralthreadsaredistinguishedbytheirthreadnames.Bydefaultthethreadnameisequaltothelename(pluslenameexten-sion),butitcanbechangedwiththisoption.Thisisusefulifthesameleisinsertedtwiceormoretimesandshouldnotbecombinedtoonesinglethread.Ortheotherwayroundifpagesfromdier-entdocumentsshouldbecombinedtoonesinglethread.(Default:threadname=hfilename.exti)linktodocLetstheinsertedpagesbehyperlinkstothedocumentfromwhichtheywereextracted.NotethatthePDF-Viewerwillnotndthele,ifhlenameihasnotlenameextension(.pdf).Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:linktodoc=false)Additionalhypertextoptions:linktSpecies,howtheviewerdisplaysalinkedpage.Thisoptionchangesthedefaultbehavioroftheoptionlink.Possiblevaluesare:Fit,FitHhtopi,FitVhlefti,FitB,FitBHhtopi,FitBVhlefti,andRegion.See[2]foradetailsdescriptionofthesePDFdestinations.TheregiondestinationwasaddedbypdfpagesandisnotarealPDFdestinations.ItscalesapagesuchthattheincludedpagetsexactlyintothewindowofthePDFviewer.NotethatnotalloftheseoptionsaresupportedbyallTEX-enginesordrivers,respectively.(Default:linkfit=fit)linktodoctBydefaulttheoptionlinktodocopensthepagein`FitinWin-dow'view.Anotherviewcanbespeciedwiththisoption.PossiblevaluesarethelegalPDFtokens:/FitHhtopi,/FitVhlefti,etc.(See[2]formoredetails.)(Default:linktodocfit=/Fit)newwindowBydefaultoptionlinktodocopensanewwindow.Thiscanbechangedwithoptionnewwindow.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:newwindow=true)linklenameSetsthename(withpath)oftheletobelinkedtobytheoptionlinktodoc.Youwillhardlyeverneedthisoption.(Default:linkfilename=hfilename.exti)Experimentaloptions:(Syntaxmaychangeinfutureversions!)addtotocAddsanentrytothetableofcontents.Thisoptionrequiresvearguments,separatedbycommas:addtotoc=fhpagenumberi,hsectioni,hleveli,hheadingi,hlabelighpagenumberi:Pagenumberoftheinsertedpage.hsectioni:LATEXsectioningname{e.g.,section,subsection,...hleveli:Number,denotingdepthofsection{e.g.,1forsectionlevel,2forsubsectionlevel,...hheadingi:Titleinsertedinthetableofcontents.hlabeli:Nameofthelabel.Thislabelcanbereferredtowith\refand\pageref.6 Note:Theorderoftheveargumentsmustnotbemixed.Otherwiseyouwillgetverystrangeerrormessages.Theaddtotocoptionacceptsmultiplesetsoftheabovementionedvearguments,allseparatedbycommas.Thesetsmustbesortedsuchthatthehpagenumberisareinascendingorder.(Strictlyspeakingtheymusthavethesameorderasthepagenumbersspeciedbythepagesoption.)Theproperrecursivedenitionoftheaddtotocoptionis:addtotoc=fhtoc-listightoc-listi!hpagenumberi,hsectioni,hleveli,hheadingi,hlabeli[,htoc-listi]addtolistAddsanentrytothelistofgures,thelistoftables,oranyotherlist(e.g.from oat.sty).Thisoptionrequiresfourarguments,separatedbycommas:addtolist=fhpagenumberi,htypei,hheadingi,hlabelighpagenumberi:Pagenumberoftheinsertedpage.htypei:Nameofa oatingenvironment.(figure,table,etc.)hheadingi:TitleinsertedintoLoF,LoT,etc.hlabeli:Nameofthelabel.Thislabelcanbereferredtowith\refand\pageref.Likeaddtotoc,addtolistacceptsmultiplesetsoftheabovementionedfourarguments,allseparatedbycommas.Theproperrecursivedenitionis:addtolist=fhlof-listighlof-listi!hpagenumberi,htypei,hheadingi,hlabeli[,hlof-listi]surveyCreatesasurveyofthosepagesofthedocument,whicharemarkedwith\AddToSurvey.(\AddToSurveyisasimplecommandwithnoargu-ments.Itjustwritesoutlabelstothe.auxle.)Thisoptionmaybeusedwhenpreparingslidestocreateasurveyofonly`nished'pages{ifpagesarebuildupincrementally.Tousethisoptionaspecialsequenceofproductionstepsmustbeobeyed.Hereisasmallexample:---slides.tex---\documentclass{article}\usepackage[draft,enable-survey]{pdfpages}\begin{document}...sometext...\AddToSurvey...sometext...\includepdf[survey,nup=2x2]{slides-tmp.pdf}\end{document}Thisistheoutlineofadocument,calledslides.tex.RunitthroughpdfLaTeXseveraltimesuntilallcross-referencesaresolved.(LATEXwillproduceawarning,ifcross-referencesarenotsolved,yet.)Nowcopytheleslides.pdftoslides-tmp.pdfandrenamedraft(packageoptionofpdfpages)tofinal.ThenextandnalrunthroughpdfLaTeXwillactuallyinsertthedesiredpages,whereastheformerrunswithdraftdidjustinsertblankpages.Theinsertedpagesarehyperlinktotheorignialpages.7 Experienceduserswouldcertainlycallpdflatex'\PassOptionsToPackage{final}{pdfpages}\input{slides}'insteadofexchangingdraftforfinal.Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:survey=false)survey-nolinkSameasoptionsurveyexceptthattheinsertedpagesdonotbecomehyperlinks.Thisoptionmaybeusedtocreateanexternalsurvey.Tocontinuetheexampleabove(slides.tex),itisnowpossibletocreatehandoutsofthe`nished'slidesasanexternaldocument.\documentclass{article}\usepackage{xr}\externaldocument{slides}\usepackage[enable-survey]{pdfpages}\begin{document}\includepdf[survey-nolink,nup=1x2]{slides.pdf}\end{document}Either`true'or`false'(ornovalue,whichisequivalentto`true').(Default:survey-nolink=false)xr-prexAdjustsaprextothelabels\includepdfislookingfor.Thenameoftheprexmustbethesameasthenameoftheoptionalargumentof\externaldocument.(Default:xr-prefix=fg)Internallythecommand\includepdfmakesuseofthe\includegraphicscom-mandfromthegraphicx(actuallygraphics)package.Henceitispossibletousealltheoptionsof\includegraphics,too.Optionswhicharenotinterpretedby\includepdfarepasseddirectlyto\includegraphics.Especiallythe`trim'and`clip'optionsof\includegraphicsarequiteuseful,ifonlypartsofapageshouldbeinserted.(Maybetocutotheheaderandfooteroftheinsertedpages.)Justusethe`trim'and`clip'optionsasiftheywereoptionsof\includepdf.Theywillbepassedto\includegraphicsinternally.InsertspagesofseveralexternalPDFdocuments.\includepdfmerge\includepdfmerge[hkey=vali]{hle-page-listi}hkey=vali{Acommaseparatedlistofoptionsusingthehkeyi=hvalueisyntax.hle-page-listi{hlenamei[,hpagespeci][,hle-page-listi]Acommaseparatedlistoflenamesandoptionalhpagespecispeciers.Ahpagespecicanbeeverythingtheoptionpagesaccepts.Leadingandtrailingspacesofitemsinthelistisstripped.The\includepdfmergecommandusesthesameoptionsas\includepdfwithoneexception.Theoptionpageshasnomeaningfor\includepdfmerge.Insteadthehpagespecispecierisusedtospecifywhichpagesshouldbeinserted.Thehpagespecispecieracceptsthesamevaluesasthepagesoption.Ifnohpagespecispecierisgiven,onlytherstpagewillbeinserted.8 - delx - delx 6 ?dely 6 ?dely - 6oxoy physicalsheetofpaperdelta=hdelxihdelyi logicalpagesoffset=hoxihoyi centeredposition Figure1:Layout9 Examples:TocreateakindofsummaryofthreePDFdocuments,itmightbenicetoinsertjusttherstpageofeachdocumentandtoprovidelinkstotheoriginaldocuments:\includepdfmerge[nup=1x3,landscape,linktodoc]{doc1.pdf,doc2.pdf,doc3.pdf}Butsometimesthetitlepageofadocumentisnottherstpage.Soitwouldbemorepleasanttoinsertthetitlepageofeachdocumentthantherstpage.Thiscanbedonewiththehpagespecispecier.Thefollowingexampleinsertsthesecondpageofdoc1.pdfandthethirdpageofdoc2.pdfanddoc3.pdf:\includepdfmerge[nup=1x3,landscape,linktodoc]{doc1.pdf,2,doc2.pdf,3,doc3.pdf,3}Hereisanexampleofmorecomplexhpagespecispeciers:\includepdfmerge[nup=1x3,landscape,linktodoc]{doc1.pdf,1-3,doc2.pdf,3,5,9,doc3.pdf,3-5,7}Ifyouneedthesameoptionsfor\includepdfallthetime,itispossibletode-\includepdfsetneglobaloptionswith\includepdfset.Theargumentof\includepdfsetisacommaseparatedlistofoptions,usingthehkeyi=hvalueisyntax.Theseop-tionsareprocessedeachtime\includepdfiscalled.Localoptions(passedasanoptionalargumentdirectlyto\includepdf)areoverwritingglobaloptions:\includepdfset{hglobaloptionsi}\includepdf[hlocaloptionsi]{pdf-file}Onlyoptionsspecictothispackagecanbemadeglobalby\includepdfset.Optionsofthegraphicxpackagearenotconcerned.Whenusingtheoptionthreadtocreateanarticlethread,itmaybeusefulto\threadinfodictcreateathreadinformationdictionary,too,whichcontainsinformationsaboutthethread,suchasitstitle,author,andcreationdate.Themacro\threadinfodictisusedtosettheseinformations.Itcanberedenedandmaycontainentriesofathreadinformationdictionaryinlow-levelPDFcommands.(See[2]formoreinformation.)\renewcommand*{\threadinfodict}{/Title(Myfirstthread)/Author(That'sme!)}2.3TheLayoutThedefaultlayoutcanbechangedbytheoptionsdeltaandoffset.Figure1showsthemeaningoftheseoptions.Theinsertedlogicalpagesarebeingcenteredonthesheetofpaperbydefault.Todisplacethemusetheoffsetoption,whichargumentshouldbetwodimen-sions.E.g.offset=10mm14mmmeansthatthelogicalpagesaredisplacedby10mminhorizontaldirectionandby14mminverticaldirection.In`oneside'10 documentspositivevaluesshiftthepagestotherightandtothetopmargin,re-spectively,whereasin`twoside'documentspositivevaluesshiftthepagestotheouterandtothetopmargin,respectively.Bydefaultlogicalpagesarebeingarrangedsidebyside.Toputsomespacebetweenthem,usethedeltaoption,whoseargumentshouldbetwodimensions.Figure1showsthemeaningofdelta.Thelayoutoptionsdeltaandoffsetalwaysrefertoasheetofpaperinportraitorientation.Nomatterwhetheryouhavesetthelandscapeoptiontotrue,ornot.Ifyouareconfusedabouthorizontal(x)andvertical(y)directions,justsettheoptionturn=false.NowyourPDFviewershowsthepagesinthesameorientationasinFigure1.AndtheoptionsdeltaandoffsethavethesamemeaningasinFigure1.Regardlessofanyotheroptions.2.4HintsforUsersofplatexTherecommendedwaytotellpdfpagesthatyouareusingplatexistoadddvipdfmxasaclassoption,e.g.:\documentclass[dvipdfmx]{article}\usepackage{pdfpages}PdfpagescallsprogramextractbbtogetthetotalnumberofpagesofaPDF.Butifanxbble(outputofextractbb)exists,pdfpageswillnotcallextractbbbutusethisle.However,beverycautiouswithxbbles:DonotusexbblesforPDFswithvaryingpagesizes.Becauseanxbblecontainsonlythepagesizeofasinglepage.2.5PitfallspagecolorWhensettingthebackgroundcolorwith\pagecolor(acommandfromcolor.sty),therst\pagecolormustprecede\usepackage{pdfpages}.\usepackage{color}\pagecolor{white}\usepackage{pdfpages}Thecolorisnonrelevant,itcanbechangedafterwardsbyusing\pagecoloragain.Justtheorder(rst\pagecolorbefore\usepackage{pdfpages})isimportant.{ThisisnotneededwhenusingVTeX.3RequiredPackagesThepdfpagespackagerequiresthefollowingpackages:eso-picCTAN:macros/latex/contrib/eso-pic/atbegshiCTAN:macros/latex/contrib/oberdiek/pd scapeCTAN:macros/latex/contrib/oberdiek/11 graphicx,ifthen,calcThesepackagesbelongtothestandardLATEXdistribu-tion.Furthermoreitrequiresarecentversionof:pdftex.defhttp://www.tug.org/applications/pdftex/SincepdfTEX,Version3.14159-1.00a-pretest-20010806,PDFimporthasimprovedalot.Thisresultsinmuchsmallerlesizes,fasterprocessingandtheintuitivelycorrecttreatmentoflandscapepages.ThelatestversionofpdfTEXcanbefoundat:ftp://ftp.muni.cz/pub/tex/local/cstug/thanh/pdftex.4AcknowledgmentIwouldliketothankRolfNiepraschkandHeikoOberdiekfortheirusefulhintsandsuggestions.AswellasRossMoore,whoencouragedmetoimplementthehypertextfeatures.References[1]HanTh^eThanh,SebastianRahtz,HansHagen,ThepdfTeXusermanual,http://www.tug.org/applications/pdftex[2]PDFReference,AdobeSystemsIncorporated,http://www.adobe.com/devnet/pdf/pdf_reference.html[3]HeikoOberdiek,pax:ExtractandreinsertPDFannotationswithpdfTeXhttp://www.ctan.org/pkg/pax12