OPEN PUBLISHING WITH
R & GITHUB
Neha Moopen
Research Data Manager
2023-03-09 / Publishing in Transition
SOME OF OUR OPEN BOOKS...
SOME OF OUR OPEN BOOKS...
SOME OF OUR OPEN BOOKS...
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
- Write the book using bookdown or Quarto in R.
- Render the book to your preferred formats (HTML, pdf, Word).
- You can deploy the HTML version as a website via GitHub.
- The pdf version can be used for print publications.
WHY DID WE TAKE THIS APPROACH?
- It's nicer to have a unified resource that we reuse for every workshop.
- The HTML book allows us to integrate different types of content: text, slides, videos, code snippets.
- GitHub is excellent for collaborative writing and version control.
- GitHub also makes it easy to contribute to the book and get involved with the project, either through proposing content or opening 'Issues'.
- Our course materials are always online and available to participants.
- We've reused open materials and our content (and book structure) is under an open license as well.
- 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
THANKS!
Questions? You can reach me at: n.moopen@uu.nl