Bioconductor/BiocWorkshops

Using a single chapter?

mtmorgan opened this issue · 1 comments

How can I use a single chapter, e.g., the 100 series introduction? By 'use' I mean both tell my audience 'do XXX' (git clone would be acceptable, but not cloning the whole book) and also for me tweaking the material for a particular presentation (e.g., removing the intro to R section of the 100 workshop).

My hack was to copy the file & supporting material to a new git repository, but of course now I've got two slightly different versions and some extra work to merge changes back.

Hi Martin, @mtmorgan
It's hard to do anything without cloning the entire repo first. If your users will only need the Rmd
file the best bet is to just download the file from the GitHub website. Note that these Rmd files don't
work very well as standalone files because they're part of the book so you'd have to include a number
of additional files to build the book or provide the yaml front matter.

If you already have the repository cloned, you can distribute a portion of the repository using
something like:

git archive --format tar HEAD 100_Morgan_RBiocForAll* > ~/mtmworkshop.tar.gz

ALSO
You could render a single chapter preview_chapterand provide the output but this won't allow your
audience to work with the source code.

There's also git submodules but I'm not sure if this is the right way to go...