path: root/contrib/mom/examples/slide-demo.mom

.\" -*- mode: text; coding: utf-8; -*-
\#
\# Copyright (C) 2004-2020 Free Software Foundation, Inc.
\# Revised for version 2.5 2021-08.
\#
\# Copying and distribution of this file, with or without modification,
\# are permitted in any medium without royalty provided the copyright
\# notice and this notice are preserved.
\#
.\" Macro for code blocks
.de CODE_BLOCK
. ie \\n[.$] \{\
.   CODE off
.   QUOTE off
.   CENTER_BLOCK off
. \}
. el \{\
.   CENTER_BLOCK
.   QUOTE
.   CODE
. \}
..
.\"----------------------------------------------------------------
.
.TITLE "Creating slide presentations with gropdf/mom"
.PDF_TITLE "\*[$TITLE]"
.
.DOCTYPE SLIDES \
  ASPECT 16:9 \
  HEADER "Header left" "\*[$TITLE]" "Header right" \
  FOOTER "" "" "\*S[+2]\*[SLIDE#]\*S[-2]" \
  TRANSITION "Box 1 . O" \
  PAUSE "Wipe 1"
.
.PARA_SPACE .75v
.SS +3
.HYPHENATION off
.
.NEWCOLOR darkred #aa0000
.NEWCOLOR darkred1 #900000
.NEWCOLOR blue1 #00007b
.NEWCOLOR blue2 #00006f
.NEWCOLOR code-grey GRAY 0.3
.XCOLOR cyan4
.XCOLOR green4
.
.HEADER_COLOR      darkred1
.HEADER_RULE_COLOR blue1
.FOOTER_RULE       off
.
.COVER_STYLE \
  LEAD +8 \
  COLOR white
.HEADING_STYLE 1 \
  COLOR blue2
.CODE_STYLE \
  FONT B \
  SIZE 115 \
  COLOR code-grey
.QUOTE_STYLE \
  QUAD LEFT
.CONDENSE 90
.
.PDF_IMAGE_FRAME "" 1 blue1
.
.COVERTITLE \
  "Creating slide presentations" \
  "with" \
  "gropdf and mom"
.
.COVER_START_POS 15P
.COVER COVERTITLE
.
.STRING hand \*[darkred]\[rh]\*[black]
.
.\" Make first slide black.
.\" If printing, remove to save ink.
.SLIDE_COLOR black
.
.START
.SLIDE_COLOR off
.
.ADD_SPACE 9p
.IB 8P
.
.HEADING 1 "PDF slides"
.SP .5v
.
.PP
PDF slides are a subset of mom's document processing macros
formatted for presentation mode when viewed in a PDF reader.  In
most respects, they behave identically to the default document type
described in mom's html documentation\*[HANG .]
.BR
Differences in the formatting include\*[HANG :]
.
.PAUSE
.LEFT
.LIST
.ITEM .2v
the choice between two aspect ratios, 4:3 or 16:9
.LIST USER \*[hand]
.ITEM
both fit on A4 or US letter paper sizes when printed
.
.PAUSE
.LIST BACK
.ITEM .2v
type is set centered by default
.LIST USER \*[hand]
.ITEM
this may be changed to left, right, or justified
.
.PAUSE
.LIST BACK
.ITEM .2v
headers and/or footers must be explicitly instantiated
.LIST USER \*[hand]
.ITEM
the left, centre, and right parts must be supplied
by the user
.
.PAUSE
.LIST BACK
.ITEM .2v
slide numbering (pagination) is disabled
.LIST  USER \*[hand]
.ITEM
if slide numbering is desired, it must be put in the left,
centre, or right part of a header or footer definition
.QUIT_LISTS
.
.NEWSLIDE
.
.ADD_SPACE 9p
.IB 2P
.
.DOC_QUAD CENTER
.
.HEADING 1 "Pauses and transitions"
.SP .5v
.
.PP
Slides made with mom take advantage of the pause and slide
transition features provided in presentation mode by most
contemporary PDF readers.
.PAUSE
.PP
Pauses and transitions are dynamic and engaging, holding the
viewer's attention while increasing the impact of the content.
.PAUSE
.PP
With pauses, material on a slide can be revealed progressively
with
.BR
a mouse click or by hitting
.
.LIST
.ITEM .5v
Next
.ITEM 2p
PgDown
.ITEM 2p
Spacebar
.LIST off
.
.PAUSE
.PP
The manner in which new material is revealed and new slides
are displayed can be tailored separately for effects like Fade,
Dissolve, Wipe and others, and can be changed on the fly.
.
.NEWSLIDE
.
.PP
Mom slides begin with the macro DOCTYPE SLIDES, where you choose
the aspect ratio and transition effects, and set up headers and
footers\*[HANG .]
.PAUSE
.PP
You may find it convenient to provide a title for the slide
presentation, as the top of the .mom file for these slides
demonstrates\*[HANG :]
.
.SP -1v
.CODE_BLOCK
\*[COND]\&.TITLE "Creating slide presentations with gropdf/mom"
\&.PDF_TITLE "\\*[$TITLE]"
\&.\\"
\&.DOCTYPE SLIDES \\
 ASPECT 16:9 \\
 HEADER "Header left" "\\*[$TITLE]" "Header right" \\
 FOOTER "" "" "\\*S[+2]\\*[SLIDE#]\\*S[-2]" \\
 TRANSITION "Box 1 . O" \\
 PAUSE "Wipe 1"\*[CONDX]
