Summary Files Commits Branches @commit @diff @stats
path: root / src / talks / demo.md
blob: 7640979aabb86a1bcc134d9c3e7a72a4def98572 (plain) (blame)
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
# Demo presentation

[Slides Source](https://gitlab.com/Syndamia/syndamiadotcom/-/blob/master/src/talks/demo.md) || [PDF version](/files/slides/Demo%20presentation%20-%20Syndamia.pdf)

**Created: 27 September 2022** || **Edited: 28 September 2022**

This is a small presentation, explaining how my custom system for making presentations works.

&&presentation

&&slide &&flexer
&&centered &&font35

# My presentation system

&&/font

<br>

&&font20

Before we go any further, click the **icon, next to the printer** right above this rectangle.

Now the presentation should fill out the entire page. On the bottom right are your controls.

Press the *right arrow* to go to the next slide.

&&/font
&&/centered
&&flexer

&&font18 kamen AT [syndamia.com](https://syndamia.com) || 2022 &&/font

&&/slide



&&slide

# Introduction

I created a simple system for making presentations with slides in them. The gist of it is: different [Markdown](https://en.wikipedia.org/wiki/Markdown) paragraphs are put into a rectangle, each rectangle representing a slide, with some added options for layout and format. In a bit more detail, we'll have to get familiar with

## ftags

An ftag is a short string of characters, that starts with two ampersands (&&) and contains only letters, numbers, hyphen, underscore and forwardslash. The concept has probably been created before, but I came up with it on my own. The name comes from ["format tags"](https://gitlab.com/Syndamia/syndamiadotcom/-/tree/master/generate-hooks#ftags).

The idea is that, whenever I want some sort of script to parse/format text, I use ftags as markers. Depending on the script, every ftag is replaced in the resultant webpage with other text or [HTML code](https://en.wikipedia.org/wiki/HTML).

An easy example is the image of the Great Britain flag: at the end of this sentence, I have simply tiped out &&GB (in lowecase), and it gets replaced with the corresponding image - &&gb.

## Why?

Programs like Microsoft PowerPoint and LibreOffice Impress have very bad compatibility issues, between programs, versions, languages and even operating systems. As to why I don't just use a ready web presentation tool like [reveal.js](https://revealjs.com/), I find most of those too heavy and feature-bloated for my needs.

&&/slide



&&slide

# Formatting

Every (presentation-specific) formatting option is listed and explained in the [`create-presentation.awk`](https://gitlab.com/Syndamia/syndamiadotcom/-/blob/master/generate-hooks/create-presentation.awk) script, but to summarize: you can modify

- font size
- text alignment
- row and column arrangement of paragraphs

And they can work together in every possible combination. Here is an example which uses most of those in one place:

&&flexer

&&frow

&&font18 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc sed lectus porttitor nibh pellentesque ultrices ut in lorem. Pellentesque commodo dignissim placerat. &&/font

&&fcol &&font27

These

words

&&centered are in an &&/centered

ftag column.

&&/font &&/fcol
&&flexer

&&fright
Vestibulum sodales pharetra justo, placerat egestas arcu hendrerit vitae. Integer eros est, lobortis sit amet mollis nec, mollis in ex. In hac habitasse platea dictumst.
&&/fright

![](/tutorials/fix-no-frame-buffer-plan9/img/rio-default-login.png)

&&/frow

&&flexer

&&/slide



&&slide

# Other features

As you've obviously noticed, the presentation "system" also adds a navigation bar, with which to present and navigate slides. You can also print very easily the whole presentation on A4 sheets of paper, since that's the exact size of each slide.

Given that the Markdown itself isn't touched, changing themes is no problem. Finally, because again, if you don't have JavaScript enabled, the presentation will be shown as any other ordinary article!

## Closing remarks

Although it doesn't have every feature known to man, this system is still very capable, and it's contained in just three files: [`create-presentation.awk`](https://gitlab.com/Syndamia/syndamiadotcom/-/blob/master/generate-hooks/create-presentation.awk), [`presentation.js`](https://gitlab.com/Syndamia/syndamiadotcom/-/blob/master/src/scripts/presentation.js) and [`presentation.css`](https://gitlab.com/Syndamia/syndamiadotcom/-/blob/master/src/presentation.css).

&&flexer

&&centered
# Thats All. Thank you for your time!
&&/centered

&&flexer

&&fright &&font18
*P.S. Press the same button (next to the print button) with which you started presenting, to stop presenting ;)*
&&font18 &&/fright

&&/slide