# GitHub repo for Slides (for Meetups)

**URL:** <https://forum.ansible.com/t/github-repo-for-slides-for-meetups/45281>\
**Category:** Meetup Discussions\
**Tags:** cfgmgmgtcamp, meetup, in-person-event, mindshare\
**Created:** [February 6, 2026, 9:26am UTC](https://forum.ansible.com/t/github-repo-for-slides-for-meetups/45281 "2026-02-06T09:26:52Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![gundalow](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gundalow/32/99_2.png) [@gundalow](https://forum.ansible.com/u/gundalow)\
**Post date:** [February 6, 2026, 9:26am UTC](https://forum.ansible.com/t/github-repo-for-slides-for-meetups/45281/1 "2026-02-06T09:26:52Z")

</div>

During [CfgMgmtCamp 2026](https://forum.ansible.com/t/cfgmgmtcamp-2026/44250) we recognized that we finding speakers and speakers creating presentations takes times, and that as a global community we often end up creating similar presentations.

We discussed and thought it might be useful to have a GitHub repository for slides to either use directly, or adjust. We agreed that we needed text-based slides (rather than PDFs) so we can edit. I had previously used [Reveal.js](https://revealjs.com/) and found it easy to create good slides, and allows community contribution.

## Reveal.js example

> reveal.js is an open source HTML presentation framework. It’s a tool that enables anyone with a web browser to create fully-featured and beautiful presentations for free.

You can use html directly, or have the slides (and speaker notes) in markdown, ie

```html
<section data-markdown>
  <textarea data-template>
    ## Slide 1
    A paragraph with some text and a [link](https://example.com).
    notes: Embedded speaker notes can be included
    ---
    ## Slide 2

    ---
    ## Slide 3
  </textarea>
</section>

```

- Web-Native: No software dependencies, works on any device
- Offline: If we add the CSS & JavaScript into the repo it works offline, which is important for many venues where there can be wifi restrictions.
- Version Control: Git-based collaboration and improvement
- Responsive Design: Works on laptops, tablets, and presentation screens
- Interactive Elements: Code highlighting, live demos, embedded content
- Easy Sharing: Direct URLs for slides and individual sections

## Slides

I’ve got some old slides I’ll convert to the new version of Reveal.js and upload soon

## Discussion

1. Could this be useful?
2. Do you think this could help our meetups, would you be happy to present at your [local Ansible meetup](https://www.meetup.com/pro/ansible)?
3. Would you be interested in contributing slides you’ve previously created (I’m happy to help convert from PDF to Reveal.js)

[@MeetupOrganisers](https://forum.ansible.com/groups/meetuporganisers) @toshywoshy @tonk

---

<div class="post-metadata">

**Author:** ![tonk](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/tonk/32/214_2.png) [@tonk](https://forum.ansible.com/u/tonk)\
**Post date:** [February 6, 2026, 9:43am UTC](https://forum.ansible.com/t/github-repo-for-slides-for-meetups/45281/2 "2026-02-06T09:43:48Z")

</div>

Yes, totally agree.

But, I am not a big fan of writing HTML, so I mostly use Asciidoctor with revealjs.  
I’ll see if I can create a simple framework, if that can help.

---

<div class="post-metadata">

**Author:** ![gundalow](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gundalow/32/99_2.png) [@gundalow](https://forum.ansible.com/u/gundalow)\
**Post date:** [February 6, 2026, 10:01am UTC](https://forum.ansible.com/t/github-repo-for-slides-for-meetups/45281/3 "2026-02-06T10:01:53Z")

</div>

> [@tonk](#):
>
> But, I am not a big fan of writing HTML,

Likewise, though the markdown style is easy. The HTML is common across all slides so we can boiler plate thet, you can just use markdown for the rest, with `---` as the divider between slides.

Example: [contributing-to-ansible.html · GitHub](https://gist.github.com/gundalow/c26a41f7c60caa5d5e417b9b1dc8e429#file-contributing-to-ansible-html-L26-L92)

## Official docs

- [Markdown | reveal.js](https://revealjs.com/markdown/) How to use simple markdown
- [https://revealjs.com/code/](https://revealjs.com/code/) How to format code

---

<div class="post-metadata">

**Author:** ![gundalow](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gundalow/32/99_2.png) [@gundalow](https://forum.ansible.com/u/gundalow)\
**Post date:** [February 6, 2026, 5:18pm UTC](https://forum.ansible.com/t/github-repo-for-slides-for-meetups/45281/4 "2026-02-06T17:18:24Z")

</div>

OK, that didn’t take long to get working, I just converted my old Contributing to Ansible deck (will need a technical review of the content, though it’s close enough)

- [Rendered slides](https://ansible-community.github.io/presentations/slides/contributing-to-ansible.html)
  - Press `s` for speaker notes
  - Press `esc` for filmstrip view

- [Source](https://github.com/ansible-community/presentations/blob/main/slides/contributing-to-ansible.html)
  - Start 30 lines of common HTML (Only the `<title>` needs to change
  - Markdown for slides
  - End 30 lines of HTML & JS

---

<div class="post-metadata">

**Author:** ![tonk](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/tonk/32/214_2.png) [@tonk](https://forum.ansible.com/u/tonk)\
**Post date:** [February 6, 2026, 5:31pm UTC](https://forum.ansible.com/t/github-repo-for-slides-for-meetups/45281/5 "2026-02-06T17:31:48Z")

</div>

That looks good. And so quick 😄

---

<div class="post-metadata">

**Author:** ![gundalow](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gundalow/32/99_2.png) [@gundalow](https://forum.ansible.com/u/gundalow)\
**Post date:** [February 8, 2026, 6:57pm UTC](https://forum.ansible.com/t/github-repo-for-slides-for-meetups/45281/6 "2026-02-08T18:57:02Z")

</div>

It people have existing slides they are happy to contribute, please let me know and I’ll convert them to RevealJS for you.