Quarto shortcodes

Quartoの拡張機能の一つShortcodeの解説
Quarto
Published

August 8, 2024

Modified

December 7, 2024

Quarto shortcodesは、Quartoの拡張機能の一つで.qmdファイル内に記述することで、 特別なデータを参照したり、コンテンツを埋め込んだりすることができる。

Shortcodes – Quarto

https://quarto.org/docs/authoring/shortcodes.html

ビルトインでいくつかのshortcodeが利用できる。

Quartoのバージョン

quarto::quarto_version()
[1] '1.5.54'

include 命令

include命令は.qmdファイルに他のテキストファイルを埋め込むことができる。 include命令の書式は以下で、埋め込みたい.qmdファイルのパスを指定する。 インラインでは使えない。

{{< include _something_content.qmd >}}

上記の様にかいて、同じディレクトリ内に以下のような内容の.qmdファイルがあった場合、

_something_content.qmd
This content comes from the `_something_content.qmd` file.

```{r}
#| echo: fenced
fs::dir_tree()
```

_something_content.qmdinclude命令を記述した箇所で展開されて、 それからレンダリングされるので以下のように表示される。

This content comes from the _something_content.qmd file.

```{r}
fs::dir_tree()
```
.
├── _something_content.qmd
├── cover.png
├── cover.webp
├── index.qmd
└── index.rmarkdown

include命令を使うとテキストファイルなら内容を埋め込むことができるが、 チャンク内での計算を行う場合には以下の二点の必要条件がある。

  1. チャンク内計算は.qmdファイルのみ
  2. 埋め込まれた状態で全てのチャンクで単一のエンジン(knitr or jupyter)を使用する

pagebreak命令

pagebreak命令を使うと、出力フォーマットに応じた改ページを挿入することができる。

{{< pagebreak >}}

Previous Page

Next Page

kbd命令

kbd命令を使うと、キーボードのキーを示すことができる。 インラインで使用することができる。

{{< kbd Shift >}} + {{< kbd P >}}
{{< kbd - >}}
To print, press {{< kbd Shift-Ctrl-P >}}. To open an existing new project, press {{< kbd mac=Shift-Command-O win=Shift-Control-O linux=Shift-Ctrl-L >}}.

Shift + P

-

To print, press Shift-Ctrl-P. To open an existing new project, press .