pandoc-slide-filter/README.md

# pandoc-slide-filter

Collection of pandoc-filters for our reveal-js slides.

## How to build

1. [install stack](https://haskell-lang.org/get-started) and do a `stack setup`
2. clone this repository
3. do a `stack build` or `stack install`

`stack build` builds the files but leaves them in `.stack-work/dist/$OS/Cabal-$Cabalversion/build/$exe-dir/$exe-name`.
`stack install` installs them into `$HOME/.local/bin` (or similar on other OSes).

## What is what?

### Media

support for

- `![](foo.aac){#audio}`
- `![](foo.mp4){#video}`
- `![](foo.png){#img}`
- `![](foo.svg){#svg}`
- `![](foo.html){#demo}`
- Automatic detection of filetypes based on file-extensions
  - Id's may be changed/omitted in this case

### Styling

support for

- `<div id="col" .w50></div>`
- better code-blocks
- `<div class="fragment"></div>` region revealed after click
- `<div class="frame"></div>` region revealed and then vanishes on next click
- `[]{.fragment}` same for inline-objects
- `[]{.frame}` same for inline-objects
- `[]{#hspace width=100px}` manual spacing
- `[]{#vspace height=100px}` manual spacing

### Quiz

support for

- `[answer-text [with some hover-tooltip]{.tooltip}]{.answer .right width=100px}`
- `[answer-text [and even $\latex$]{.tooltip}]{.answer .wrong}`
- `[simple answer]{.answer .right}`

Note: Tooltip-Syntax has changed.

### Cols

This filter makes multi-column-layouts out of lvl-x-headings

Syntax is

```
## a b
```

yielding a 2-column-layout with aspects a:b i.e. 1:1 for 50/50-layout
or 8:2 for 80/20 layout

currently works for 2 and 3-columns, but extension is straight-forward.

If you need multiple Block-Elements inside one column, just wrap them
with a `<div>` or wait for [#168](https://github.com/jgm/pandoc/issues/168):

```
## 2 5

<div>
multiple things

- foo
- bar

![image](...)
</div>

second column here with only 1 element.
```


### Clean

Small filter for cleaning empty Blocks if they get generated by accident.