OPEN PUBLISHING WITH

R & GITHUB

Neha Moopen

Research Data Manager

2023-03-09 / Publishing in Transition

SOME OF OUR OPEN BOOKS...

The Data Privacy Handbook

SOME OF OUR OPEN BOOKS...

Best Practices in Writing Reproducible Code

SOME OF OUR OPEN BOOKS...

Writing a Reproducible Manuscript in R with WORCS

HOW DOES IT WORK?

source: Hands-On Data Visualization in R
video: https://youtu.be/8uFABzUG6Lw

HOW DOES IT WORK?

source: Hands-On Data Visualization in R

1. Write the book using bookdown or Quarto in R.
    
2. Render the book to your preferred formats (HTML, pdf, Word).
    
3. You can deploy the HTML version as a website via GitHub.
    
4. The pdf version can be used for print publications.

WHY DID WE TAKE THIS APPROACH?

1. It's nicer to have a unified resource that we reuse for every workshop.
    
2. The HTML book allows us to integrate different types of content: text, slides, videos, code snippets.
    
3. GitHub is excellent for collaborative writing and version control.
    
4. GitHub also makes it easy to contribute to the book and get involved with the project, either through proposing content or opening 'Issues'.
    
5. Our course materials are always online and available to participants.
    
6. We've reused open materials and our content (and book structure) is under an open license as well.
    
7. TO-DO: Integrate with Zenodo and obtain a DOI.

WHat DO YOU NEED TO GET STARTED?

1. Familiarity with the RStudio interface.

2. Familiarity with Markdown syntax.

3. An understanding of the GitHub 'workflow'.

You do not need to be an experienced programmer! As long as you can read up on documentation for the tools and copy-paste / adapt the suggested code from the documentation a little bit - you'll be good to go!  
Feel free to contact me for an onboarding to these tools, a whole course may not be necessary :)

A TRULY COMMUNITY-DRIVEN BOOK

The Turing Way

THANKS!

Questions? You can reach me at: n.moopen@uu.nl