HUGOの備忘録
躓きそうなことがあれば、ここに追記していき、都度個別記事化する。

ファイル分割先でグローバル変数を使う

ファイル分割した際、{{ partial "header.html" . }}のように呼び出すが、
このとき . を書き忘れると、分割先のファイル内でグローバル変数が使えなくなる。
引数渡しみたいなことをしてるっぽい。

タクソノミー用のランディングページを作成する

ここの layouts/_default/taxonomy.htmlテンプレートで /tags/index.htmlを作成したときのテンプレートを、
layouts/_default/term.htmlテンプレートで /tags/[タグ名]/index.htmlを作成したときのテンプレートを作ることができる。

これを作成していないと、list.htmlがテンプレートとして認識されてしまうため注意。

サイト内検索導入

pagefindを使った。
ワークフローのHUGOビルド後に下記処理を追加。

- name: Run pagefind
    working-directory: ./
    run: "npx pagefind --site public"

その後、検索窓を表示させたいページで適当にレイアウトを作成して、下記を記載する。

{{- $page := .Site.GetPage "/" -}}
<link href="{{- $page.RelPermalink -}}pagefind/pagefind-ui.css" rel="stylesheet">
<script src="{{- $page.RelPermalink -}}pagefind/pagefind-ui.js"></script>
<div id="search"></div>
<script>
    window.addEventListener('DOMContentLoaded', (event) => {
        new PagefindUI({ element: "#search", showSubResults: true });
    });
</script>