This workshop teaches best practices for Research Data Management with DataLad. Content for this workshop was developed by the DataLad team, while the workshop infrastructure is based on materials developed by The Carpentries (distributed under a CC-BY license).
For extensive information on how the Carpentries Lesson styles template is set up and how to customize it, see: https://carpentries.github.io/lesson-example/index.html.
The _config.yml file in the repo root allows several options for customization.
The carpentry variable is set to swc (line 10), meaning that for any updates where
we want DataLad-specific content to display we will have to ensure these are edited wherever swc-specific logic occurs.
Edit the index.md file in the repo root.
Add a Markdown file per new episode in the _episodes directory.
The _episodes/01-formatting.md file can be used as a template for new
episodes, as it already contains examples of most formatting options /
components that will likely be needed.
Prepend sequential numerical values to the filename in order to specify episode order.
Episodes will automatically appear in order as part of the schedule on the main page.
To preview the changes locally, follow the instructions from Carpentries lesson example.
Short version:
# Install:
sudo apt-get install ruby ruby-dev build-essential libxml2-dev
gem install bundler --user-install
# Add ~/.local/share/gem/ruby/2.7.0/bin to path, as per printed message
# In the root of the repository (once) to install dependencies
bundle update
# Start the server
make serveThe slides are placed in files/slides-org-reveal.
Html files (based on the reveal.js framework) can be viewed directly in the web browser.
Slide content was written in org mode (org files are also included)
and converted using org-reveal to produce html output.
This repo's design was adapted from The Carpentries lesson styles template (licensed under CC BY 4.0.)
The RDM training material itself was created by the DataLad team, either in full, or adapted from existing openly available material.
Sources include:
These training materials were developed with funding from the Deutsche Forschungsgemeinschaft (DFG, German Research Foundation) under grant SFB 1451 (431549029, INF project).