Skip to main content

Aspirational & Useful: deck.rb with RStudio/knitr & Go2Shell

There has been some interest in the recent release of RStudio 0.96 and especially the ability to use combine its knitr Markdown functionality with Pandoc to integrate R and a variety of different documents types.

I just wanted to add two quick things (one mostly aspirational, the other useful)

Aspirational: Markdown/Ruby/deck.js

I am currently using this combination to put together a presentation based on a recent working paper. Maybe out of procrastination I decided to see if there was any way to use knitr/Markdown to write a deck.js presentation. I generally prefer deck.js to the three Pandoc HTML presentation types (slidy, S5, and dzslides).

Deck.js presentations are a pain to write, so it would be great if there was a program like Pandoc that could quickly convert a Markdown file into a deck.js presentation.

I discovered that there kind of is. There is a ruby program called deck.rb. The Markdown syntax is really simple and would be familiar to Pandoc users (individual slides are demarcated with the first level header #).

After you install deck.rb in the terminal with the usual:

    sudo gem install deckrb

you can easily build presentations in the command line with:


However, I’ve classified this as aspirational since it lacks a lot of functionality that Pandoc has, including:

  • There really aren’t title slides.

  • The slideshow opens as a locally hosted webserver, and the command to build a stand alone HTML presentation doesn’t seem to work that well (hence no example included with this post).

  • It only allows you to use the Swiss template.

  • I couldn’t figure out how to easily get MathJax support to display equations.

Maybe I won’t use use deck.rb for this presentation, but I will keep an eye on any developments.

Useful Tip: Command Line/Go2Shell

Since I’m on about the terminal and command line, I thought I might mention a small (free) program that is very helpful: Go2Shell. It is a little Mac application that only opens a new terminal window from the folder that you currently have open.

Very useful for easily setting your terminal working directory when, for example, making Pandoc presentations.


Yihui Xie said…
I'm also looking for a good markdown-to-deck.js conversion tool. If you find one some day, please let me know or write a blog post on it. Thanks!
Unknown said…
I'll definitely post anything that I find.

And thanks for putting together knitr!
Ramnath said…
Check out slidify - An R package designed to make it easy to generate reproducible HTML5 slides, using knitr and R markdown. (
Alex Chaffee said…
I wrote deck.rb and I agree with all your feature requests -- I don't have a lot of time to work on the tool right now, but I'm open to patches or even persistent nagging :-)

Any idea on how to implement the last one? I'm using RedCarpet with markdown extensions; maybe there's one for equations, or maybe we can roll our own.
Alex Chaffee said…
"There aren't really title slides" -- If a slide contains only a single H1 then it gets really big... I agree that's not quite a title slide, but can you tell me more how you think a real title slide would work?

Popular posts from this blog

Dropbox & R Data

I'm always looking for ways to download data from the internet into R. Though I prefer to host and access plain-text data sets (CSV is my personal favourite) from GitHub (see my short paper on the topic) sometimes it's convenient to get data stored on Dropbox . There has been a change in the way Dropbox URLs work and I just added some functionality to the repmis R package. So I though that I'ld write a quick post on how to directly download data from Dropbox into R. The download method is different depending on whether or not your plain-text data is in a Dropbox Public folder or not. Dropbox Public Folder Dropbox is trying to do away with its public folders. New users need to actively create a Public folder. Regardless, sometimes you may want to download data from one. It used to be that files in Public folders were accessible through non-secure (http) URLs. It's easy to download these into R, just use the read.table command, where the URL is the file name

Slide: one function for lag/lead variables in data frames, including time-series cross-sectional data

I often want to quickly create a lag or lead variable in an R data frame. Sometimes I also want to create the lag or lead variable for different groups in a data frame, for example, if I want to lag GDP for each country in a data frame. I've found the various R methods for doing this hard to remember and usually need to look at old blog posts . Any time we find ourselves using the same series of codes over and over, it's probably time to put them into a function. So, I added a new command– slide –to the DataCombine R package (v0.1.5). Building on the shift function TszKin Julian posted on his blog , slide allows you to slide a variable up by any time unit to create a lead or down to create a lag. It returns the lag/lead variable to a new column in your data frame. It works with both data that has one observed unit and with time-series cross-sectional data. Note: your data needs to be in ascending time order with equally spaced time increments. For example 1995, 1996

A Link Between topicmodels LDA and LDAvis

Carson Sievert and Kenny Shirley have put together the really nice LDAvis R package. It provides a Shiny-based interactive interface for exploring the output from Latent Dirichlet Allocation topic models. If you've never used it, I highly recommend checking out their XKCD example (this paper also has some nice background). LDAvis doesn't fit topic models, it just visualises the output. As such it is agnostic about what package you use to fit your LDA topic model. They have a useful example of how to use output from the lda package. I wanted to use LDAvis with output from the topicmodels package. It works really nicely with texts preprocessed using the tm package. The trick is extracting the information LDAvis requires from the model and placing it into a specifically structured JSON formatted object. To make the conversion from topicmodels output to LDAvis JSON input easier, I created a linking function called topicmodels_json_ldavis . The full function is below. To