rlugojr / knitr-jekyll

Automatically knit R Markdown documents, build them with Jekyll, and serve the website with servr locally

Update (2017/02/06): if you are interested in building a website using R Markdown, I strongly recommend you to take a look at the blogdown package. The method introduced in this repo still works, but blogdown is much more powerful thanks to Hugo and Pandoc.

---

This is a minimal example of a Jekyll-based website using knitr and R Markdown. The interesting bit of this repo is that you can actually serve the Jekyll website locally with R, and R Markdown posts can be compiled automatically, with the web pages automatically refreshed as well.

After you are satisfied with the local preview, you can either just push the Markdown blog posts to your Github repo (e.g. the gh-pages branch), and let Github generate the website for you, or host the HTML files generated under the _site/ directory on your own server.

The original website was created from jekyll new . under the root directory, which was part of the official Jekyll repo. The additional code (R, Makefile) in this repo is under the MIT License, and the blog post I wrote is under the CC-BY 4.0 International License.