workshop-ngsintro 
This repo contains the course material for NBIS workshop Introduction to Bioinformatics using NGS data. The rendered view of this repo is available here.
Contributing
To add or update contents of this repo (for collaborators), first clone the repo.
git clone --depth 1 --single-branch --branch master https://github.com/nbisweden/workshop-ngsintro.git
Make changes/updates as needed. Add the changed files. Commit it. Then push the repo back.
git add .
git commit -m "I did this and that"
git push origin
If you are not added as a collaborator, first fork this repo to your account, then clone it locally, make changes, commit, push to your repo, then submit a pull request to this repo.
❗ When updating repo for a new course, change output-dir: XXXX in _quarto.yml
as the first thing, so that old rendered files are not overwritten.
❗ Do not push any rendered .html files or intermediates.
Local build/preview using Docker
You can preview changes and build the whole website locally without a local installation of R or dependency packages by using the pre-built Docker image.
❗ Note: Large image size: 4.68GB.
Clone the repo if not already done. Make sure you are standing in the repo directory.
To build the complete site,
docker run --rm -u $(id -u ${USER}):$(id -g ${USER}) -v ${PWD}:/qmd ghcr.io/nbisweden/workshop-ngsintro/workshop-ngsintro
To build a single file (for example index.qmd),
docker run --rm -u $(id -u ${USER}):$(id -g ${USER}) -v ${PWD}:/qmd ghcr.io/nbisweden/workshop-ngsintro/workshop-ngsintro quarto render index.qmd
❗ Output files are for local preview only. Do not push any rendered .html files or intermediates.
Repo organisation
The source material is located on the master branch (default). The rendered material is located on the gh-pages branch. One only needs to update content in master. Changes pushed to the master branch is automatically rendered to the gh-pages branch.
❗ Every push rebuilds the whole website using a docker image. Build takes about 4-5 mins.
Test scripts
This is regarding the directory scripts. This directory contains shell scripts for reseq (variant-calling) and rnaseq parts of the workshop. These are intended to be run on UPPMAX. Further instructions on using them are available within the scripts.
The contents of these scripts should use identical steps and tools as the student would use in the lab. The aim of these scripts is to execute them on UPPMAX before the course. This should provide insight into broken links, broken tools, tool incompatibilities, core usage, ram usage and total space used.
The scripts directory is not used in this repo, tutorial or the website. It's just here as a backup.
2023 • NBIS • SciLifeLab