.CODE_BLOCK off
.SP -.5v
.
.PAUSE
.PP
Afterwards, you may make any changes you like to the layout and
style, then enter START.  Unlike other mom documents, PRINTSTYLE is
not required\*[HANG .]
.
.NEWSLIDE
.
.ADD_SPACE 9p
.IB -1P+6p
.
.HEADING 1 \
  "The \s[-2]PAUSE\s[0] and \s[-2]NEWSLIDE\s[0] macros"
.SP .5v
.
.PP
Whenever you want a pause before revealing the next material on a
slide, enter the macro PAUSE on a line by itself.  If you want a
reveal effect that's different from the current one, you may pass
PAUSE the parameters of the new effect\*[HANG :]
.
.SP -1v
.PAUSE
.
.CODE_BLOCK
\&.PAUSE "Dissolve .4"
.CODE_BLOCK off
.
.PAUSE "Dissolve .4"
Notice that this material dissolves in, whereas before, new material
appeared from left to right.  \*[BU6]The new effect stays in force
until you change it again\*[HANG .]
.PAUSE "Wipe 1"
.PP
New slides are introduced with NEWSLIDE. \*[bu6]Transition effects
and parameters may be given to NEWSLIDE\*[HANG :]
.SP -1v
.
.CODE_BLOCK
\&.NEWSLIDE "Blinds .5"
.CODE_BLOCK off
.
.PAUSE
The next slide in this presentation will appear with the Blinds
effect\*[HANG .]
.BR
Consult man gropdf\c
\*[FU2]\*[UP 1p](\*[DOWN 1p]\*[BU2]1\*[UP 1p]\*[BU1])\*[DOWN 1p]
for all the pause/transition effects and their
parameters.\*[BU6]\*[UP 2p]\s[-2]*\s[0]
.SP 4p
.FT I
.PT_SIZE -2
*Note that not all PDF \*[BU6]viewers support every effect\*[HANG .]
.FT R
.PT_SIZE +2
.
.NEWSLIDE "Blinds .5"
.SLIDE_COLOR antiquewhite
.
.ADD_SPACE 9p
.
.HEADING 1 "Highlighting items
.SP .5v
.PP
The BOX macro lets you highlight items as they are revealed with
frames and shaded backgrounds\*[HANG .]
.PAUSE "Fade .5"
.BOX SHADED pink INSET 3p
.PP
This item is highlighted with a shaded background\*[HANG .]
.PAUSE
.PP
The highlight moves to each new item as it's revealed\*[HANG .]
.PAUSE
.PP
Highlighting can continue for as many slides as you want\*[HANG .]
.PAUSE
.PP
If there are no pauses on a slide, BOX can be used
.BR
to provide a background for all the items\*[HANG .]
.PAUSE
.PP
The SLIDE_COLOR macro lets you colour
.BR
the whole slide (q.v.)\*[HANG .]
.BOX off
.
.NEWSLIDE "Box 1 . O"
.SLIDE_COLOR off
.
.ADD_SPACE 9p
.
.HEADING 1 "Macros and preprocessors"
.SP .5v
.PP
Slides can make full use of all mom's document processing and
typesetting macros, including preprocessors and image insertion\*[HANG .]
.
.IBX CLEAR
.LS -4
.
.PAD "\
\*[FWD 4P+6p]\*[ST1]#\*[ST1X]\
\*[FWD 2P+6p]\*[ST2]\*[FWD 12P]\\*[ST2X]\
\*[FWD 3P+9p]\*[ST3]#\*[ST3X]\
\*[FWD 3P]\*[ST4]#\*[ST4X]\*[FWD 2P]"
.
.ST 1 L
.ST 2 C
.ST 3 C
.ST 4 C
.
.PAUSE "Fade .5"
.
.TAB 1
.PT_SIZE -1.5
.CENTER
\*[BD]\*[blue2]\*[DOWN 6p]tbl
.LEFT
.mk
.PT_SIZE -1
.COLOR blue2
.TS H BOXED
tab(^) allbox;
c c
n n.
\*[darkred]\s[-.5]\*[DOWN .5p]Year^Mean Temp.\s[0]\*[blue2]
_
.TH
\*[cyan4]\fB2015^28.3\*[blue2]
\*[cyan4]1998^28.3\*[blue2]
\*[cyan4]1997^28.3\*[blue2]
\*[cyan4]2010^28.1\*[blue2]
\*[cyan4]2002^28.1\*[blue2]
\*[cyan4]2005^28.0\*[blue2]
\*[cyan4]2014^27.9\*[blue2]
\*[cyan4]2009^27.9\*[blue2]
.TE
.
.rt
.PAUSE
.
.TN
.PT_SIZE +1
\*[FWD 10p]\*[DOWN 6p]pic
.COLOR green4
.SP 3p
.PS 2 LEFT
A: ellipse wid 0.5 ht 0.5
  arrow color "green4" up 0.2 from A.n
  arrow color "green4" up 0.2 right 0.2 from A.ne
  arrow color "green4" right 0.2 from A.e
  arrow color "green4" down 0.2 right 0.2 from A.se
  arrow color "green4" down 0.2 from A.s
  arrow color "green4" down 0.2 left 0.2 from A.sw
  arrow color "green4" left 0.2 from A.w
  arrow color "green4" up 0.2 left 0.2 from A.nw
