R Users & R Markdown
Kyso is also designed for R users to also be able to publish their data-science reports.
When posting R markdown (
.Rmdfiles) to Kyso you will need to convert them to normal markdown (
.md) files before they hit Kyso. That can be before you upload them, or before you commit them to your Github repository.
When you convert Rmd to normal markdown it will create run the code in the Rmd file, generate any images and tables needed, create a markdown file and an assets folder for any image files. You can them upload the markdown and assts folder to Kyso.
Knitr is the package that we will use to convert the Rmd files to markdown in order to upload to Kyso, lets install it first using inside your R console:
In the directory of your .Rmd file just use the following command:
Rscript -e "library(knitr); knit('notebook.Rmd', 'notebook.md')"
Make sure you set the working directory to the location of your .Rmd files.
R Studio Interface
Once you have your working directory set go to your R console inside R studio and enter the following commands, first to load knitr and then to convert the notebook:
Compiling R markdown to markdown
When publishing to Kyso, be sure to select the generated .md file as the main file, not the .Rmd
Kyso now also supports HTML! This means R users are also able to compile their scripts to HTML. This will benefit those who like to work with interactive graphing libraries like plotly and bokeh.
Using the above example:
And then follow the link below to learn how to ensure a successful upload of HTML to Kyso: