See https://teachbooks.tudelft.nl/jupyter-book-manual/intro.html

Interesting to look into, e.g., for learnr: https://shiny.posit.co/py/docs/shinylive.html

Add as a chapter, to reduce manual work re-building the site every time a change is made. And maybe for other things? :)

Current slides are in English, not sure if it's easier to follow if we translate to Dutch?

Issue originally opened by @nehamoopen

I would consider following the chapter structure from rstudio4edu for bookdown books and tailor it for ourselves also considering our approach in the Reproducible Manuscripts workshop:

• Introduction
• Make A Book
• Make It Yours
• Caring For Your Book
• Dress It Up
• Make It Fancier

Followed by:

More specifically (in no specfic order):

• Build a Quarto book
• Write in Markdown
• Embedding different types of content (images, videos, slides, documents)
• Cite / Bibliography Management using Zotero
• Structuring Parts / Chapters / Subchapters in TOC
• Rendering to HTML / pdf / docx
• Integrating with GitHub (initial + maintenance workflow)
• Deploying with GitHub Pages
• Automating Rendering with GitHub Actions
• Integrating with Zenodo for FAIRification
• Basic theme customization with CSS / HTML
• Interactivity with webexercises and learnr
• HTML interactivity with drop-down sections etc.

I think all of this is now included in the skeleton but opening this issue anyhow

• When to use this solution, and when not to?
• Comparison with the other open textbooks solution?
• Maybe give some examples of nice Quarto / online books hosted on GH pages?

I've updated the structure of the workshop a bit, also based on some feedback from Neha. Now git is not mentioned anywhere before the first break, but the Markdown section is shortened a lot and put in the first section instead. The slides with the writing hand ✍️ indicate practical work/exercises, but for some exercises the instructions are really long. Not sure if that's an issue, but if you have ideas to either change/improve the exercises, move them, or remove them, feel free to change it. An entire content check from you both would be nice so that we're all on the same page!

Open textbooks with Quarto on GitHub Pages - 7  Interactivity

https://utrechtuniversity.github.io/open-textbooks/interactivity.html

As this current repository is meant for the open-textbooks book, and the nehamoopen/lets-git-started repo was made solely for EduSupport's learning journey, perhaps that would be a better location to put the slides for the Education Support workshop. In that case the slides can also be rendered with GitHub pages so they are available online.

I currently don't have writing access to that repo, and neither does Kim. If we decide to do this it would be great if we got it in case of last-minute changes.