GitHub repo for Slides (for Meetups)

Events Meetup Discussions
, , ,
1

During CfgMgmtCamp 2026 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 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

<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?
  3. Would you be interested in contributing slides you’ve previously created (I’m happy to help convert from PDF to Reveal.js)

@MeetupOrganisers @toshywoshy @tonk

3 Likes
Improving Ansible Meetups
2

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.

1 Like
3

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

Official docs

1 Like
4

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
    • Press s for speaker notes
    • Press esc for filmstrip view
  • Source
    • Start 30 lines of common HTML (Only the <title> needs to change
    • Markdown for slides
    • End 30 lines of HTML & JS
5

That looks good. And so quick :smile:

1 Like