Quartoで作成したwebサイトに画像を埋め込む方法

R
Published

September 8, 2024

本サイトはQuartoで作成していますが、画像の埋め込みの際にうまくいかなかったため、備忘録として記事にしました。

うまくいかなかったこと

QuartoではMarkdownという記法で画像を埋め込むことができます。 具体的には、以下のように記載します。

![キャプション](file_name.png)

このとき、()には相対パスでファイル名を記載します。 私の場合は、webサイトのルートディレクトリに記事のqmdファイルを入れるpostsフォルダと画像を入れるimagesを作成していました。 この場合は、postsフォルダから一つ親フォルダに戻り、imagesフォルダにある画像を参照するため、以下のように記載することになります。

![キャプション](../images/file_name.png)

これでページをレンダリングしましたが、うまくいきませんでした。

原因と解決策

どうやら、明示的に画像を扱うことを指定しないと、レンダリングされたあとの公開フォルダ(通常は_site)に画像が含まれないようです。 画像ファイルを扱うことを指定するには、設定ファイルである_quarto.ymlに以下のように追加が必要であるようです。

_quarto.yml
project:
  type: website
  resources: 
    - "*.png"

ここではpngファイルを記載しましたが、jpegファイルを扱い場合は.jpgと書き換えるか追加すればOKです。 これにより、_siteフォルダ内にimagesフォルダが作成されていると思います。

参考

Website Tools

Figures

Back to top