Radionice – Workshop Slide Decks

This repository contains a collection of slide decks written in Markdown and compiled to PDFs (and optionally handouts) for a variety of workshops. The slides are organised under the slides/ directory – each sub‑folder represents a different workshop and contains a single .md file along with any required images or resources.

Quick start

# List available make targets
make

# Build all PDFs (default theme: Warsaw Beamer)
make pdfs

# Remove generated PDFs
make clean

The Makefile uses pandoc with the beamer template. If you prefer a different theme, edit the pandoc options in the Makefile.

Directory layout

slides/
├─ 3Dprint
│  ├─ 3DPrint.md
│  └─ pics/…
├─ algebragrupe
│  └─ algebragrupe.md
├─ ansible
│  ├─ ansible.md
│  └─ examples/…
└─ … (other workshops)

Each workshop folder contains:

• A single Markdown file (e.g. ansible.md).
• A pics/ or examples/ directory with images or code snippets.

Building requirements

Tool	Purpose	Debian	Arch
pandoc	Markdown → PDF	sudo apt install pandoc	pacman -S pandoc
tikzit	Optional diagram support	sudo apt install tikzit	pacman -S tikzit
texlive-*	LaTeX backend for beamer	sudo apt install texlive-binextra texlive-pictures texlive-latexrecommended texlive-fontsrecommended	pacman -Sy texlive-core texlive-latexrecommended texlive-fontsrecommended

You can also install the full texlive bundle if you prefer.

How to create a new slide deck

1. Create a folder under slides/ with a descriptive name.
2. Add a YourWorkshop.md file with the Markdown content.
3. Add any images or auxiliary files into a pics/ or examples/ sub‑folder.
4. Run make to see the new target or make pdfs to build PDFs.

Contributing

Pull requests are welcome. Please keep Markdown styling consistent and ensure all images are correctly linked. If you add a new workshop, update the README section above if necessary.

License

This repository is licensed under the GPL‑v3.

---

© 2024 Radionice. All rights reserved.