Summary Files Commits Branches @commit @diff @stats
path: root / src / slides / demo
diff options
context:
space:
mode:
Commitad4e84fa7e269a9a5ec74572b5a495c47527f6aa (patch)
Author
 Syndamia <kamen@syndamia.com>
2023-09-28 12:51:33 +0300
Committer
 Syndamia <kamen@syndamia.com>
2023-09-28 12:51:46 +0300
Files48fa7e683cd69d002021ff6daa319da22bdf811b /src/slides/demo
syndamia.com-ad4e84fa7e269a9a5ec74572b5a495c47527f6aa.tar
syndamia.com-ad4e84fa7e269a9a5ec74572b5a495c47527f6aa.tar.gz
syndamia.com-ad4e84fa7e269a9a5ec74572b5a495c47527f6aa.zip
Parent25ee133d16996a254c11e169faeb0859b8e871e7 (diff)
[slides] Renamed talks to slides
1 files changed, 265 insertions, 0 deletions
-rw-r--r--src/slides/demo/index.md265
diff --git a/src/slides/demo/index.md b/src/slides/demo/index.md
new file mode 100644
index 0000000..ebe95bb
--- /dev/null
+++ b/src/slides/demo/index.md
@@ -0,0 +1,265 @@
+# Demo presentation
+
+This is a small presentation, explaining how my custom system for making presentations works.
+
+&&presentation
+
+&&clide &&font35 &&centered
+
+# My presentation system
+&&font18 *Syndamia AT [syndamia.com](https://syndamia.com)* &&/font
+
+Before we go any further, click the **icon in the middle** right above this rectangle, to the left.
+
+Now the presentation should fill out the entire page. On the bottom right are your controls.
+
+Press the *right arrow* in the controls to go to the next slide.
+
+&&/centered &&/font &&/clide
+
+
+
+&&slide &&font27
+
+# Key bindings
+
+&&lineb3
+
+|Action |Keyboard keys |
+|--------------------|-------------------------------------------------|
+|Go to previous slide| Backspace, Page up, Left arrow, Up arrow |
+|Go to next slide | Space, Enter, Page down, Right arrow, Down arrow|
+|Toggle presenting | P, T |
+|Stop presenting | Esc |
+|Go to first slide | Home |
+|Go to last slide | End |
+
+&&/font &&/slide
+
+
+
+&&slide
+
+# Introduction
+
+&&lineb1
+
+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.
+
+## ftags
+
+An ftag (["format tag"](https://gitlab.com/Syndamia/syndamiadotcom/-/tree/master/awk-edits#ftags)) is what I call a short string of characters, that starts with two ampersands (&&).
+Each ftag is a "marker" that gets replaced by some other text (usually [HTML tags](https://en.wikipedia.org/wiki/HTML)).
+
+An easy example is the image of the Great Britain flag (part of [Flags.awk](https://gitlab.com/Syndamia/syndamiadotcom/-/blob/master/awk-edits/Flags.awk), not the presentation system!): typing out &&GB (in lowecase), gets replaced by the actual image - &&gb.
+
+&&/slide
+
+
+
+&&slide
+
+## Why?
+
+- Programs like Microsoft PowerPoint and LibreOffice Impress have very poor compatibility, between programs, versions, languages and even operating systems.
+ A web-based solution is significantly more consistent and flexible.
+
+- Ideally, the system would be made well enough that creating a presentation would be significantly faster than with one of those.
+
+- Making my own system means I can tailor it to my needs and preferences.
+ Looking around other [HTML-based presentation tools](https://gist.github.com/vasilisvg/1611562):
+ + [reveal.js](https://revealjs.com/) is way too heavy and fancy for my needs (animations are nice, but I'm fine going without them)
+ + [DZSlides](https://paulrouget.com/dzslides/) and [S5](https://meyerweb.com/eric/tools/s5/) are really nice, however both are HTML-centric, and I want my slides to be written in Markdown.
+ Creating ftags that are transformed to DZSlide HTML is possible, but at that point I should just make my own system.
+ + and pretty much everything else falls into either category
+
+&&/slide
+
+
+
+&&slide
+
+# Formatting
+
+Every (presentation-specific) ftag is listed and explained in [Presentation.awk](https://gitlab.com/Syndamia/syndamiadotcom/-/blob/master/awk-edits/Presentation.awk).
+To summarize, each slide is wrapped in `&&slide` and `&&/slide` (or `&&clide` and `&&/clide`), you can change font size for specific portions, you can add basic (without formatting) tables for fancy layout, you can align text and elements and you can add line breaks.
+
+And they can work together in most different combination.
+
+&&lineb1
+
+Though, remember that everything gets translated to HTML, so don't do (even if it works)
+
+```
+&&slide &&font20 &&/slide &&/font
+```
+
+Enough talking, here are examples!
+
+&&/slide
+
+
+
+&&slide
+
+&&font18 Font-size 18px &&/font
+&&font20 Font-size 20px &&/font &&font22 Font-size 22px &&/font &&font25 Font-size 25px &&/font
+Font-size 30px (default)
+&&font35 Font-size 35px &&/font
+
+&&lineb5
+
+&&fright
+This text is floated to the right
+&&/fright
+
+&&lineb2
+
+&&centered While this one is centered &&/centered
+
+&&lineb2
+
+&&fright Floated right<br>Floated right<br>Floated right &&/fright
+
+But you may realize that text floated to the right will make other text wrap around it!
+Maybe this should be changed?
+
+&&/slide
+
+
+
+&&slide &&font18
+
+The source Markdown for the predvious slide (without the pipes to the left) is:
+
+```
+&&slide
+
+&&font18 Font-size 18px &&/font
+&&font20 Font-size 20px &&/font &&font22 Font-size 22px &&/font &&font25 Font-size 25px &&/font
+Font-size 30px (default)
+&&font35 Font-size 35px &&/font
+
+&&lineb5
+
+&&fright
+This text is floated to the right
+&&/fright
+
+&&lineb2
+
+&&centered While this one is centered &&/centered
+
+&&lineb2
+
+&&fright Floated right<br>Floated right<br>Floated right &&/fright
+
+But you may realize that text floated to the right will make other text wrap around it!
+Maybe this should be changed?
+
+&&/slide
+```
+
+&&/font &&/slide
+
+
+
+&&clide &&table
+
+You can also easily tabularize
+
+&&cont &&fright
+
+- List Element 1
+- List Element 2
+
+&&/fright &&/cont
+
+&&tarow
+
+**any** sort of content
+
+&&/table
+
+&&lineb1
+
+&&ftable
+
+So you can very easily put images next to your text
+
+&&centered ![](/tutorials/fix-no-frame-buffer-plan9/img/rio-default-login.png =120x) &&/centered
+
+&&/table &&/clide
+
+
+
+&&slide &&font18
+
+The source Markdown for the predvious slide (without the pipes to the left) is:
+
+```
+&&clide &&table
+
+You can also easily tabularize
+
+&&cont &&fright
+
+- List Element 1
+- List Element 2
+
+&&/fright &&/cont
+
+&&tarow
+
+**any** sort of content
+
+&&/table
+
+&&lineb1
+
+&&ftable
+
+So you can very easily put images next to your text
+
+&&centered ![](/tutorials/fix-no-frame-buffer-plan9/img/rio-default-login.png =120x) &&/centered
+
+&&/table &&/clide
+```
+
+&&/font &&/slide
+
+
+
+&&slide &&font27
+
+# 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.
+
+Pretty much all other website functionalities, like themes and click-to-zoom images, aren't inhibited.
+The slides are easily scrollable/browseable and if you don't have JavaScript enabled, everything will be shown as a normal(-ish) article, without any *major* styling issues.
+
+## Setup
+
+Everything is contained in 3 files: [Presentation.awk](https://gitlab.com/Syndamia/syndamiadotcom/-/blob/master/awk-edits/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), which pretty much work on your "compiled" HTML.
+
+`Presentation.awk` handles replacement of ftags (only in `/talks` pages!).
+`presentation.js` is inserted into the HTML by `&&presentation`, and handles the navigation bar as well as insertion of `presentation.css` (the overall presentation-specific styling).
+
+&&/font &&/slide
+
+
+
+&&clide
+
+&&centered
+# Thats All. Thank you for your time!
+&&/centered
+
+&&fright &&font18
+*P.S. Press the same button (next to the print button) with which you started presenting, to stop presenting ;)*
+&&/font &&/fright
+
+&&/clide