summaryrefslogtreecommitdiff
path: root/macros/context/contrib/context-simpleslides/README.md
blob: e5cb4dc088ce59d849acd4a3cb28ba06d0959431 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
# context-simpleslides

SimpleSlides presentation module for ConTeXt<br>
by Aditya Mahajan and Thomas A. Schmitz
maintained by Henning Hraban Ramm since 2022


## Introduction

This module is meant to facilitate writing presentations in ConTeXt. It
provides a consistent interface and macros; there are different styles which
give different output. The module has been written for projector-based
presentations, so elements which are typical for screen presentations (such
as interactive hyperlinks or tables of contents) are not included.
The module is meant for an academic environment, specifically in the humanities.
Hence, it has the following characteristics:

* The look is rather sober. In academia, presentations are not meant to showcase fancy TeX effects; nothing should divert the audience’s attention from the content.
* The module is written for slides which exhibit text and/or images. From my own experience with TeX-based presentations, I have provided a setup for horizontal (landscape) pictures and for vertical (portrait) pictures, which are accompanied by an area for explanatory text.
* A simple switch in the module setup command will produce different output.
* It is easy to customize the module or to add more styles.

The macros are commented rather extensively to give users (especially users
relatively new to ConTeXt) the chance to understand the mechanisms and
create their own styles. Of course, I did not invent this code on my own. My
thanks are due, as always, to Hans Hagen, whose presentation modules in the
ConTeXt core have been a wonderful source of inspiration, to Mojca
Miklavec, who provided help with Metapost, and to Aditya Mahajan, who helped
tremendously in cleaning up the code and making the user interface more
consistent.

Thomas A. Schmitz

## Installation

The directories of this repository belong in one of the `texmf` trees,
e.g. `texmf-local`, `texmf-project` or `texmf-modules`.

It makes sense to clone it as `t-simpleslides` and merge it with the other modules,
as outlined on the [wiki](https://wiki.contextgarden.net/Modules#ConTeXt_LMTX).

Afterwards run `mtxrun --generate` to refresh the file database.

To update, run `git pull` and `mtxrun --generate` again.

## Example

```
\usemodule[simpleslides][
    style=BigNumber,
    % available options depend on the style
    color=red,
    %alternative=square, % "Framed" only
    font=Gothic,
]

\setupTitle
  [title={Presentation Title},
   author={F.~Author, S.~Another},
   date={Date / Occasion}]

\setupexternalfigures[location={local,global,default}]

\starttext

\placeTitle


\SlideTitle{Make Titles Informative}

\startitemize
  \item Use bullets points when appropriate.
  \item Use pictures when possible
  \item Do not put too much information on one slide
\stopitemize

\IncludePicture
  [horizontal]
  [cow] % Name of the image
  {A Dutch Cow} % Title of the slide

\IncludePicture
  [horizontal]
  [cow] % Name of the image
  [highlight=yes,
   grid=yes]
  {A Dutch Cow with a grid} % Title of the slide

\IncludePicture
  [horizontal]
  [cow] % Name of the image
  [highlight=yes,
   grid=yes,
   steps=5, % Each grid block is broken into these many parts.
   subgrid=yes]
  {A Dutch Cow with a fine grid} % Title of the slide

\IncludePicture
  [horizontal]
  [cow] % Name of the image
  [highlight=yes,
   grid=yes,
   subgrid=yes,
   alternative=circle,
   color=orange,
   x=1.4,
   y=8.2,
   xscale=1.5,
   shadow=bottomleft]
  {The head of a dutch cow}


\IncludePicture
  [horizontal]
  [cow] % Name of the image
  [highlight=yes,
   grid=no,
   subgrid=no,
   alternative=circle,
   color=orange,
   x=1.4,
   y=8.2,
   xscale=1.5,
   shadow=bottomleft]
   {The head of a dutch cow}

\IncludePicture
  [horizontal]
  [cow] % Name of the image
  [highlight=yes,
   grid=no,
   subgrid=no,
   alternative=arrow,
   color=orange,
   x=0.4,
   y=6.8,
   direction=-90,
   length=3cm,
   shadow=topright]
   {The mouth of a dutch cow}

\IncludePicture
  [horizontal]
  [cow] % Name of the image
  [highlight=yes,
   grid=no,
   subgrid=no,
   alternative=focus,
   color=orange,
   x=1.4,
   y=8.2,
   xscale=1.5,
   opacity=0.5]
   {The head of a dutch cow}

\IncludePicture
  [vertical]
  [mill]
  [width=\NormalWidth]
  {The windmills are an example of a green energy source.}

\SlideTitle{Summary}

\startitemize
  \item The {\em first main message} of your talk in one or two lines.
  \item The {\em second main message} of your talk in one or two lines.
  \item Perhaps a {\em third message}, but not more than that.
\stopitemize

\stoptext
```