Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kleidukos/munihac-2024-effectful
https://github.com/kleidukos/munihac-2024-effectful
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/kleidukos/munihac-2024-effectful
- Owner: Kleidukos
- Created: 2024-09-08T16:51:13.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-10-16T10:26:41.000Z (2 months ago)
- Last Synced: 2024-10-18T02:50:31.165Z (2 months ago)
- Language: HTML
- Size: 512 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Template for markdown-to-dzslides decks
The goal of the template is to allow a minimal markdown input, with
sensible defaults. The goal is to not have to update the `template.html`
file and work as much as possible in the `slides.md` file.
## How to build
Make sure you have `pandoc` available.
make slides # will generate a regular HTML file usable
# locally, with notes hidden
# perfect for presenting.
make standalone # will generate a self-contained HTML file
# without note.
make with-notes # will genrate a self-contained HTML file
# with notes displayed on the side.
## How to present
`slides.html` can be opened directly, but if you have proper multi-screen
support, you can open `onstage.html` instead, which will give you a presenter
screen.
## Default layouts
A single top-level title on a slide will be centered vertically.
```markdown
---
# Slide title
---
```
A top-level title followed by content will be displayed at the top of the screen,
while the following content will be centered vertically in the remaining space.
```markdown
---
# Slide title
Slide contents
---
```
Content with the `jumbo` CSS class will be enlarged to take the full available width.
Multiple jumbo lines have to be grouped in a single `jumbogroup` container.
```markdown
---
# [This is important]{.jumbo}
---
```
```markdown
---
::: jumbogroup
## [First line]{.jumbo}
## [Second line]{.jumbo}
:::
---
```
Images put within a `bigimage` container will take the full available space.
```markdown
---
:::bigimage
:::
---
```
## Document metadata
The markdown files where slides are defined contains a _yaml front matter_ section, with
medatada. The supported fields are:
- `title (string)`: the talk title, used in `` and the auto-generated title slide
- `author (author block/array[author block])`: containing information about the author
- `name (string)`: displayed on the title slide and the author slide
- `desc (string / array[string])`: displayed on the author slide
- `overlay (string)`: text displayed on the bottom right of all slides (except title & author slides).
- `light`: when present, will switch to a light theme
- `ratio43`: when present, will switch to a 4/3 ratio (instead of the 16/9 default).