nwstephens / rmd2ppt Goto Github PK

You can create PowerPoint presentations from R Markdown files using RStudio. Warning: This feature is experimental; do not attempt current or production systems. The following instructions have been tested for Linux.

Pandoc now has support the PowerPoint format (as of v2.0.6). The current version of RStudio (v1.1) bundles Pandoc v1, but the next major release of RStudio (v1.2) will bundle Pandoc 2. In the meantime, you will need to manually install and link to the latest version of Pandoc. Warning: Changing the location of your Pandoc installation may break your code and your system; do not attempt unless you are comfortable with making changes to Pandoc.

# Install Pandoc release
version=2.1.3
sudo wget https://github.com/jgm/pandoc/releases/download/$version/pandoc-$version-linux.tar.gz -P /opt
sudo tar xzvf /opt/pandoc-$version-linux.tar.gz -C /opt
sudo rm /usr/local/bin/pandoc
sudo ln -s /opt/pandoc-$version/bin/pandoc /usr/local/bin/pandoc

# Install Pandoc nightly
sudo wget https://github.com/pandoc-extras/pandoc-nightly/releases/download/hash-c24ecf9cd/pandoc-amd64-c24ecf9cd.zip -P /opt
sudo unzip pandoc-amd64-34d8ffbcf.zip
sudo rm /usr/local/bin/pandoc
sudo ln -s /opt/pandoc-amd64-34d8ffbcf/pandoc /usr/local/bin/pandoc

You can always check what version of Pandoc you have in R by running > rmarkdown::pandoc_version().

You should also upgrade the rmarkdown and knitr packages. You will want to install the webshot package so you can take screenshots of your Shiny apps and include them in your presentations.

install.packages('rmarkdown')
install.packages('knitr')
install.packages("webshot")
webshot::install_phantomjs()

RStudio v1.2 contains additional user features for creating PowerPoint presentations. Currently, the features RStudio v1.2 will recognize Pandoc 2 if it already installed. You will still need to manually install Pandoc v2 in order to see the PowerPoint features in RStudio v1.2. You can upgrade to the latest version of RStudio by downloading and installing the daily builds. Warning: RStudio v1.2 is still in development; if you want to test PowerPoint with a stable release then use Pandoc v2 with RStudio v1.1.

This repository contains demos for creating PowerPoint presentations from R Markdown. All standard markdown format is supported in the PowerPoint output, as well as some nice features like templating. Here is a partial list of features included in the PowerPoint translation::

• Bullets and numbering
• Equations
• Code blocks
• Text formatting
• Tables
• Linked images
• Multiple columns
• Templates
• Presenter notes

See the Pandoc manual for specific support options. Note that if you want to change the slide dimensions or any other aesthetics, you should make those changes in the PowerPoint template.