Old Sunset Days

Hugoでブログ中に画像イメージを貼り付ける

日付 タグ hugo カテゴリ hugo

目次

オススメはビルトインのShortcodeを利用

Hugoのブログ記事を書き始めてすぐに持つ疑問は、文章はいいけど、画像貼り付けもできるの?というものだろう。Qiitaとか利用している人なら普通にMarkdown的な記法でURL貼り付けと同じ感じで画像リンク貼り付けを使っていると思うが、Hugoでも同様な記法が可能だが、どちらかというと、自分としてはShortcodeを普段は利用している。

  • 画像イメージリンク貼り付け2パターン
    • Markdown的な記法で貼り付け
    • ビルトインShortcodeを用いて貼り付け

Markdown的な記法で画像イメージ貼り付け

RedmineとかGithubとかQiitaとか、そういうところで使われる画像イメージの貼り付けの場合は、

![代替テキスト](画像URL "タイトル")

とすれば良い。それと同じようにHugoでもこの形式で画像イメージを記事中に貼り付けが可能である。

例えば、staticフォルダ以下に /static/images/hugo-img/hakone.jpg というファイルを用意しておいて貼り付けたいとする。 この場合、hugoコマンドでビルドされた暁には、このファイルは public/images/hugo-img/hakone.jpg というファイルになるので、

ブログ記事のMarkdownのmdファイル中で

ブログ記事のmarkdownのmd中

![箱根散歩](/images/hugo-img/hakone.jpg)

とすれば、どうだろう。

箱根散歩

実際に画像が表示された。

Shortcodeで画像イメージ貼り付け

自分が普段使っているのはこちらの方法でShortcodeのfigureで画像イメージを貼り付けるやり方だ。

https://gohugo.io/content-management/shortcodes/ - Shortcodes

figure
figure is an extension of the image syntax in markdown, which does not provide a shorthand for the more semantic HTML5 element.

ブログ記事のmarkdownのmd中

{{< figure src="/images/hugo-img/hakone.jpg" alt="箱根散歩" >}}
箱根散歩

どうだろう。無事に表示された。

figureのshortcodeの細かいオプションは公式ページを見ればわかるが、良く使うのは横幅指定。
300pxに横幅を指定したければ

{{< figure src="/images/hugo-img/hakone.jpg" alt="箱根散歩" width=300px >}}
箱根散歩

実際にwidth指定を入れることで横幅が狭くなったのが確認できた。