forked from hplgit/MAlley-slide-templates
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.do.txt
152 lines (118 loc) · 10 KB
/
README.do.txt
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
## This is the description of the MAlley-slides-templates repo in
## DocOnce markup. Use the script README.sh to translate to Markdown
## for viewing on GitHub.
======= MAlley-slide-templates =======
This repository contains slide templates for Professor Michael Alley's famous
*assertion-evidence* slide design. This effective communication style
is described in the book "The Craft of Scientific Presentations: Critical Steps to Succeed and Critical Errors to Avoid": "http://www.amazon.com/Craft-Scientific-Presentations-Critical-Succeed/dp/1441982787/ref=sr_1_fkmr0_1?ie=UTF8&qid=1428766493&sr=8-1-fkmr0&keywords=the+cract+of+scientific+presentations", by Michael Alley, Springer, 2nd edition, 2013.
FIGURE: [doconce/fig-talk/Craft_of_Scientific_Presentations_2nd_cover_small, width=150]
!bquote
How to use? Simply copy the slide template for the slide format you want to use,
give the file a proper name, and fill in your own content!
!equote
===== Template contents =====
The slide template contains styles for the
* title slide
* mapping slide
* standard assertion-evidence slide
* summary slide
===== Slide formats =====
The slide template comes in several formats:
o Microsoft PowerPoint: "folder": "https://github.com/hplgit/MAlley-slide-templates/tree/master/PowerPoint" - "download for local viewing": "https://github.com/hplgit/MAlley-slide-templates/raw/master/PowerPoint/AE_presentation_template.ppt"
o LibreOffice/OpenOffice: "folder": "https://github.com/hplgit/MAlley-slide-templates/tree/master/LibreOffice" - "download for local viewing": "https://github.com/hplgit/MAlley-slide-templates/raw/master/LibreOffice/AE_presentation_template.odp"
o Apple Keynote: "folder": "https://github.com/hplgit/MAlley-slide-templates/tree/master/Keynote/AE_presentation_template.key" - "download for local viewing": "https://github.com/hplgit/MAlley-slide-templates/archive/master.zip"
o Google Presenter: "folder": "https://github.com/hplgit/MAlley-slide-templates/tree/master/Google%20Presenter" - "download": "https://raw.githubusercontent.com/hplgit/MAlley-slide-templates/master/Google%20Presenter/AE_presentation_template.gslides"
o LaTeX Beamer: "LaTeX source file": "https://github.com/hplgit/MAlley-slide-templates/blob/master/beamer/AE_presentation_template-beamer.tex" - "online viewing": "http://hplgit.github.io/MAlley-slide-templates/beamer/AE_presentation_template-beamer.pdf"
o HTML5 "reveal.js": "http://lab.hakim.se/reveal-js/#/": "HTML source file": "https://github.com/hplgit/MAlley-slide-templates/blob/master/html5/AE_presentation_template-reveal-white.html" - "online viewing": "http://hplgit.github.io/MAlley-slide-templates/html5/AE_presentation_template-reveal-white.html"
o HTML5 "deck.js": "http://imakewebthings.com/deck.js/": "HTML source file": "https://github.com/hplgit/MAlley-slide-templates/blob/master/html5/AE_presentation_template-deck-beige.html" - "online viewing": "http://hplgit.github.io/MAlley-slide-templates/html5/AE_presentation_template-deck-beige.html"
o "Remark": "http://remarkjs.com/#1": "Markdown source file": "https://github.com/hplgit/MAlley-slide-templates/blob/master/html/AE_presentation_template-remark.md" - "online viewing": "http://hplgit.github.io/MAlley-slide-templates/html/AE_presentation_template-remark.html"
o Plain HTML slides in "solarized colors": "http://ethanschoonover.com/solarized": "HTML source file": "https://github.com/hplgit/MAlley-slide-templates/blob/master/html/AE_presentation_template-solarized.html" - "online viewing": "http://hplgit.github.io/MAlley-slide-templates/html/AE_presentation_template-solarized.html"
o "DocOnce": "http://hplgit.github.io/doconce/doc/web/index.html": "DocOnce source file": "https://github.com/hplgit/MAlley-slide-templates/blob/master/doconce/AE_presentation_template.do.txt", translates to HTML, Beamer, Remark as above
===== How to download =====
=== Download everything ===
o Either dowload "zip file": "https://github.com/hplgit/MAlley-slide-templates/archive/master.zip" (see *Download ZIP* button to the right in this view), pack out the `master.zip` file, or
o clone/fork this Git repository:
!bc
git clone [email protected]:hplgit/MAlley-slide-templates.git
!ec
=== Download the format you want ===
* Binary slide files (PowerPoint, LibreOffice, Google Presenter): click *download for local viewing* and the file should download (if not, click on *folder*, then on the file, then on *Raw*, and if necessary, right-click to download the page), load the file into the software
* Keynote: click *download for local viewing*, pack out `master.zip` file, load `keynote/AE_presentation_template` into Keynote
* Pure (ascii) text file slides (reveal.js, deck.js, LaTeX Beamer, HTML, Remark, DocOnce): click on *source file*, click on *Raw*, and download that file
===== Brief description of formats =====
=== Interactive slide tools ===
Interactive slides tools offer a graphical user interface to design slides
in a visual way - you click and drag until you are satisfied. This is
user-friendly, and if slide elements are not perfectly postioned, it is easy
to graphically move them the way you want.
The support in interactive
tools for slides with much mathematics and computer code is modest.
There are LaTeX-based equation editors for PowerPoint and
LibreOffce, but they are tedious to use for large amounts of formulas.
Another (and often better)
solution is to convert each formula to an online picture using
URL: "http://www.codecogs.com/latex/eqneditor.php". Here you can copy
and paste existing formulas from LaTeX documents.
Computer code is not well supported in interactive tools.
Syntax highlighting is impossible and you are left with setting the
code in monospace font manually. Consequently, slides with much mathemtics and
computer code look much better in markup languages like LaTeX,
HTML, Markdown, or DocOnce.
Tools for interactive slide design include "Microsoft PowerPoint": "http://en.wikipedia.org/wiki/Microsoft_PowerPoint", Apple's "Keynote": "http://en.wikipedia.org/wiki/Keynote_(presentation_software)", "OpenLibre Impress": "https://www.libreoffice.org/discover/impress/", "OpenOffice Impress": "https://www.openoffice.org/product/impress.html", and
"Google Presenter": "http://computers.tutsplus.com/tutorials/getting-started-with-google-slides--cms-21359" (Google slides). The latter is very easy to
use and has recently become very popular because of its features
for online collaboration, though PowerPoint and Keynote
are technically more advanced tools than Google Presenter.
##MOVIE: [https://www.youtube.com/watch?v=RrpjzquqUIo] Google presentation tutorial
"Google Presenter video": "https://www.youtube.com/watch?v=RrpjzquqUIo] Google presentation tutorial"
=== Markup-based slide tools ===
Slides can alternatively be designed using a markup language, e.g.,
"LaTeX": "http://en.wikipedia.org/wiki/LaTeX", "HTML": "http://en.wikipedia.org/wiki/HTML", "Markdown": "http://en.wikipedia.org/wiki/Markdown", or "DocOnce": "http://hplgit.github.io/doconce/doc/web/index.html".
Instead of clicking on an italic button
to get italic text in an interactive slide tool, one writes instead plain text `<em>some text</em>` in HTML,
`\emph{some text}` in LaTeX, or
`*some text*` in Markdown and DocOnce. The whole slide presentation is a plain
text file with instructions (markup) and slide contents.
A main problem with markup languges is that you
have much less control of where slide elements appear on the slide compared
with the interactive, visual tools. However, markup languages have some
important advantages:
* excellent support for mathematics and computer code
* sometimes quicker writing (especially in Markdown and DocOnce)
* easy to generate slides from existing papers and books
* easy to change notation, terms, etc. in a large set of slides
For at least two decades, "LaTeX Beamer":
"http://en.wikipedia.org/wiki/Beamer_(LaTeX)" has been a dominating
tool for writing slides with mathematics and computer code. Recently,
LaTeX Beamer has experienced considerable competition from
"reveal.js": "http://lab.hakim.se/reveal-js/#/" and to some extent
"deck.js": "http://imakewebthings.com/deck.js/". Both these tools are
based on modern HTML5 and CSS technology and combine in some way the
strength for mathematics and computer code from LaTeX Beamer with the
visual appearance of PowerPoint, Keynote, OpenOffice/LibreOffice,
and Google Presenter.
Especially in more mathematically or computer science oriented
communities, there is significant use of LaTeX Beamer and reveal.js,
with the Markdown-based "Remark": "http://remarkjs.com/#1" tool as a
new interesting alternative coming up (Markdown-based tools are
gaining increasing popularity in general).
__Remark about markup-based slides in this repository.__
The HTML, reveal.js, deck.js, Remark, and LaTeX Beamer slides in this
repository were all *automatically generated* from "slides in DocOnce
format":
"https://github.com/hplgit/MAlley-slide-templates/blob/master/doconce/AE_presentation_template.do.txt". So
to write LaTeX Beamer slides, one can either write directly in LaTeX
markup, or one can write in "DocOnce markup":
"http://hplgit.github.io/doconce/doc/pub/slides/index.html" and
automatically translate to LaTeX Beamer. The advantage of writing in
DocOnce is that one can easily generate reveal.js, deck.js, Remark,
and plain HTML slides as well. That feature gives you the possibility to
use Beamer for live presentations, but publish the talk online in (e.g.)
reveal.js format.
=== Author ===
The content of this repository was created by Hans Petter Langtangen ("hplgit": "https://github.com/hplgit"), Simula Research Laboratory and Unviersity of Oslo, Norway. Please send comments on typos or improvements in this description to him at "[email protected]": "mailto:[email protected]". All templates are based on PowerPoint slides made by Professor Michael Alley.
FIGURE: [doconce/fig-talk/simula_logo, width=200]
=== How to contribute ===
Do you see better technical solutions in some slide set? Fork the project
and send a pull request if you implement improvements! Or make an issue about
a question or problem setting "here on GitHub": "https://github.com/hplgit/MAlley-slide-templates/issues".