layout | title | root |
---|---|---|
page |
Overview |
. |
Research compendium template for tracking, linking, and sharing data explorations
It is difficult to manage a linked collection of R notebooks.
bookdown is great except for a few key downsides arising from the fact that chapters are concatenated on render so that chunk labels cannot be duplicated, selective caching becomes difficult, and there can be no chapter level knitr hooks.
-
rmarkdown
files are only re-built if they have changed since the last rebuild -
turn off chapter/page evaluation (or message printing) with a single
knitr
hook -
a
looseleaf
build will continue despite evaluation errors -
keep track of
R
package dependencies inDESCRIPTION
https://jsta.github.io/looseleaf
-
Clone this repo
-
Do not edit the auto-generated files in
_site
-
Create an Rmd file with the yaml header and chunk options in the provided template
-
Add CRAN and Github package dependencies to DESCRIPTION
-
Call
make looseleaf-md
from the command line (see required R packages for all projects in setup.md) -
Render to html (3 options)
-
locally using
make serve
(see optional system dependencies in setup.md) -
remotely for public repos by enabling Github pages
-
remotely for private repos by building a zip file on Gitlab CI (see
.gitlab-ci.yml
)
-