Stencila for R
Install
This package isn't on CRAN yet, but you can install it from this repository using the devtools
package,
devtools::install_github("stencila/r")
Alternatively, check the releases page for prebuilt versions.
Then install the package so that other Stencila packages and applications can detect it:
stencila:::install()
Note Installing Stencila package for R may take a while as there are a number of dependencies which need to be installed.
Use
This package lets you run R code from inside Stencila Documents. When you start the Stencila Desktop it will be automatically detect the installed R package and you'll be able to execute R code cells from within your documents.
Check out what people are doing with Stencila and R - Giulio Valentino Dalla Riva has created Tiny Open Access Data Samples (TOADS). These awesome open datasets teach programming and statistics using Stencila. Check out the TOADS!
More documentation is available at https://stencila.github.io/r
Discuss
We love feedback. Create a new issue, add to existing issues or chat with members of the community.
Develop
Most development tasks can be run using make
shortcuts or RStudio keyboard shortcuts.
Task | make |
RStudio |
---|---|---|
Install dependencies | make setup |
|
Run tests | make test |
Ctrl+Shift+T |
Run tests with coverage | make cover |
|
Build documentation | make docs |
|
Check the package | make check |
Ctrl+Shift+E |
Build | make build |
Ctrl+Shift+B |
Clean | make clean |
To get started, please read our contributor code of conduct, then get in touch or checkout the platform-wide, cross-repository kanban board, or just send in a pull request!
Unit tests live in the tests
folder and are mostly written using testthat
. Documentation is written using roxygen2
and the documentation site is generated by pkgdown
into the docs
folder and published on Github pages.
Tests are run on Travis and code coverage tracked at Codecov.