Presentation slides for the neutronics-workshop

There are three slide decks, one for each variant of the workshop:

Deck	Markdown source	Built HTML
Full day course	slides-full-day.md	full-day.html
Half day university	slides-half-day-university.md	half-day-university.html
Half day conference	slides-half-day-conference.md	half-day-conference.html

All three decks share the images in the images/ folder.

View the slides

The slides are available in html format here. The landing page (index.html) links to each of the three decks.

GitHub Pages serves the built HTML files directly from the root of the main branch. There is no automated build step, so editing a slides-*.md file and pushing it will not update the live site on its own. To publish a change you must:

1. Edit the Markdown source (slides-*.md).
2. Rebuild the HTML locally with ./build.sh (see below).
3. Commit the regenerated .html files along with the Markdown.
4. Push to main. GitHub Pages picks up the new HTML within a minute or so.

Build the slides yourself

The slides are written in an extended MarkDown format. Marp is needed to convert the Markdown files into pdf or html files and is available in the following forms:

• command line interface
• VS Code extension enable html in the extension settings
• docker image
• online webapp

To build all three decks at once (using the Marp Docker image, so no local Node.js install is needed) run:

./build.sh

This produces full-day.html, half-day-university.html and half-day-conference.html. The --html flag is required (and is set in build.sh) because the decks use raw HTML for multi-column layouts. The index.html landing page is hand written and is not regenerated by the build.