.PE
.
.rt
.PAUSE
.
.TN
.COLOR blue2
\*[FWD 1p]\*[DOWN 6p]eqn
.FAMILY T
.PT_SIZE +3
.LS
.COLOR code-grey
.SP 4P
.EQ
f sub X (x) ^=^ left {
  rpile { 0 above 2x above 0 }
  ~~lpile { x < 0 above 0 <= x <= 1 above x > 1 }
.EN
.
.rt
.PAUSE
.
.TN
.FAMILY H
.PT_SIZE -3
.COLOR blue2
\*[DOWN 6p]pdf image\*[black]\*[PREV]
.SP 2P+6p
.PDF_IMAGE -C penguin.pdf 81p 96p FRAME
.TQ
.
.NEWSLIDE "Box 1 . O"
.ADD_SPACE 5p
.IB 10P
.PT_SIZE +1.5
.
.HEADING 1 "Printing handouts"
.SP .5v
.
.CODE_STYLE \
  COLOR BLACK \
  SIZE 120
.PP
Because slides contain pauses, they need a little help on their
way to the printer or they stop printing at the first pause\*[HANG .]
.PAUSE "Wipe 1"
.PP
Setting GROPDF_NOSLIDE=1 before invoking 
\[oq]\*[FU4]\*[CODE]\*[COND]pdfmom\*[CONDX]\*[CODE off]\*[FU4]\[cq]
or
\[oq]\*[FU2]\*[CODE]\*[COND]groff\~-Tpdf\*[CONDX]\*[CODE off]\*[FU6]\[cq]
disables the pauses\*[HANG :]
.
.SP -1v
.
.CODE_STYLE \
  COLOR code-grey \
  SIZE 110
.CODE_BLOCK
\*[COND]GROPDF_NOSLIDE=1 pdfmom <options> slide-file.mom\*[CONDX]
.CODE_BLOCK off
.
.PAUSE
The output may be piped directly to a printer or saved to a file\*[HANG .]
.PAUSE
.PP
See mom's html documentation and the gropdf\c
\*[FU2]\*[UP 1p](\*[DOWN 1p]\*[BU2]1\*[UP 1p]\*[BU1])\*[DOWN 1p]
manpage for complete information concerning slide usage\*[HANG .]
.
.SP 9p
.CENTER_BLOCK
.nr dcl-ind -1 1
.while \n[dcl-ind]<4 \{\
. DCL SOLID \n+[dcl-ind]P 9p 9p blue2
.\}
.CENTER_BLOCK off
.\" Local Variables:
.\" mode: nroff
.\" End:
.\" vim: filetype=groff: