Dissemination using Quarto and Github Pages

Overview

This book outlines how you can combine Quarto - a new version of R Markdown - with Github Pages to create an online profile and disseminate your work. You will learn about writing online books, sharing reproducible presentations, and creating websites and blogs.

There are alternative options to all of these outputs, but once you are comfortable with the workflow of Quarto and github, you will have a flexible toolkit to manage and share all your outputs in one place. Once you render your book/presentation/website and push any changes to github, you get a URL to share with anyone.

For early career researchers, a website or blog is important for people finding out about you and your work. Before you have the opportunity to publish papers, you will probably have more conference presentations. The ability to share your presentation with a URL will provide more reach than your title and abstract in a programme. For more experienced academics, you might run courses where you want to develop your own materials for your students or share your materials with your peers. An online book is great for impact and sharing your work as wide as possible.

The PDF version of this book was last updated on 28th March 2025.

Intended Learning Outcomes (ILOs)

By the end of the workshop/book, you will be able to:

• Use the basic functions of git and github to commit changes and host your materials using github pages.

• Create an online book using Quarto or the PsyTeachR booktem R package in RStudio.

• Create reproducible presentations using Quarto to combine text, images, and code.

• Create a simple website and/or blog using Quarto to share your profile and outputs.

• Communicate your ideas to your target audience using features such as Markdown formatting, code chunks, referencing, glossaries, and interactive questions.