拡張機能

1 拡張機能とは

　Quartoには様々な拡張機能（extension）がある。RMarkdownの場合、Rパッケージによって追加された機能が、Quartoでは拡張機能として提供される。Rパッケージは一回インストールしておけば、同じPCでは継続して使える。一方、Quartoはプロジェクト単位で拡張機能を導入する必要があるのが面倒だが、パッケージに依存しないため、異なるPC環境でも使えると言ったメリットがある。

　2026年2月現在、百を超える数の拡張機能がある¹。 Quarto公式で開発した拡張機能もあれば、ユーザーが作成した拡張機能もある。CRANのように公式レポジトリを使用せず、GitHubを使用するため、LUA言語の知識があれば誰でも拡張機能を作成し、公に公開することができる²。

2 使い方

　拡張機能ごとに使い方が微妙に違ったりもするので、各拡張機能のGithubレポジトリのREADMEを参照されたい。拡張機能の全般的な管理方法については公式ホームページを参照されたい。

https://quarto.org/docs/extensions/managing.html

　ただし、拡張機能のインストール方法は全拡張機能共通である。プロジェクトを開いた状態でTerminalパネルに以下の入力する（Quartoの拡張機能はGitHub経由で公開されている）。

quarto add GitHubアカウント名/拡張機能のレポジトリ名

3 拡張機能の紹介

　ここでは宋が実際に使ったことのある拡張機能や、面白いと思った拡張機能をいくつか紹介する。

3.1 pointer

quarto add quarto-ext/pointer

---
title: タイトル
author: 著者名
format: 
  revealjs:
    ...
revealjs-plugins:
  - pointer
---

qキーでポインターモードの切り替え
YAMLヘッダーを修正するとカスタマイズ可能
- 以下は大きさを24（デフォルトは16）、ポインターの色を青に変更した例

---
title: タイトル
author: 著者名
format:
  revealjs:
    pointer:
      pointerSize: 24
      color: "blue"
revealjs-plugins:
  - pointer
---

3.2 lightbox

quarto add quarto-ext/lightbox

例1）lightbox適用有無を画像ごとに指定

---
title: タイトル
author: 著者名
format: 
  html:
    ...
filters:
   - lightbox
---

例2）全画像にlightboxを適用

lightboxを使うにはこちらを推奨

---
title: タイトル
author: 著者名
format: 
  html:
    ...
lightbox: auto
---

lightboxの無効化

Input:

![かわいいR猫](画像のパス or URL){.nolightbox}

Output:

画像のグループ化

Input:

::: {layout-ncol=4}
![零号機](画像のパス or URL){group="rcats"}

![初号機](画像のパス or URL){group="rcats"}

![弐号機](画像のパス or URL){group="rcats"}

![量産機](画像のパス or URL){group="rcats"}
:::

Output:

Input:

```{r}
#| label: fig-scatterplot-matrix
#| echo: false
#| fig-cap: 散布図行列の例
#| fig-subcap: 
#|   - mtcars
#|   - iris
#| fig-width: 7
#| fig-height: 7
#| layout-ncol: 2
#| lightbox:
#|   group: scatter-matrix
#|     - mtcarsの散布図行列
#|     - irisの散布図行列
plot(mtcars)
plot(iris)
```

Output:

3.3 qrcode

　簡単にQRコードを生成し埋め込む拡張機能。学会での発表用スライドに入れておくと便利

quarto add jmbuhr/quarto-qrcode

YAMLヘッダーの設定は不要

{{< qrcode https://www.jaysong.net >}}

3.4 countdown

　画面の右下にタイマーが表示してくれる。授業用スライドと相性が良いのでrevealjsと使用することを推奨。HTML文書にも使えるが、あまり意味はないかも。

quarto add gadenbuie/countdown/quarto

使うだけならYAMLヘッダーの設定は不要だが、YAMLヘッダーでカスタマイズ可能

## 今すぐQuartoをインストールしてください

5分30秒以内にインストールしないと流血事件が発生します

{{< countdown "5:30" >}}

3.5 embedio

ページ内にHTMLページ、スライド、動画、PDFを埋め込む

quarto add coatless-quarto/embedio

YAMLヘッダーの設定は不要

詳細はhttps://quarto.thecoatlessprofessor.com/embedio/を参照

3.6 webr

　HTMLページ上でRを動かす拡張機能。R教育時、簡単なコードの実習で使用

quarto add coatless/quarto-webr

---
title: タイトル
author: 著者名
format: 
  html:
    ...
filters:
  - webr
# 以下は不要だが、邪魔なWEBR STATUSがなくなる
webr: 
  show-startup-message: false
  show-header-message: false
---

「____」の箇所に正しいコードを入力してRun Codeをクリックしてみよう!

```{webr-r}
#| editor-font-scale: 0.75
#| fig-width: 6
#| fig-height: 3
#| out-height: 300px
#| out-width: 600px
#| editor-code-line-numbers: 2, 4
# Step 1: mu = 0, sd = 2の正規分布から乱数を20個抽出すし、my_vecに格納
my_vec <- _____
# Step 2: 横軸を1:20、縦軸をmy_vecとする折れ線グラフを作成する
plot(_____)
```

「____」の箇所に正しいコードを入力してRun Codeをクリックしてみよう!

3.7 metropolis-revealjs

　Beamer界隈で人気のテーマであるmetropolisをrevealjsで再現したテーマ

RStudioのTerminalペインに以下のコマンドを入力

quarto add shafayetShafee/metropolis-beamer

formatをrevealjsからmetropolis-beamer-revealjsへ変更

---
title: タイトル
author: 著者名
format: 
  metropolis-beamer-revealjs:
    ...
---

---
title: "My first reveal.js"
subtitle: "Metropolis theme"
author: "Jaehyun Song (Kansai University)"
date: today
format: 
  metropolis-beamer-revealjs:
    footer: Meow!
---

脚注

拡張機能のリストはhttps://quarto.org/docs/extensions/から確認できる。↩︎
公式に一報知らせたらリストにも掲載してくれるらしい。↩︎