powerdot
The powerdot class *
Hendri Adriaens
v1.7 (2021/05/19)
powerdat is @ presentation class for BX that allows for
Abstract
1e quick and easy de
‘velopment of profesional presentations. It comes with many tools that enhance
presentations and aid the presenter. Examples are automatic overlays, personal
notesand a handout mode. To view a presentation, DVI, PS or PDF output can be
used, A powerful template system is available to easily develop new ses. A x
layout leis provided.
Contents
1 Introduction
2 Setting up the presentation
2.1 Document class options
22. Setup options . . .
2. Makingslides
SL The tile slide
3.2. Other slides
4 Overlays
4.1 The \pause command
4.2 _Listenvironments
43. The \iten command
44 The \onslidecommand
45. Relative overlays
5. Presentation structure
5.1 Makingsections . .
52 Making an overview
6 Miscellaneous
G1 Notes
62. Empty slides
6.3. Bibliography slide
64 Verbatim onslides -
65. The \twocoluan command
7 Available styles
8 Compiling your presentation
8.1 Dependencies
82 Creating and viewing output 26
Tihs cas can be dawnload fi
thisclase
26
26
9 Creatingyour own style
9.1. General information
9.2 Defining palettes
93 Defining templates
94 Controlling setup
95 Main components.
96 Slidetoc ......
9.7. Miscellaneous options
9.8 Template presets
9.9. The background
9.10 Title slide, titles and sections
9.11 Testing the style
10 Using I4X for presentations,
10.1 How to use the layout
10.2 Support of syntax
10.3 Compiling with IX
10.4 Extending the layout
11 Questions
11.1 Frequently Asked Questions
11.2 Mailinglist
12 Sourcecode documentation
References
Acknowledgements
Version history
Index
3
38
41
4a
2
2
43
ihe CIAN minors: /ascros/latex/contzsb/poverdot. Sce
ing powerdot into your BX dsibution a forthe Heanse of1 Introduction:
This class gives you the possibility to easily create professionally looking slides. The
class is designed to make the development of presentations as simple as possible so
that you can concentrate on the actual content instead of keeping yourself busy with
‘Of course, some knowledge of BT is stil required though.
is on and extends the prosper class [9 and the HA-prosper package
[1]. The HA-prosper package was initially intended to extend prosper and correct some
‘bugs and problems ofthat class. As developments on that package progressed, it was
found that unfortunately, not all of the problems could be overcome with the package.
That discovery was the start of a new project set up to make a new class to replace
the prosper plus HA-prosper combination, You're currently reading the result of that
project,
‘The remainder ofthis section will be devoted to giving a feel of what the powerdot
presentation source looks like and giving an overview of this documentation
“The document structure of presentation is always the same. You can find it in the
example below.
\Wocurens class [clase options] (poreraee)
\pasetupt
\begingeiided{a oiicey
\enaensde)
\section(fiset section)
\beginéelide) celide options>l{another slide)
Consents of the alte
\enatstiae?
\beginénoteh(personal note)
endnote)
\enalcocunent?
‘There are several elements that define the document structure, First ofall, the class
accepts some class options that control the output of the class, for instance, paper
type and style, These class options will be discussed in section 2.1, Then there are
presentation specific options which control some of the elements ofthe presentation
slobally, or instance, the footers, These will be discussed in section 2.2
Once the setup has been decided on, you can use the slide envionment to produce
slides (see section 3) and the note environment to produce notes that go withthe slides
{see section 6.1) You can use overlays to display material in steps. This is described in
section 4. The \sect ion command provides a way to structure your presentation. This
is discussed in section 5. Section 7 will show an overview of the styles that come with
this class and the characteristics of each style, Section 8 will tell you more about how to
produce output. This section contains important information on required packages.
Section 9 is mostly interesting for people that want to develop their own style for
this class or want to modify an existing style. Section 10 explains how IyX [6] can be
used to cteate powerdot presentations. This documentation concludes with a section
devoted to questions (section 11), like ‘Where can I find examples?” It also tells you
where to turn to in case your questions are still not solved,
2. Setting up the presentation
This section will describe all options that are available to control the output of the
presentation and the looks oft2.1, Document class options
‘We will start with the class options that are typed in the \docusent class command
‘asa comma-separated list For each option, the preset value! will be mentioned in the
description. This isthe value that will be used if you decide to not give a value to the
‘option oF not use the option at all.
option ‘This options conteols the kind of output that we want to produce. The preset value
mode ispresent,
[nodo=present
‘This mode:
overlays and
used when you want to create the actual presentation, Iewillenable
ion effects. You can read more about overlays in section 4
fmode=print|
This mode can be used when printing the slides including their visual markup,
‘but without any overlay or transition effects.
[mode=handoue
‘This mode will produce a black and white overview of your slides that can be
used to make personal notes on, for distribution to students, a personal guide
‘during your talk, eteetera
Rohendoutpagebreaks
By default, the handout mode produces a document with two slides per
page. If you want to fit more slides on a page, specify this option in
the \docunentclass command and powerdot will let BTfX decide on the
places to insert a page break, namely when a page i ull,
By default, the handout frames the slides. This option will remove the
frames around slides on handouts.
option ‘This option has five possible values. The preset value is ecreen,
paper
[paper=acreen!
‘This is a special format with sereen optimized ratio (4/3). The actual page di-
mensions will be 8.25 inch by 11 inch, This paper format is not available for
print or handout mode. In these modes, powerdot will switch to a paper and
put a warning that it did this inthe logfile of your presentation.
paper=adpaper|
‘Ad paper will be used for the presentation or handout.
[paper=letterpaper|
Letter size paper will be used.
[paper=snartboard]
For presentation on a smartboard (widescreen),
[paper=i69)
For a presentation on a screen with 16:9 ratio.option
option
display
option
ize
option
style
option
Deg
option
eqno
option
nopsneader:
‘Some important information with respect to paper size, compiling and viewing pre-
sentations is available in section 8
‘This controls the orientation of the presentation, The preset value is Landscape
‘oriontelandacape|
‘The presentation will bein landscape format, This values not available in hand-
‘out mode. In that mode, powerdot will switch to portr a
‘warn you about this in the log fle.
‘orientation and
orlent=portralt|
Tis produces slides in portrait format. Notice that not all styles support por-
trait orientation. Please refer to section 7 for information about which styles do
‘support the portrait orientation,
‘This controls the production of slides and notes, The preset value is s1ides.
[aisplay=slides
‘This will only typeset the slides in your presentation.
[display=elidesnot
‘This will typeset both the slides and the notes in your presentation. See also
section 6.1 for more information about notes.
[aisplay-notes|
‘This will typeset the notes only
Here are some more options to control the output
‘Thisis the sizeof the normal text font in points. Possible values are 8pt, 9pt, 10pt,
pt, 12pt, pt, 17pt and 20pt and the preset value is 1pt2
style]
This controls the style to be loaded for the presen
style will be loaded. For more styles, see section 7,
on. By default, the default
eae
This option makes equations flushed left. It does the same as the equally named
‘option forthe article class.
Teqno]
Put equation numbers atthe left. Also the same asin the article class
[nopeheader|
By default, powerdot will write a postscript command to the ps file to make sure
that post processors like ps2pdf know which paper to use without the need to
specify it on the command line. See also section 8. If you experience problems
‘with post processing or printing or you want to specify the paper size in the post
processing steps yourself, use thi option,option
hientries
option
option
pauseslide
options
clock
‘This highlights table of contents entries when the entry matches with the
ccurtent slide and its preset value is true. See also section 5. If you dont
‘want highlighting of table of contents entries (for instance in print mode), use
hlentries=falee.
‘This highlights table of contents sections when the seetion matches with the cur
rent section in the presentation and is preset o false. See also section 5, Spec
ifying this option turns highlighting of sections on. ‘This could be useful when
youre using. style that implements a spit table of contents.
ide
pan
‘This option inserts black slide in the presentation on page 1 and will auto-
‘matically advance to page 2 when opening the presentation in a PDF viewer like
Acrobat (Reader), The option also inserts link behind every slide or section ttle
that brings you to the black slide when clicked. When you click anywhere in the
black slide, you will go back to the originating slide. This option can be used to
temporarily pause a presentation, for instance, to do a proof on the black board
Optionally, a color can be supplied, for instance, pauseelide-vhite to have a
pause on a white sereen,
‘This displays a small digital clock on slides which you can use to check the time
leftfor your presentation.
Here Is an example of \documentc1ass command,
\ioeumentclase
aol
a
foderpresen:
‘iaplay=elideonctes,
srylestyese,
Schndetpacerant,
Dpoverdot
This example sets up a presentation in tycja style, with a black slide, normal size 12
points and flushed let equations
\eoeuneneclasel
wizeriopt,
odechandouty
‘isplay=sl ideanete
srplertyese,
snohandowtpagebreats,
dpoverdot
Changing the paper and node options, now produces a handout with possibly more
than two slides per page due tothe nohandoutpagebreaks option,
Note that ste oer than 1Op, Tip and 12pt are non-standard and it is assumed that you have the
cevtsizes bundle 1 Installed, which provides these les\pasetup
option
palette
option
theatide
option
thenove
option
option
List
options
Steatze
2.2 Setup options
‘There are several extra options that can help customizing your presentation. These
options are not available via the \docunentclass command. This has a technical
reason.? We distinguish two types of options. Options that can only be set globally
{acting for the entize presentation) using the \pdsetup command and options that
can be accessed both globally (via \pasetup) and locally (va slide environments, see
section 3)
2.2.1 Global options
This section describes options that can only be used globally in the preamble of your
presentation via the \pésetup command,
palette]
‘This specifies the palette to be used. A palete isa set of colors defined by a style.
‘Tofind out which palettes are defined by each style, see section 7.
‘theslide|
‘This option controls how the slide number appears on the slide. This is preset
tothevalue \arabic{slide}” /~\pageref+{lastelide}, which could appear
like 5/22. Notice that the \arabic{s1ide} typesets the number of the current
slide and that \pageref+{1ast s1 ide} typesets the number ofthe last slide.*
‘This is similar to the thes1ide option, but typesets the slide numbers of
notes. The preset value is nove™\arabic{note}“of"sLide”\arabic(sLide}
and \arabic{note} here typesets the numberof the current note that goes with
the current slide. This could appear like note 2 of slide 7.
‘The counters option lists counters that you might want to protect on aver
lays. AAs material on overlays (see section 4) is processed multiple times, also
[BIiX counters, like the equation counter, might be increased too often. To
avoid that your equations get different numbers on every overlay, use this op-
tion. The equation, table, figure, footnote and mpfootnote counters are
already protected for you. If you use extra counters, for instance for theorems,
list them in this option. Example:
‘ounere={ehearen, Jemma)
‘This option takes ais of options that willbe passed on to the enumitem package
that controls the layout of ists created by the enumerate and itemize environ-
‘ments, Example
Liste Ciabed
Sian pSe Ta ae
See for mote information on controlling the layout of ists the enumitem package
a.
"he interested readers referred ode seton about the hte package inthe xheyal package doc
mentation
“kee the stared version of \pageres which is define by hyperef an docs nt create ink a the
ge that isreferingAs the List option, but only control enumerate and itemize environments re-
spectively.
option
chocktormat ‘This option specifies the format of the clock. The format Is set using Acrobat's
util printd function ‘The default value is HisHM: 25, which shows a 00-28,
hue, 00-59 minute, 00-59 second clock. Example:
The above setting will display a 1-12 hour, 0-59 minute, am/pm clock. That is,
the clock might show 5:53 pm.
Shockrefresh ‘This option should be a number which specifies how often the clock is refreshed
inlleconds. The default behaviors to relresh the clock every second. Ts,
the default values 1000 Notice, the elockfornat ssc that seconds are not
shown, then makes no sense to update that clock every second. A correspond
ing example
‘The interpretation ofthis is that the clock willbe updated every minut.
2.2.2, Global andocal options
‘This section describes options that can be used both globally via \pasetupandocaly
viaslde environments (ee section 3
options
21¢ thisetermines the content ofthe let center and right footers. These are preset
$f coempe
option
‘This option sets the default transition effect to be used in the presentation, These
‘ansition effects only work after compiling the presentation to PDF format. See
also section 8. The following transition effects are supported: Split, Blinds,
Bos, Wipe, Dissolve, Glitter and Replace. When you are using a viewer that
understands PDF 1.5, you can also use Fly, Push, Cover, Uncover or Fade. It
is important to notice that most viewers are case sensitive, so, for instance, box.
will not work.
‘The preset effect is Replace which just replaces one slide with another when
browsing the slides. Note that some PDF viewers (like Acrobat Reader 5 and
higher) only produce the transition effect in fll sereen mode, If you want to
use a custom transition effect that is not listed in the list above (for instance, a
wipe effect with a custom wipe direction). then that i passible. However. power-
dot will put a warning in your log file thatthe effect that you have chosen, might
not work in the PDE viewer. Here is an example that does work.
Branseilipe 701 0
In Acrobat (Reade), this wipes from left to right instead of the default top t0
bottom. For more information, see a PDF Reference Manualoption
method
options
Aogehook,
ogopo
Logoced
option
randondots
options
anindote
options
anineize
anaxeize
options
aninwsdth
dmaxvidth
aninheseht
‘aoaxheseht
‘This option can be used when a slide contains spectal material that does not
‘get treated in the ‘usual’ way by BTRX. Verbatim material is an example of this.
Possible values are normal (the preset value), direct and file. We will come
‘back to this option in detal in section 6.
Togokook| [ogopos] [logoend|
If Logopos is specified, a logo defined by the value of the Logocnd option
will be put on slides. The position can be specified relative to the width
and height of the slide, {0,0} is the lower left corner of the paper and
{\slidewidth, \sLideheight} is the upper right comer. For positioning the
logo, the \rput command of pstricks (16, 17) is used. This command also allows
to specify the point of the logo that should be positioned there. This point ean
bbe entered via the Logohook option and can take the values t1, tr, r, Br, br,
», bl, B1, 1, Band c. For more information about \rput, consult the pstricks
documentation. Here is an example that integrates the flower ofthe default style
into the husky style,
\pdsetupe
‘ogoneck=t,
-088\=3
end netepraphes sgh enthetgn)Govrde dea,
\negindaocarest
\enaedocunent?
‘The preset value for Logohook is #2.
A special feature of powerdot, which can be used to make presentations come alive,
{s the use of random dots. These dots will be placed anywhere on your slides and use
the colors defined by the palette that you use, Overlays will carry the same dots. This
feature uses random.tex (3). Several options are available o control the appearance
of the random dots.
[randondots|
By default, random dots are turned off. Ifthis option is et to true, random dots
will be generated, fa12e will turn off the feature. When no value is submitted to
the option, true will be used,
‘The number of dots per slide is also random. These options set the minimum
‘and maximum dots per slide, Preset values are § and 40, respectively:
‘The minimum and maximum radius of the dots, Preset values are Spt and 40p¢,
respectively,
[Gainwiath] [Gmaxwideh] [Gaimhoighe] [Geaxhergne
These options determine the area on the slide that can be used for the random
dots, These values are preset such that dots go anywhere on the slide, but you
might want to adjust these such that, for instance, dots can only appear in the
textarea. The preset values are Opt, \sLidewidth, Opt, \slideheight.
Here is an example that allows dots in a smaller rectangle on the slide,
For a complete stingatallwale formats, consult the Aerob Jari Srpng Roe 3option
aright
option
prop
\paee
‘siovidthe.2\e1ideusdth draevidthe O\eiideviaen,
tenia. znicesigt asbeiphy-Setedeteine
fabrighe
This option can be used to adjust the brightness ofthe dots, The number should
bbe an integer between -100 and 100. If the number is negative, the color will
‘be adjusted towards black, with -100 giving black, Ifthe number is postive, the
color will be adjusted towards white, with 100 giving white. With a light back-
‘ground, you may want to choose bright to be positive. With adarkbackground,
‘you may want to setit negative. The preset value is 60, meaning mixture of 40%
‘of the original color and 60% white,
[aprop
‘This option is used for passing extra parameters to the \psdot command, which
creates the ranclom dots. You could, for instance, change the style ofthe dots or
the line width. See for more information about \psdot the pstricks documenta-
tion (16, 17). powerdot defines two extra dot styles that can be used for the ran
dom dots. These styles are ocircle (open circle) and esquare (open square).
Here are two examples for the use of random dots
\paaerupt
‘yandondote,dzinuidtne.eLédewsat
>
This turns on random dots and doesnt use the left 20% ofthe side for placing random
dots
cizcle Linexidthe. Seth,
4 unteetpeeuaientp Gnadcer nines
This example puts at most 5 big circles on slides. These circles do not fit on the slides
‘and you will only see parts of them in the shape of curves.
2.2.8 \pdsetupexample
Here is an example of \pasetup command that one could use to set up the presen-
tation.
ope
Tarst presentation,
This sets the left and right footers and will initialize the transition effect to Wipe. Fur-
ther, slide numbers will not include the numberof the ast slide, but only the number
of the current slide, Finally, slides will be covered with at most 80 random dots.
‘A mall note is necessary with respect to the appearance of footers, The slide num:
ber (controlled by the thes1ide option) will be added to a footer. Most styles add it
too the right footer. fboth the footer and the slide number are non empty, ~~~" will be
ingerted in between them to separate them. Styles might modify this default behavior
however.\eiee
\eutnor
end
\aate
\naketseie
slide
option
3. Making slides
3.1 The title slide
The
le slide is created by the \naketit1e command,
\eaket tte [(options)]
Its use is the same as in the standard IT3X document classes. The optional argument
(options) can contain any option from section 2.2.2, Specifying such an option in the
\maket ite command will only have an effect onthe title slide and not on other slides.
See an example below.
\eoeunent aso poverdot
Sele (Tele)
\euthor(tow (ant
\dstedlagses 21,
\bogintdocinent >
“anette
\enaCeocunent)
The author, title and date declarations provide the text to be used when making a
title page. The design ofthe ttle page is specific to the style in use. Notice the use of
\and for separating multiple authors, See a BTiX manual [12] for more information on
commands such as \titleand \author.
3.2 Other slides
The centerpiece of every presentation is the slide. In powerdot, the content of each
slide is placed in a s1 ide environment.
\begin{s1ide} [(oprions)}{(side itl}
(body)
\end{slide?
In section 4 we'll see how to give some life tothe slides, but for now, let's look at a
simple example,
\bogingeiide)(Fizer slide)
\enatenide)
The slide environment has one required argument, namely the slide title, When aside
is ereated, the slide title is used to create an entry in the table of contents and in the
list of bookmarks. The table of contents sa listing ofthe slides and section titles in the
presentation that appears on each slide.
‘The table of contents is clickable (when the presentation is compiled into PDF)
and serves as a nice way to jump from location to location within the presentation.
The bookmark lists only present when compilation is taken all the way to the PDF file
format, It also serves as a table of contents, but this ist does not appeat on any of the
slides, but ina separate window in a PDF viewer. In the example above, the entries in
both table contents and thelist of bookmarks would be tiled Firat. slide.
The (options) for the s1ide environment can contain any option listed in sec~
tion 2.2.2, Additionally, the following options can be used.
‘When specified, the value'is used for the entry in the table of contents; otherwise,
the slide tile is used. If toe= is specified, then no entry is created,
10option
om
\pause
‘When specified, the value is used for the bookmark entry otherwise, the slide
ttle is used, If is specified, then no entry is created.
These optional arguments are especially useful when the ttle ofa slides extremely
Jong or when the ttle contains IX commands that do not render correctly in the
‘bookmarks. When specifying entries, be sure to hide special characters ',” and '="
between curly brackets {” and ‘?. Lets look at an example that uses these optional
arguments
\boginGoiide) (voe=,barCiatex, ivi=-1}](color(eed)\LaTox, #218)
1 slide contents.
\enaensae)
Inthis example, the side tile will appear as DT}X, i? = —1, This text will not render
correctly in abookmarkentry. An attempt is made to correct this, but often, the correc-
tion does not produce an equivalent text. This particular title would be rendered in the
bookmark ist as redLaTeX, 12-1. On the other hand, the manually specified book-
mark entry isrendered as: LaTeX, isi=-1, Notice, no entry is created in the table of
contents, because ofthe use of toe:
Inaddition to the e14de environment, each individual style can define its own en-
Vironments. Many styles have a wides1ide environment. The idea is that one might
hhave information that does not fit nicely on a slide with a table of contents listed, as
this consumes some space. In sich cases, itis preferable to use a slide that does not list
the table of contents. The wides1 ide environment provides this functionality and has
:more space for the actual slide content. See section 7 for information on the various
environments provided by the styles.
4 Overlays
Itis often the case that you dontt want all the information on the slide to appear at
once. Rather, the information should appear one tem at a time. In powerdot, this i
achieved with overlays. Each slide can be comprised of many overlays, and the overlays
are displayed one ata time.
4.1 The \pause command
‘The easiest way to display information sequentially ist use the \pause command.
Ypausetnumberl
Below is a simple example:
\oopinGehideh(Sinple overlay
‘pover\paure dot
\enatenidey
The slides information is displayed and continues until the \pause command is en-
countered. No further output within the same slide is displayed until the click of the
_mouse or the touch of the keyboard. ‘Then, the content will continue to display until
all he information is displayed or until another \pause command is encountered. In
this example, power is displayed on the first overlay, and powerdot Is the displayed
fon the second overlay. The \pause command is often used within the itemize and
enumerate environments. For example,
“ihe bookmarking procedure ures Vpatetrngdef from the hyperef package, and itcan proces:
cene characters seh asoption
type
\bogingotide)vuitipie pauses?
Dpover\peuse dot pause
\begin(stenize)
(Ween Let ne pause\idcte \pauce
Aste \ldots hile T talk (pause and choy bubble gun, \pause
Aston Perhape
\enatitentee)
\enaCensae)
Since \pause was used before the itemize environment, no item will appear until
the third overlay. Then, each item will be displayed one at a time, each om their own
‘overlay: More information on using lists will follow in the next section,
‘The optional argument of the \pause command specifies the number of overlays
to pause. An example usage Is:
\bogin(eiide) (Pause Tonger)
begin (stentze)
Vitex & \pace
\sten B (pace (2)
Aster €
\enatitenize?
\enaenidey
In the example above, tem C will appear on the fourth overlay. The usefulness ofthis
‘option will become more apparent in the next section; so we will revisit asi
ample at that time.
4.2 List environments
The lst environments, itemize and enumerate, have special treatments in powerdot
They have an optional argument that will be taken care off by the enumitem package
{see [4]). powerdot supplies an extra key for this optional argument. In the examples
that follow, features will be described using the itemize environment but they also
apply tothe enumerate environment.
Here is the typical usage ofthe itemize environment:
Veogin(eiide) (Basie Seenize)
\begin(stenize)
Vien A \pacre
Aster B Apacs
Asten €
\enatitentze?
\enaensde)
The display is simple, each item appears one at a time with each averlay,
Suppose we wanted every item to show, but we only wanted one item to appear
‘active’ at once, This can be accomplished via the type option for the itemize envi-
ronment. The preset value is 0
VboginGeiide) (type 1 ieeniee)
\begin(stentze) Cuypeet]
Vitex A (pause:
\sses 8 \pecee
Aste ¢
\enatitenize?
\enaenide)
Now, every item will be displayed in the inactive color (which is defined by the style
‘that you use), and the itemis font color will become the active one on the overlay that it
‘would normally appear on, The default behavior is given by type=0. Itis still possible
{0 pass optional arguments to enumitem via the second optional argument
2\bogingotiae}Ciype 1 ivwniee)
\begin
‘This optional argument should contain an overlay specification stating on which over-
lays you want the item to appear. This specification is a comma separated list where
teach item can used the notation as in table 1. The (label) argument isthe standard
‘Syntax | Meaning.
= | Only overlays
Aicene> 9
Aitene> ¢
\enastentze?
\ena(ensae)
18\onetiae
\onstider
Here we have said that A should only be active on overlay 1,8 should only be active on
overlay 2, and C should only be active on overlay 3. Again, when the item is not active,
appears in the inactive color because of type=t.
Iltype=0 is specified and ifeach item is given an overlay option, then each item will,
appear only when itis active. When the item is not active, then it will nt show on the
slide at all, More examples demonstrating the syntax fr (overlay) willbe discussed in
the next section,
4.4 The \onslide command
Overlays can also be achieved using the \ons1ide command.
\onstide (overlays) (tex)
This command takes an (overlays) specification as first argument and the (text) to ap-
ply to as second argument. The (overlays) on which the text will appear are specified
‘asa comma separated list with syntax asin table 1, We stact off with a simple example,
Veegin(eiide) (Simple onslise)
\onsLide<1,2}(pover\onalide (21d)
\enaenided
We have instructed power to appear on overlays one and two, and dot to appear only
‘on overlay two, AS you might guess, this example has the same output as ous first
\pause example. Yet, tis clearly the case that our syntax is more complicated. How-
ever, ths slight “complication” also allows for much more flexibility
Consider the above example withthe following modifications:
\eogintaiide) (Staple onaliden?
\eextetConslide }: \onsiidedDpover)\onehides2)
vsght0.B\elideneight] foe cheving gun-eps)
The \includegraphice command is defined by the graphiox package [5]. The
\stretch command is used to vertically center the picture. Both commands are de-
scribed in your favorite BT]X manual, for instance (12|. Note that you can use the
lengths \s1ideheight and \s1idevidth to scale pictures to fitnicely on the slide.
6.3. Bibliography slide
thebibliography powerdot redefines the standard article thebibl Sography environment to suppress
the creation ofa section heading and running headers. All other properties are main-
tained. You can do either ofthe next two (depending whether you are using
no
Veeginteiiehisisee? \eegingaissebsisee?
\eiteCeoneone? \eite(eoneone?
\end(atiae?
\woginGelidey(Rererences)
Nbegin(thebibafegraphy) \bibticgrapnystyie(piain}
\pibiten(eanecne) sreicle of soneone.| | \psbisograpny (Yeuroib)
\enaenebsblioprapiy? \ensietsaed
\enaelsaed
In case you have a big reference list that you want to spread over multiple slides,
have a look atthe packages natbib and bibentry (8). Using both packages allows you to
do:
Vegan (eiide) (ieterences
\bublsoprapaystyie(plaia
\nobibl ography CYourBib)
\bibentey(soneonel>
\bibenteyGeoneone2)
\ena(ensae)
\begin(eisde) (References (2))
\pabeneryzoneenes)
\enaetsael
Have a look at your favorite I5X manual for more information about citations and
bibliographies.
6.4 Verbatim on slides
option powerdot has three different methods of processing slides, from which two have mainly
verbatim been developed to make the inclusion of verbatim content” on slides easier. These
methods can be accessed by the method key which is available in slide environments
and the \pdsetup command (see section 22.2).
‘This is the preset method for processing slides. Iti fast and allows for overlays,
butie does not allow for verbatim.
‘This method is also fast, but does not allow for overlays. Overlays will silently be
disabled. However, it does allow for verbatim content on slides,
“Another content that ned cacode changes when processing
18\esocoluan
option
dinehetghe
option
Lineprop
mato
a
‘This method uses a temporary file to export the slide body to and read it back
in, This method does allow for verbatim content and overlays, but could be slow
‘when many slides use this method because the filesystem is used,
Below isan example demonstrating the use of all three different methods of slide
processing,
\docusent lass poverdot
Musepackageisetings >
\lsttevenvizomment (code)
\istece Cerumecsingle eucapesneides',
beckgroundealor=\color(yello¥!20},
Dbesscotyles\footnotesize\eetanily}
\ena(ensae)
\bogen(eiide) nethedeascect)(Siide 2)
\begin(elided (nethodetslel Side 3}
Steps t and 2:
\bopinccode?
pause?
The first slide shows the default behavior for normal content. Itproduces two overlays.
The second slide does not produce overlays, despite the use of the \pause command.
This command has been disabled by choosing the direct method to process the ver-
bbatim content. The third slide has the same body as the second slide, but now does
create two overlays, because the method using a temporary fle has been chosen. No-
tice that we used \pause inside the listing, but that it can also be used outside the
listing
6.5 The \twocolumn command
The \twocoumn macro allows to spit content into two columns.
\twocoLunn [options)] (left righ
This typesets (left) and (right) in two columns. The dimensions of those columns can
be controlled by (options). Below are the available options.
Tineheight
If Lineheight is specified, a line ofthe specified height will be created using
\pelLine in between the two columns. Example: Linekeight=6em.
Tineprep]
Any pstricks declaration to specify the line properties. Example:
“ineprop={inestyesdatted, 20
catanape
19‘options
Atehesght
Lsprop
‘options
efehesght
rfxprop
‘options
reolwidth
option
‘freep
option
colsep
option
topsep
option
bottousep
option
Tisheigne] [Ifprop]
The first creates a frame of the specified height around the left column. The
second is as Lineprop, but forthe eft frame.
frirheleht| [Fizprop)
As Lfrheight and 1frprop, but for the right frame.
‘Width ofthe left and right columns. Both are preset to: 0.47\Linewidth,
irsep)
Space between text and the frames. Preset: 1. Ss.
coleep)
Space between the two columns. Preset: 0.06\1inewidth.
ftopsep|
‘Theextra space (additional to \base] ineskip) between text above the columns
‘and the text within the columns. Preset: Oe.
[poetonsep]
Idem for the bottom of the columns. Preset: Oem.
Horizontal indent left to the left column, Preset: Oem.
The dimensions described above are represented graphically in figure 1. Important
{o notice fs that the \twocoluma macto uses the current cursor position as the refer-
tence point to position the first line of text of the left column (see also figure 1). This
‘means that optional frames can extend to the text on the previous line. Use for
stance topeep=0.cm in that case to add extra space between the two lines of text.
‘The preset value of topsap is based on the situation that there is no text on top of the
‘wo columns. In that case itis best to locate the first line of text ofthe left column at
the same spot as text that is not ereated by \twocoluan on other slides. The setting
‘topsep=0cn does exactly this. However, with @ combination of topsep and indent
you can change this behavior and position the first ine of text of the let column any-
‘where you want
‘The \twocoluan macro computes the height ofthe construction to position text
below the construction correctly. The computation is done by taking the maximum
height of 1frheight, rfrheight, Lineheight (ifspecified) and the let and right col-
lumn content. Hence when frames nor a line is requested, bottomsep isthe vertical
space between the lowest line of text in the columns and the text below the columns
{additional to \base1 ineskp). Here is an example
\eogan(eisde) ive columns)
\evocotuaat
“LEzprope(isneatylesdotted, Linewiatnespe),
Lfshetghtnden,rfzheightoScen,linsheightesen,topeepe0.Su
dete) Gene
\enatehidey
Note that the use of the xkeyval commands \savevalue and \usevalue could be
handy here, for instance for copying the properties of the left frame to the right frame.
20Meaning ofthe labels
Tleolidh ——SO*SSCwep
2 reolwidth 6 topsep
3 colsep 7 indent
4 Lfrheight,rfrheight, 8 bottonsep
Lineheight 9 Reference point
Figure 1: Two-column dimensions.
This avoids typing them twice and avoids making errors resulting in different frames.
See an example below.
\esocoluant
\earevalueGiteheight}=Sen,
\sevevatuedreprep=(
‘isestylendoteed framenrce.2,Linevidtheapt),
sfobetgkts\erevalue(ifeheignt),
Pirprope\usevalue(f=prap)
delefeddesghe
See the xkeyval documentation [2] for more information about \savevalue and
\usevalue,
7 Available styles
powerdot comes with a number of styles which are listed in the overview below. The
characteristics of each style are described shortly and a sample of a title slide and a
normal slide is provided for each style. Styles support the wides1ide environment,
hhave a table of contents on the left part of the paper in landscape orientation and on
the bottom part in portrait orientation and support portrait orientation unless states
otherwise.
2default
‘This style provides six different palettes. Af
the top left comer decorates
the slides forall paletes. The default palette is blue which has as main colors
light blue and white. You can see an examph
le ofthat palette below, Other avail-
able palettes are red, green, yel oz, brown and purple.
simple
‘Thisisa simple style in black and white. This style could be useful ifyou want to
print your slides.
wycia
‘This styles set in shades of yellow and dark
blue. The table of contents on slides
is on the right side of the paper in landscape orientation and on the bottom part
in portrait
ikeda
‘This style uses dark shades of red and blue and a light text color. It has nice
patterns on the slide for decoration.
2fyma
‘This style was originally created by Laurent Jacques for prosper. Based on that
style, he created a version for HA-prosper with extended features. With his kind
permission, this style has been converted by Shuniichi J. Amano for powerdot.
‘The style has an elegant design with a light blue and white gradient background
in the default blue palette. Other available palettes are green, gray, brown and
‘orange. It has special templates for sections on slides and sections on wide
slides, Below isa sample of the blue palette,
iment
‘Thisstyle was originally created by Mathieu Goutelle for prosper and HA-prosper.
With his kind permission, this style has been converted for powerdot. The style
has background that ishatched with light gray horizontal lines. Ties and table
‘of contents highlighting are done with dark ted.
eleolors
‘This isa style using light shades of the elementary colors red, blue and yellow.
angie
‘This style was created by Jack Stalnaker for HA: prosper and he has converted this
style for powerdot. The style uses dark red and light brown colors
23husky
‘This style is created by Jack Stalnaker and has a background of light gray sun
‘beams combined with dark red highlights
sailor
‘This style is conteibuted by Mae! Hilléreau and supplies five different palettes:
Sea (the default), River, Wine, Chocolate and Cocktail. Below is a sample of
the palette Sea,
vpen
‘This style has nice dark blue background and text in yellow. Itis contributed by
Piskala Upendran,
bframe
‘The bframe style has blue frames on the slide in which text is positioned. The
style is contributed by Piskala Upendran.horatio
‘The horatio style has been contributed by Michael Lundholm and is amore con-
servative blue style,
Pi
a
paintings
This is simple style without a table of contents on slides. It has been con-
tributed by Thomas Koepsell and provides 10 different palettes The colors used
in the palettes are drawn from famous paintings. Ifyou are interested, open
the style file to read which paintings have been used. The avalable palettes are:
Syndice (the defaull), Skater, oldenGate, Lanentation, olyWood, Europa,
Noi ayTaird, PearlEarring and Charon (all ease sensitive). Below
isa sample ofthe Syndics palette
lope
‘The Klope style implements a horizontal table of contents that only lists the sec-
tions. The style is available inthe following palettes: Spring, PastolFlover,
BlueWater and Blackiihite. The Spr ing palette is the default and you can see
‘a sample of that below.
complements the oter colors. Tecan be se fo example to highlight tex against he man backeound
‘lor
25ape ee
jefka
The jefka style comes with four palettes: brown (the default), seagreen, blue
and white. Below you see a sample of the brown palette,
ss 7
Ena theo she : we -EGlew
pazik
‘This style is available in two palettes: red and brown. Below isa sample of the
default zed palette.
8 Compiling your presentation
8.1 Dependencies
In table 2 is a list of packages that powerdot uses to perform specific tasks. Depen-
ddencies of packages inthis table are not listed. In the table, ‘required’ means that you
should have a version at least as new as listed and ‘tested’ means that powerdot was
tested with this version, bur that it could equally well work with an older or newer ver-
sion than the one listed in the table. So, when trying to solve an error, ist concentrate
‘on solving version issues for the ‘requlted’ packages. To find out which version of a
package you are currently using, put \List ies on the first line of your document,
run it with BTX, open the .1og file and read the fe list (see a BI] manual for more
information). Ifyou need to update a package, you can getit from CTAN [7].
8.2 Creating and viewing output
‘To compile your presentation, run it with BiX. The DVI that is produced this way
can be viewed with MIKT}X’s DVI viewer VAP!” Unfortunately, xdvi and kdvi ile) do
"Unies you are sing pack 383 which dso the connate sytem in DV
26Package/tile Required /tested
‘keyval 2] 25e | 2008707710 | required
pstricks.sty(16,171 | 0.60 | 2013/12/12 | required
xcolor (10) 111 | 2008/05/09 | required
enumitem [4] 352 | 2011/09/28 | required
article class rat | 2004/02/16 tested
geometry (15) 32 | 2002/07/08 tested
hyperref [14] 674m | 2003/11/30 tested
sgraphicx 5] Lia | 2017/06/01 | required
verbatim 154 | 2003/08/22 tested
‘Table 2: Dependencies
‘not support all PostScript specials and hence these will display the presentation incor-
rectly. IFyour DVI viewer does support this, make sure that your DVI display settings
‘match that ofthe presentation, In case you are using the screen paper, you should set
the DVI display setting to using the letter paper format. If your DVI viewer allows for
‘custom paper formats, use 8.25 inch by 11 inch.
Note that certain things that are produced with PostScript or PDF techniques will
not work in a DVI viewer. Examples are hiding of material via postscript layers (as is
done, for instance, by \pause, see section 4) and hyperlinks, for instance in the table
of contents
Ifyou want to produce a postscript document, run dvips over the DVI without any
cular command tine options related 10 orientation or paper size. powerdot will
n to the DVI file that helps dvips and ps2pdf (ghostscript) to create a
proper document. If you have some reason that this does not work for you and you
want to specify the paper and orientation yourself, you should use the nopsheader
‘option that is described in section 2. The PostScript document could, for instance, be
used to put multiple slides on a page using the psnup ut
‘Tocreatea PDF document for your presentation, run ps2patfover the PS file created
with dvips. Also here, you can eave out any command line arguments related to paper
size or orientation. Iths is problematic for you somehow, use the nopsheader option
as before and specify the paper and orientation at each intermediate step yoursel
9 Creating your own style
9.1. General information
Writing or customizing powerdot styles is simple. Ifyou want to modify a style or
build a new one, locate the style that you want to use as basis in your TEX tree (styles
are named as poverdot- .sty),copy that and rename it as to avoid l-
cense!" or naming conflicts. You might want to install the new style in your local TEX
tree wo beable to access it from any place on your hard drive, See your BIX distribution
for more information,
Once that has been taken care of, we can start creating the style, We strongly ree=
‘ommend to study a style file (for example, poverdot-default . sty) while reading the
remainder ofthis section as it provides good examples for the content of this section.
Astyle has several components. We deseribe these components below.
Identification and packages
‘This identifies the package in the log of a presentation and loads all required
packages. The default style contains something like
"The BIX Public Project Lense requlres renaming fs when modling them see http://www.
project. ore/IPPL
27\padefinepalertes
‘Weeds TeiFornat (LaTox20) (1006/12/01)
\ProvidesPactage{poverdot-default) [2006/10/09 v1.2 default style (H)]
\nequirePackage(pifont)
See for more information about these commands a IX manual, for instance
12}.
Palette or color definitions
‘This section contains the definitions of palettes or colors that you want to use in
the style. powerdot uses xcolor (via pstricks). Hence, for more information about
colors, see the xcolor documentation. We will discuss palettes in more detail in
section 92.
‘Template definitions
‘We will come back to this in sections 9.3 10 99,
Custom declarations
These can include anything that you want to be part of the style. The default
style, for instance, includes definitions for the labels in list environments like
{itemize and some initialization for lists in general (done with \pasetup, see
section 2.2). This part could also include some customizations as described in
section 9.10.
Font initializations
‘This initializes font definitions (which can be done by loading a package like
helvet.
9.2. Defining palettes
We willbe defining templates formally in section 9.3. For now, it’s enough to have the
general idea that a template controls the design of aslide. Palettes are sets of colors that
colora template or design. A palette does not change the overall design ofa template.
‘The following command can be used to define palettes for your style
\padef inepalettes (name H(emdsi)>...
‘This macto takes any even number of mandatory arguments with a minimum of wo.
For every (name), a set of (commands) can be given which define the palette with
‘name (name). These commands can define colors with names pdcolor 1, pacolor?,
etcetera. These colors can be used when designing the template (see section 9.3).
pacolor1 will always be used as text color.
“The user can access these palettes va the palette key for the \pdsetup command
{see section 2.2). Ifthe user does not specify a palette, the first palette defined when
‘compiling the presentation, will be used, Here isan example for defining 2 paletes.
\Widetinepaevie nit
necolor (pdcolee! P(eebH(10,0)
ietiecoonepestecaheh.2.0)
creenehé
2 fetanecolor(peslort}(rgb(0,4,0)
\aetinecolor(plcoter2)(e#0){.1,1.0)
snecolor (pdcoler3}(=80). 21,0)
In this example, the reds palete is the default one, For more information about
\definecolor, see the documentation of the xcolor package [10
"Notice that itis not necessary to use the names pdcolor?2, pdcolorS etcetera as
color names. But if these colors are defined, powerdot will use them, for instance, in
28\pddesinetenplate
option
sfeetup
the random dots feature (see section 2.2.2). The flexibility adds extra possiblities in
setting up templates and palettes. See for an example of its use, the klope styl.
9.3 Defining templates
We start off with a definition of what a template Is. A template Is a collection of set-
‘ings for slide components together with custom definitions, which controls the visual
appearance ofa slide. A style can contain multiple eemplates.
\pader inetemplate [(basi)] {(name)}{(options)}€(commands)}
This defines the environment (name) to produce a slide with characteristics deter-
mined by (basis), (options) and (commands). We will discuss these elements in more
detail in the coming sections,
I you want to create several templates that differ only slightly from each other,
define a (basis) template, and then use it to define other templates. All (options)
and (commands) for the new template (name) will be appended to the existing list
of (options) and (commands) from the (basis) template.
“Make sure you choose a proper name for the template, and avoid redefining exist-
ing templates or environments. powerdot defines pauses! ide,note and enptyslide
internally, so you shouldnt use these names unless you know what you're doing, Fur-
thermore, each style needs to define at least the templates slide and vitleslide.
The titlee]ide environment willbe used to create the tite slide and slide will (by
fault) also be used to create section slides Titles and sections are bit special in the
\way they use the (oprions) and will be discussed in more detal in section 9.10,
9.4 Controlling setup
The (options) (keys) are described in the following sections. You can control how these
‘options apply to the various setups by using the ieetup key. Any key appearing be-
{ore the frst ifsetup declaration in (options) will apply to every possible setup. Once
the ifsetup key is used, then all subsequent key declarations will apply only to the
setups declared in the if etup key. The ifsetup key can be used multiple times.
By possible setups, we mean the allowed values of the mode, paper, orient, and
4ieplay keys that are described in section 2.1. Ifa value (or values!) for any of these
four keys is not specified in a if setup declaration, then all subsequent key declara-
‘ions will apply to any layout of that type. Consider the following as an example,
eepoon{.2\elidevsdth, 3\elidebesehe)
Staetapetpestraitecrecad2
exepoar{\slidevsath, 2\e1idebesghe
Assuming there was no if setup declaration before the first textpos declaration, this
first textpos will apply to every possible setup. However, for the screen format in
portrait orientation, the next textpos declaration will be used. In fact, all declarations
that appear until we switch to the next ifsetup (which specifies all paper sorts and
only landscape orientation) willbe used in the portrait screen layout. All keys after
the next ifsetup declaration will be used in landscape orientation, with any paper,
mode and display. If, after declaring some specializations, you want to switch back
to settings that apply to all possible setups, set ifsetup to empty as is done in the
example. Allsubsequent declarations will then again be applied under any setup.
29\paifsotup
\patnoportrait
option
title:
option
option
option
option
options
at
cf
‘The following command is a stand-alone implementation of the mechanism de-
scribed above. Ic allows you to control the setup outside the (options) argument of the
\pddef inotemplate command.
\paitsetupt (desired) }{lurue) (false)
This macto executes (érue) when the setup that the user chose matches with the
(desired) setup, (alse) in all other cases. For instance, ifthe user has chosen landscape,
then
Weal fectup iandacaped Gye NGoed
will ypeset yes. Ifthe user would have chosen portrait instead, then no would have
been typeset
‘This macro can be used to check setup requests from the user and, for instance,
generate an error ifa certain setup is not supported by your style. powerdot provides
‘one predefined ertor message which can be used in one of the first lines of your style.
\patnoportrait
‘This macto generates an error when the user requests portrait orientation. Notice that
the handout mode only works in portrait orientation. This macro takes that into ac-
count and doesnt generate an error in the ease that the user requested a handout.
9.5 Main components
The (options) control several key components ofa slide. Every co
eral properties. 4 key that can be used in the (options) argument
‘component postfixed by its property that you want to control
The components title, text, toc, stoc and ntoc have properties hook, pos,
width and font. Additionally, the text component has a he ght property. The com-
ponents 1f, cf and rf have properties hook, pos, tenp and font, Hence, examples of
valid keys are titlefont, tocpos and 1ftenp. All components and properties will be
discussed below,
Here is an overview of the components that can be controlled from the (options)
‘argument in \pddef inetemplate,
yponent has sev
the name of the
‘The main text box on the slide,
‘The (ful) table of contents on a slide containing sections and slides,
‘Thisis a table of contents containi
.gonly the sections, See also ntoc below.
‘This isa table of contents containing only the entries forthe active section. To-
gether with stoe, this can be used to create a split table of contents, In a partic-
ular template, one would usually havea toc, acombination of stoc and atoc or
no table of contents at all
(ee) Ge]
‘The left, center and right footers.option
hook
option
pos
option
option
shesght
option
option
“temp
Notice that all positioning of components described above will be done with \xput.
{rom pstricks (16, 17] internally See the pstricks documentation for more information
about this command. It should also be noted that all components (except Lf, ef and
+f) put their content in aminipage environment.
[Now we list all properties of the components listed above and describe what they
‘mean. Remember that keys are formed by combining a component name and a prop-
erty
‘This option defines the \rput hook that willbe used when positioning the item.
‘Thiscan be 1, , tx,x, Br, br, b, Bl, BL, 1, Band c. See the ptricks documenta-
tion for more information.
poe
‘This defines the position of the hook on the paper. The lower left corner of
the paper is given by the point {0,0} and the upper right corner by the point
{\sLidewidth, \e1idehei ght). So if you want to position the main text box at,
20% from the left edge and 30% from the top edge of the paper, you have to do
the following.
the position of any component has not been specified, this component will not
>be placed on the slide. This gives an opportunity to design slides without footers
‘or table of contents, for instance.
‘The width of the component. All component positioned by powerdot will be put
ina surrounding minipage environment. The width property determines the
‘width of theminipage. Example:
wereeiathe 7\slidestath
‘This property does not exist for the 1f, cf and rf components.
‘This option is only available for the text component, In other words, for this
property, there is only one key, namely textheight. This can be used to specify
the height ofthe minipage used for the main text. This does not imply that users,
‘are restricted to this length or that powerdot does automatic slide breaking. This
height is only used for vertical alignments of material for instance by footnotes.
‘The preset value is \s1ideheight.
This will be inserted just before the text that is about to be typeset. ‘This can
bbe used to declare deviations from the main text font and color. It can be a
font declaration, like \1arge\bf series, but can also contain other things like
\color{red} or \raggedright.
Teeap]
‘This property is only available forthe footers (f, ef and rf) and can be used
to change the template of the footers. This means that you can, for instance,
add content tothe footer, besides the content specified by the user. The default
declaration by powerdot isthe following,
aloption
\pabtocatide
\pateocseetion
\patcocdieplay
\patcochightight
option
ocfrsep
option
toceeceep
"Evenp=\pacort tz \pal0rT \oenpey
\elte\iez\theelie\Genpty\etee\
\es\es\eneenise
Here \pdtart will contain the content of the right footer defined by the user
via the \pdsetup command. Similarly, \pdo@if contains the content ofthe left
footer. The above declaration checks whether the footerand \thes1 ideareboth
ron-empty and ifso, it inserts -— to separate both,
‘This property is only available for the toc, stoc and ntoc components. This
property can be h or v and determines the orientation ofthe table of contents.
‘The preset i v. See also section 9.6 for more information about the construction
of the table of contents.
9.6 Slide toc
‘The small table of contents that is placed on slides can be controlled by four macros
and several options
‘These macros take one argument. When building the table of contents, powerdot
first passes the content through \pd@tecs1ide or \pddtocsection, depending on
the type of entry that itis building at that moment. You could, for instance, do
\paerocelidesi(F\ballerA\ AP
\aes\poteocsect sonal (el?
\which wil pref all normal entries (not the sections) with a bullet. By default, these
‘wo mactos are defined to just pass on thelr argument.
‘These two macros also take one argument. After processing an entry with the com-
mand \pd@tocs1 ide or \pdttocsect ion, powerdot continues building the entry by
passing it through \pdttocdisplay, when the entry needs to be displayed only, or
\pdttochigh2ight, when the entry needs to be highlighted. These macros are a litle
more involved and take care of putting the content in the proper font and color in a
minipage. Further, \pattochigh1ight also puts a box around the item.
Notice, that by default, both the separate table of contents entries as well as the
table of contents asa whole are typeset in ninipage environments by these macros, in
case the table of contents is vertical. The -width properties then determines the width
of the table of contents and, together with tocsecindent and tocs1ideindent (see
below) the width ofthe individual entries. IFitis horizontal, only the separate entries
will be in minipages and the table of contents itself not and the -¥idth properties
{determine only the width of the individual entries (together with tocsecindent and
tocelideindent},
Several aspects ofthe process of generating the table of contents can be controlled.
via the keys that are available in the \pddef inetenplate command that will be de-
scribed below: If these keys do not provide enough handles to do what you want, you
‘might need to have a look at the two macros inthe source and decide to rewrite them
{in yourstyle as to fit your needs. An example can be found in the fyma style.
[eoetrsep|
‘This length isthe distance between the box around the content ereated by the
‘sinipage and the highlight frame box created by \pdttochigh! ight. Preset:
0. 5.
rroceecep]
‘The distance inserted before a section (unless itis the first element in the table
2‘of contents). Preset: ex. Notice that ifthe orientation of the table of contents is
set to vertical, this length creates a vertical skip, otherwise, it creates a horizontal
ead
‘The horizontal space left toa section entry. Preset: Ope,
option [EoesTideindent|
Soest iceindent ‘Te horizontal space left to a slide entry. The horizontal skip will not be inserted
left to slide entries that appear before the first section. Preset: Opt.
‘This is inserted just before typesetting a section, This can be used to mark &
section, for instance with a line as inthe default style. Preset: empry.
option [Eoeteaier|
foctcolor ‘This the text color used for non-highlighted elements in the table of contents.
Preset: black.
option
tochiteslor
‘This the text color used for highlighted elements inthe table of contents, Pre-
set: vhite,
option
soenhcotor ‘This isthe color used for the frame behind highlighted elem
9.7, Miscellaneous options
‘There are some options that fall outside ofthe scope ofthe previous sections. These
willbe discussed here
option
iacolor
The iacolor option can be used to specify the color that is used for inac-
tive things, produced for instance by \ons1ide, \pause (see section 4) and
\tableof contents (see section 52). As xcolor is used by powerdot, one can
use special notation here, like
Tecolor=biack 90
‘The preset value for this key is Lightgray.
‘The following options control the digital clock (see section 2.1). The elock isa form
textfield with dynamic content, driven by a javascript via hyperref text fields. Some
‘options for the clock work similarly as for, for instance, the ttle component, but there
are also special options.
opvions [EeeRReok] [elockpos
clocknock
clockpos
These work in the same way as the -hook and -pos properties discussed in sec-
tion 9.5. The preset value of clockhook is tr.
33‘options
elockwidth
clockheight
option
clockcharsize
option
clockalign
option
elockeolor
[Geckwiath] [clockheignt]
These control the width and height of the textfield containing the clock. Preset
‘values come from hyperref and are 3cm and \base1ineskip, respectively.
elockcharsize
‘The size of characters ofthe clock. Preset: 14p¥.
clockalign|
‘The alignment of the clock in the text field. 0 is left-aligned, 11s centered and 2
Is right aligned. Preset is2.
‘This determines the text color ofthe clock. The value should be a named color
‘The preset value isblack,
9.8 Template presets
Below, we have copied the preset setting for the keys described above. These will be
used if you didn't supply other input for these keys in a particular template. If the
preset value meets your needs, you don't have to specify it again in your styl.
theights\elidebeight
tozhocketl, tocpos=,torwidthe.2\aLidewiae,
toetont=\tiny\rageedrigne,
seocwidthe.2\elidewiae,
a\eridexiaen,
feaiieeeter
roca ideindent=Opt,
Letont=\seriptelze, Lfteap=\pdeeie,
ffont=\seripteize,cfteapr\puoset,
"rffonts\ecripusize fteupe\patef\t¢z\p402et
\oenpty \else\sfs\therlide\enpty\elee\ => \Ei\fi\theshide,
Peles tigteearh
lockhook=tr ,clockpos=clockvidth=8em,clockheight=\baselineskip,
lockeharsize=Lipe,clockal gn=2, cloekeolor=black
9.9 Thebackground
This leaves only one argument of the \pddef inetemplate macro undiscussed. This
Js the (commands) argument. This argument can contain any code that you want to
execute after setting the options and before building the slide components ike the side
title, main text, and footers. This argument is designed to contain declarations that will
build the background of a template using, for instance, pstricks, but i ean also hold
other commands you might need for building your template.
Important to notice is that these commands may not create TX material as that,
‘might destroy the construction of the slide. So, if you want to place the word ‘Hello’
in the bottom left comer ofthe slide, dont type ‘Hello, but make its width, height and
depth equal to 2er0, for instance by using pstricks" \rput.
\epet (at) (0) Geno\patslidoticte
\paaesete
\pateectiontitie
options
sectenp
widesecteap,
9.10 Title slide, titles and sections
[As mentioned before, the style that you write needs to define at least the templates
slide and titleslide, The latter treats some of the keys ina special way, Besides, a
seetion slide i also done in a special way.
‘The title slide (made with \maketit Le) puts the ttle with author(s) and date in
the main text box. This means that you have to supply a position for the main text
box (textpos). It will use the main text font for the text (Logether with declarations
in the textfont key) for the author(s) and the date. But it will use the declarations
in tittefont for the title of the presentation. This is done so that title and author(s)
form a coherent block and to make sure that long titles can push down the author(s)
instead of overwriting it
‘The \pats1idet ite macro is used to typeset the slide title on slides. This macro
Js comparable to for instance \pa@tocs1ide, The macro takes one argument which
Js the slide tile in the right font and formatting. By default, this macro just passes on
the content for typesetting, but you could redefine this macto so do something with its
Input prior to typesetting it. An example is inthe fyma style which underlines the title
after putting itn aminipage to support mult line ties
‘These macros are similar to \pdts1 idetit1e and typeset the title on the title slide
and the title on section slides respectively. By default, these also pass there argument
(which isthe presentation title or section title), but these can be redefined to do some-
‘thing with the input prior to typesetting it, just as \pdds1 idecitte.
‘The \section command uses (by default) the slide environment and puts the
section ttle in the title box with font tt Lefont. Ifyou want to change the default use
of the sLide environment for sections to, for instance, the sections] ide environ-
‘ment or any other especially designed section template, change the section template
preset in your syle, using
\eeteye pal (eection)(oecteapraectionslide)
This means that ifthe user asks for tenplate=s1ide in the \section command, the
sections1ide environment will be used silently. To avoid surprises, sections1ide
should preferably be based on the s1de environment
A similar option is available in case the user asks for templatemwides]ide, One
could for instance do the following.
\eoteye [pal (eect iva) (videsectenp-oectionvidesiige)
Whenever the us
requests a wides1ide to be used for a \section, instead, the
sectionwides1ide environment will be used. Other input to the template key by
the user does not get a special treatment.
Notice that these keys are available in the section family of keys and that you
cannot use them in the \pddef inetemp1ate command.
9.11 Testing the style
ppowerdot has atest file that should test most of the style, Ths test file can be produced
by running BT]X over poverdot .dtx. This generates poverdot-styletest. tex
\which will help you with the testing job. Feel fre to contact us when you would like to
contribute your style to powerdot. See also section 11,
10 Using IyX for presentations
19K (isa WYSIWYM (What You See Is What You Mean) document processor based
‘on BI]X. Itsupports standard 1} classes but needs special fle, called layout files, in
order to support non-standard classes such as powerdot.
35‘Tostart using IyX for powerdot presentations, copy the layout file powerdot:. layout
to the I4X layout directory. You can find this file in the doc tee of your BX installa-
tion: texnf /doc/Latex/powerdet. Ifyou cant find it there, download it from CTAN:
Ynacros/latex/contrib/powerdot. Once that is done, reconfigure X (Bait >
Reconfigure and restart IX afterwards). Now you can use the powerdot document
class as any other supported class. Go to Layout > Document and select powerdot
presentationas document class. For more information, see the IX documentation,
which is accessible from the Help menu.
10.1 Howto use the layout
The powerdot IyX layout provides some environments"? which can be used in IyX.
‘Some of these environments (for instance Title or Itesize) are natural to use since
they exist also in the standard document classes such as article, For more information
‘on these standard environments, ee the 4X documentation,
‘This section will explain how to use the powerdot specific environments S1ide,
WideSLide, ExptyS1ide and tote, These environments correspond to the powerdot
environments s1ide, emptyslide, vides1 ide and note.
‘We start with a simple example. The following IX code
Veeganteisde) (Stade eile)
ide content.
\enatehided
‘can be obtained using the following IyX environments. The right column represents
the text typed into the IX window and the left column represents the environment
applied to this tex)
Standard Slide content
EnaShide
‘Some remarks concerning this example.
You can use the environment menu (under the menu bar, top-left corner) to change
the environment applied to text
The side tite should be typed on the line of the S1ide environment,
EndS1 de finishes the slide and its lin is left blank.
In the IyX window, the SLide environment (that is, the slide ttle) is displayed in
‘magenta, the WideS1ide style in green, the EaptyS1ide style in cyan and the Note
style in red and hence these are easly identifiable.
Here is another example.
\boginGolide}(Finet olide title}
\enaenste)
\begen(oote) (Firat note title)
"Tee furet note, concerning slide 1
\enatncte?
\boginGelide} Short title in
front of the slide tite. The following example uses the direct method (see section 6.4)
in the short title argument (delimited by square brackets) to allow for a 1st1isting
environment (defined by the listings package) within the slide content.
Stide __Gnethodsdixece]Exanple of LaTeX source code
Standard Here's the \elloWorld coun:
Cenr bos:
\usteet Canguages(taTex] TeX)
\begin{leeiisesng)
\nescomand{\ellovorid}-Giello World!
NenCletliseing?
1
Note that you are not obliged to use a verbatim environment to type the \Hel LoWora
text into the LyX window because I4X directly supports standard verbatim. Conse-
‘quently, the use of the slide processing methods direct and £i1e is not necessary
\when you need standard verbatim, but itis necessary when doing more advanced
things, lke in the example above,
10.2 Support of syntax
This section lists options, commands and that are supported through
the IyX interface directly, without using an ERT box (TiX-mode).
Alclass options (see section 2.1) ae supported via the Layout > Docunent dialog
(Layout pane). Options for the \pdsetup command (see section 2) should be speci-
fied in the Preanble pane of the Layout & Docunent dialog.
‘Table 3 lists the powerdot commands that are supported in IyX. ‘Table lists the
powerdot environments that, besides the earlier discussed sLide, widesLide, note
and emptyelide environments, are supported in IyX. Table 5 lists commands that
can only be done by using an ERT box (via Insert TeX). Note that you may use the
clipboard in order to repeat often used commands like \pause. Finally, table 6 lists
additional commands and environments that are supported by the layout.
10.3 Compiling with yx
First ofall, make sure that you have also read section 8. Then, in order to get a proper
PostScript or PDF file, you have to set your IX document properties depending on
which paper and orientation you want. When your IyX document is open, go to the
Layout > Docunent dialog, In the Layout pane, put the nopsheader, orient and
paper keys as class options (see section 2.1 fora description). Then, go to the Paper
aX wanalates speck characiers Ino tel coresponding IX command. Fr instance, the backlash
saractr in trasated into \testbackelash Resulting the font tno the same a inte verbatim nd
‘you migh want change that wa he Layout > Character dog,
a\pddefineiyztemplate
Command Method in x
“\uitie | Use Tite environment.
\author Use Author environment.
\aate Use Date environment.
\naketitle Managed directly by IX.
\section Use the Section environment. Options to this com.
‘mand (see section 5.1) can be specified using Insert
Short title in front ofthe section tte.
\tableofcontents | Use Insertp Lists & TOCp Table of contents,
You will need an ERT box if you want to use the optional
argument, see below.
‘Table 3: Supported powerdot commands in 4X.
Environment Method in bx
itemize Use Itenize and Ivenizelypel environments, The
latter will create a list with type=t (see section 4.2),
enunerate Use Enunerate and EnunerateType1 environments.
‘thebibliography | Use Bibliography environment,
‘Table 4: Supported powerdot environments in 4X.
ppane and select corresponding paper size and orientation (you may choose Letter
paper In the case you set paper=screen in the class options). Finally, go tothe View
(orFilep Export) menu and select your output (PostScript or PDP)
10.4 Extending the layout
Ifyou have created a custom style (see section 8) which defines custom templates, you
‘may want to extend the layout file so that these templates are also supported in IyX
‘The explanation below assumes that you have defined a template called sunnys! ide.
To support this new template in IyX, you have to use the following command.
\padef inelyxtemplate(es{(template)>
This will define the control sequence (cs) such that it wil create a slide with template
(template) (which has been defined using \pddef inetemplate. This new control se-
{quence can be used in the layout file as follows.
1 SunnyStide enviroment definizion
Seyle Sunnysiide
CopySeyle Slide
Latexfane — lyzend\yroumyslie
Color Yellen
\pief inelyxtenplate\Lyzsunnys}ide ounnystide)
ndPreanble
oa
Note that you must begin the Latextlane field with lyxend. The definition of the IX.
template has been inserted in between Preamble and EndPreanble which assures
that the new IyX environment will work in every presentation. After modifying the
layout file, dont forget to restart IyX. See for more information about creating IyX en-
vironments, the documentation of fyXin the Help menu.
iaes ornare ail fyou mdf itas to avid confsion,
38Command Method in x
Vand Within Author environment.
\pause
\iten An ERT box is only required for the optional argument,
not mandatory for overlays specifications.
\onslide nd the versions \onelide+ and \onelidee.
\twocolum
\tableofcontente | Only when using the optional argumer
‘Table 5: powerdot commands needing an ERT box in 4X.
Env/Command | Method in lyX
‘quote Use Quote environment
quotation | Use Quotation environment
vere Use Verse envionment.
\caption Use Caption environment within standard float env
Table 6: Additional environments for IX
11 Questions
11.1 Frequently Asked Questions
This section is devoted to Frequently Asked Questions. Please read! it carefully; your
problem might be solved by this section,
Q1 Does powerdot have example files? Where can [find them?
AL powerdot comes with several examples that should be in the doc tee of your IX in-
stallation. More precisely: texmf /doc/Latex/pozerdot. Ifyou cant find them there,
download them from CTAN: /macros/1atex/contrib/poxerdot (7)
Q2 I'm getting errors or unexpected output when compiling the simplest example!
A2 Did you read section a
Q8 I made a typo in the slide code, ran the fil, got an error, corrected the typo andl reran,
bbut now get an error that doesn't go away.
|A8 Remove the . band .toc files and try again.
Q4 \pause does not workin the align'® environment.
Ad align does several tricky things, which make it impossible to use \pause. Use
\onslide instead. See section 44.
Q5 My pstricks nodes appear on all overlays, Also: color doesntt seem to work with
\onslide.
AS Some PostScript tricks like nodes and color do not work with \ons1 ide. Use \ons1ides
Instead. See an example below.
\Wocunent lass (poverdot)
\erepaceageipet nose?
\beginéaoeunent >
\boginGelided
Yonah iden<2}{\cnode (0,-5p2) (2pr77
This Se Conetider(2-}(\eotor(eed)) zed) text
\onstiden (2 (\cnode(0,-5p2) pe) CE))
\ons1ide<2}{\ncl sae AS
\pasetupipaterse-nypaterte?
\begin (document)
\vogen(eisde)(Tst1e)
\ena(etsde)
\enacocunent?
See section 9 for more information about these two commands.
Can I contribute to this project?
Certainly. If you find bugs'® or typos, please send a message to the mailinglist (see
section 11.2). Ifyou have developed your own style that is distinct from existing styles
and would like to see it included in powerdot, please inform us by private e-mail and
\ve will consider your contribution. Notice that included contributions wil fall under
the overall powerdot license and copyright notice, but that your name will be included
in the documentation when you make a contribution. This is dane to guarantee that
\ve can adap‘ files f maintenance is needed,
Hyperlinks inthe presentation seem off by 1 page.
This might happen in particular PDF viewers when using pape?
bination with continuous view. Use page by page view instead,
jartboardin com-
your question has not been answered at this point, advance to the next section
to read where to find more answers.
11.2. Mailinglist
powerdot has a mailinglist from freel ists .organd has its website here:
hvtp://wiw. freolists.org/List/poverdot
‘There is a link to ‘List Archive. Please search this archive before post
Your problem might already have been solved in the past.
If that is not the ease, use the box on the page to type your e-mail address, choose
the action “Subscribe! and click ‘Go!’ ‘Then follow the instructions that arrive to you
by e-mail Ata certain moment, you can login forthe first time using an authoriza-
tion code sent to you by e-mail, After logging in, you can create a password for future
sessions using the ‘Main Menu’ button. The other buttons provide you some info and
‘options for your account.
‘When you are all set, you can write tothe list by sending an e
question.
Take sre that you coniem tar the bug seal caused by powerdot and notby another package that
youusepoverdot [at] freelists[dotlorg
When writing to the lst, please keep in mind the following very important issues.
_ We are volunteers!
Keep your questions related to powerdot.
Always supply a minimal example demonstrating your problem,
Dont send big files over the lis.
‘We hope you will enjoy this service,
12 Source code documentation
In case you want regenerate the package files from the source or want to have @
Took at the source code description, locate poverdet .atx, search in the file for
\OnlyDescriptionand remove that and do
rakeindex -© gglo.iet 0 poverdot gis poverdot glo
index -e gind.iet -o poverdot nd poverdot dx
poverdot ete
References
Hendri Adriaens, HA-prosper package, CAN: /macros/latex/contrib/
HA-prosper,
2
83)
4
65]
6
Heendri Adriaens. xkeyval package. CTAN: /macros/latex/contrib/