An Easy Start with Jekyll, for R-Bloggers

[This article was first published on R Contour - R, and kindly contributed to R-bloggers]. (You can report issue about the content on this page here)
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

I would like my upper-level students to get more practice in writing about their data analysis work (well, to get get more practice in writing, generally). Blogging is one device by which students can be motivated to write carefully, with a particular audience in mind. So why not have students blog about aspects of their R-work?

Students need cheap hosting: as long as they know their way around git and Git Hub, then Git Hub Pages are a great (free) solution for that. But then of course they have to use Jekyll, think about web design issues, etc., and on top of that if they plan to blog seriously about R they are probably going to want to write from an R Markdown source document rather than from Markdown.

All of this requires a lot of thinking about technical tools, at a time when students should focus as much as possible on fundamentals. Learning R is already enough of a technical challenge! Hence I decided to cobble together a framework that flattens the learning curve for students as much as possible.

Yihui Xie’s servr package and knitr-jekyll code are a great way to address the R Markdown issue and to keep Jekyll in the background.

The remaining concern is site layout and styling. For this I chose to work from Mark Otto’s excellent Hyde project.

I added a few bells and whistles in the form of options for Disqus commenting and a couple of social media share buttons. It ain’t much but it will get the students going, I hope.

And it occurs to me that if you yourself are not yet a blogger then you might want to give my system a try. The project repository is here, The resulting site (with directions for use) is here.

In the future it would be interesting to investigate more modular ways of hooking Xihui’s knitr-jekyll to other Jekyll projects, e.g., Octopress. If you are aware of any efforts along these lines, please let me know.

To leave a comment for the author, please follow the link and comment on their blog: R Contour - R.

R-bloggers.com offers daily e-mail updates about R news and tutorials about learning R and many other topics. Click here if you're looking to post or find an R/data-science job.
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

Never miss an update!
Subscribe to R-bloggers to receive
e-mails with the latest R posts.
(You will not see this message again.)

Click here to close (This popup will not appear again)