RStudioとRMarkdownで作るPowerPointプレゼンテーション

## はじめに

※この記事は[Rendering PowerPoint Presentations with RStudio – RStudio Support](https://support.rstudio.com/hc/en-us/articles/360004672913-Rendering-PowerPoint-Presentations-with-RStudio)を元ネタとして要約したり補足したりしたものです。

最近のPandocのアップデートによって、markdownからPowerPointプレゼンテーションの生成が可能になりました。

~~RStudioからこの機能をつかうためには、バージョン2.xのPandocがバンドルされているプレビュー版のRStudio（[RStudio Preview - RStudio](https://www.rstudio.com/products/rstudio/download/preview/)）が必要です。~~RStudio 1.2がリリースされたので、プレビュー版は必要なくなりました。[Download RStudio - RStudio](https://www.rstudio.com/products/rstudio/download/)からダウンロードできます。

また、`rmarkdown`パッケージを最新版にしておきましょう。

```r
install.packages("rmarkdown")
```

## .Rmdの作成とレンダリング

R MarkdownからPowerPointプレゼンテーションを出力するためには、YAMLフロントマターでoutputに`powerpoint_presentation`を指定します。

```r
---
title: "Untitled"
output: powerpoint_presentation
---
```

あるいは、File > New File > R Markdown > Presentationと選択すると、中にPowerPointという選択肢がありますので、これを選べばテンプレートから作成することもできます。

まずはテンプレートをそのままKnitしてPowerPointファイルを生成してみましょう。RStudioを使っている場合は、Knitボタンまたは`Command+Shift+k`（Windows/Linuxなら`Ctrl+Shift+k`）でPowerPointファイルを生成できます。または、次のコマンドを実行してKnitすることもできます。

```r
rmarkdown::render("in.Rmd", output_format = "powerpoint_presentation")
```

次のような.pptxファイルが生成されましたか？

![image.png](https://qiita-image-store.s3.amazonaws.com/0/109348/a30aa5c8-f122-95ba-e545-0fb7596cb881.png)


## Markdown記法の利用

PandocのMarkdown（[Pandoc - Pandoc User’s Guide](https://pandoc.org/MANUAL.html#pandocs-markdown)）でサポートされている要素のほとんどはPowerPointに出力することができます。例を見てみましょう。

```markdown
### Markdownの基本的な記法

- 箇条書き
  - *イタリック*
  - **太字**
  - ~~取り消し線~~
  - ~下付き~ `inline code` ^上付き^
  - $y = ax + b$
```

上記の記述を含むファイルをKnitすると次のようなスライドが生成されます。

![image.png](https://qiita-image-store.s3.amazonaws.com/0/109348/cc46c391-a256-2e8c-eb48-a8e409101614.png)


このような一般的な要素のほとんどはPowerPointの対応する要素に変換されています。そのため、出力された.pptxファイルを開いてテーマを適用したり、スタイルを編集したりした場合に変更が適切に反映されます。

さらに、スライド作成に有用な次のような記法もサポートしています。

### 画像とテーブル

画像はスライドサイズに合うように自動的に調整されます。キャプションを入れた場合は画像の下に表示されます。また、必要であれば画像とキャプションのそれぞれにリンクを設定することもできます。

```markdown
### images

![caption](path/to/image.jpg)
```

![image.png](https://qiita-image-store.s3.amazonaws.com/0/109348/a3199953-b15c-7a74-9c59-1cbc60ed5f65.png)

テーブルを挿入した場合、テンプレートのスタイルが自動的に適用されます。また、キャプションも追加できます。

```markdown
### table

| hoge | fuga | piyo |
|:---- |:----:| ----:|
| foo  | bar  | baz  |

Table: this is caption
```

![image.png](https://qiita-image-store.s3.amazonaws.com/0/109348/f87f687a-ffa7-57fd-e655-a9db02bf71d3.png)


**画像とテーブルは必ず新しいスライドに配置される**、という点に注意して下さい。画像やテーブルと共存可能な要素は、ヘッダーとキャプションだけです。

ただし、次に説明する2カラムレイアウトを利用すればテキストと画像やテーブルを共存させられます。

### 2カラムレイアウト

画像の横に説明を入れるようなレイアウトはPowerPointではありがちです。これは、div記法を使うことで実現できます。

具体的には、2つのdivを含むdiv要素を作成し、外側のdivには`columns`クラスを、内側のdivには`colmn`クラスを設定します。

```markdown
::::::::::::::: {.columns}
::: {.column}
- 何らかの説明
- 何らかの説明2
- 何らかの説明3
:::

::: {.column}
![hoge](fig/icon.jpg)
:::
::::::::::::::::::::::::::
```

![image.png](https://qiita-image-store.s3.amazonaws.com/0/109348/fc84bc2b-b170-f813-c35e-a68a4d7a4d05.png)

### ノート

ノートも作成できます。

ノートの内部でもいくつかの記法は使えますが、もともとノート内はそれほど柔軟に書式設定できるわけではない、という点に注意して下さい。設定できるのは、ボールド、斜体、箇条書きといったごく限られた書式のみです。

```markdown
::: notes
This is a speaker note.

- Use basic Markdown
- like this list
- *and inline formatting*
:::
```

![image.png](https://qiita-image-store.s3.amazonaws.com/0/109348/5b2fffa1-a02a-f36d-209f-dabbade315fe.png)


## テンプレート

デフォルトでは、4:3の画面サイズで標準の質素なテンプレートが適用された.pptxファイルが出力されます。これが気に入らない場合は、YAMLフロントマターでテンプレートを指定することができます。テンプレートに指定するファイルは、次の4つのレイアウトを最初の4つのレイアウトとして含む必要があります。

- タイトルスライド（Title Slide）
- セクション見出し（Section Header）
- タイトルとコンテンツ（Title and Content）
- 2つのコンテンツ（Two Content）

最近のバージョンのPowerPointに含まれているテンプレート、あるいはそれを編集したテンプレートであれば、おそらく問題なく使えるでしょう。

```markdown
---
title: "Untitled"
author: '@nozma'
date: "3/6/2019"
output: 
  powerpoint_presentation:
    reference_doc: templete.pptx
---
```

![image.png](https://qiita-image-store.s3.amazonaws.com/0/109348/9e309035-3811-0884-782a-ae9f6097e9af.png)


## 構造化

PowerPointプレゼンテーションにはタイトル、セクション、コンテツスライドといった階層構造があります。Markdownにも`#`, `##`, `###`といったヘッダの階層構造があります。

デフォルトでは、コンテンツスライドのヘッダに対応付けられるヘッダのレベルは、テキスト内での使われ方に応じて自動的に設定されます。すなわち、ヘッダに続く要素が次のレベルの他のヘッダではなく、コンテンツ本体（例えば箇条書き）であるようなヘッダのレベルがスライドのヘッダに対応付けられます。例えばテキスト内で`#`しか使っていなければ、`#`がスライドのヘッダに対応付けられる、というわけです。

スライドヘッダに対応するヘッダレベルは、YAMLフロントマターで任意に設定することもできます。

```r
---
title: "slide title"
output:
  powerpoint_presentation:
    slide_level: 3 # ← この場合は ### がスライドヘッダになります
---
```

スライドヘッダに対応するヘッダのレベルに対して、他のレベルのヘッダは次のように振る舞います。

- スライドヘッダレベルと等しい...常に新しいスライドが始まる
- スライドヘッダレベルより上位...セクション見出しが挿入される
- スライドヘッダレベルより下位...スライド内部の見出しとして使われる

また、水平線`---`は常に新しいスライドを開始します。

## Rコードチャンク

当然ですが、Rのコードの実行結果をスライドに含めることもできます。

### テーブル

データフレームはそのままでは整形されず、ターミナルへの出力と同じ形式で表示されます。

PowerPointのテーブル形式で出力したければ、`knitr::kable()`を使いましょう。

```r
knitr::kable(head(mtcars, 3))
```

![image.png](https://qiita-image-store.s3.amazonaws.com/0/109348/f15089a7-dda8-3a80-8c9c-d3eb9934c009.png)

### プロット

プロットは自動的にスライドサイズに合う画像として挿入されます。画像サイズを変更したければ`fig.width`や`fig.height`というチャンクオプションを調整してみると良いでしょう。

![image.png](https://qiita-image-store.s3.amazonaws.com/0/109348/43d146f6-0659-6237-6ced-6b113f6ff754.png)


### Webサイト

HTML WidgetやShinyは`webshot`パッケージ（[CRAN - Package webshot](https://cran.r-project.org/web/packages/webshot/index.html)）とPhantomJS（[PhantomJS - Scriptable Headless Browser](http://phantomjs.org/)）を使うことでスクリーンショットをスライドに取り込むことができます。

まずは`webshot`とPhantomJSをインストールしましょう。

```r
install.packages("webshot")
webshot::install_phantomjs()
```

両者がインストールされていれば、あとは普通にコードチャンクを書くだけです。試しに`leaflet`パッケージで地図を入れてみましょう。

```r
library(leaflet)
leaflet() %>% 
  addTiles() %>% 
  setView(-122.36075812146, 47.6759920119894, zoom = 13) 
```

![image.png](https://qiita-image-store.s3.amazonaws.com/0/109348/95d69275-c402-6309-2f2f-11fd1f4664b3.png)


Webサイトの読み込みに時間がかかって上手くスクリーンショットが撮影できない場合は、チャンクオプションでディレイを設定すると良いかもしれません。

```r
{r screenshot.opts=list(delay=1)}
```