Hugo ってバージョンアップしてるの？

まずは、私が使っている現在のバージョンを確認。

$ hugo version
$ Hugo Static Site Generator v0.54.0/extended windows/amd64 BuildDate: unknown

ふむ、0.54 を使っているらしい。

公式サイトに行ってみると、0.76.5 が最新の様子。
すっかり時代に取り残されていました。

最新版にするには（Windows）

Windows の場合は、GitHub から Zip を落としてきて、実行ファイルを入れ替えるだけで完了です。

チェックしましょう。

とりあえず今までの記事が正常に見られるかチェック。

$ hugo server -D
Start building sites …
WARN 2020/10/16 15:08:48 Page.RSSLink is deprecated and will be removed in a future release. Use the Output Format's link, e.g. something like:
    {{ with .OutputFormats.Get "RSS" }}{{ .RelPermalink }}{{ end }}

なんか怒られた。

修正します。

調べてみたら、.RSSLink っていうのが最新版では使えないっていうことらしい。

head.html で使っていたので修正しました。

{{ if .RSSLink }}
<link href="{{ .RSSLink }}" rel="alternate" type="application/rss+xml" title="{{ .Title }}" />{{ end }}

↓ こんな風に。

{{ with .OutputFormats.Get "RSS" }}
<link href="{{ .RelPermalink }}" rel="alternate" type="application/rss+xml" title="{{ $.Site.Title }}" />{{ end }}

これでエラーは出なくなった。

あれ？ レイアウトが・・・

トップページのレイアウトがおかしい。
今までは content/post/ 以下の記事がずらっと並んでくれたんですが、content が表示されてるっぽい。

画面に出ている post をクリックして開くといつもの感じになるけど、仕様が変わったのかな・・・。

調査開始

まずは定番

Google でいろいろ調べました。

まったく分からんかったけどね。

Permalink の設定でなんとかならんもんかと四苦八苦するものの駄目でした。

地道に仕様変更を探る

どのバージョンからレイアウトが崩れているのか、GitHub から過去バージョンを落としまくって調査しました。

v0.60.0 NG
v0.57.0 NG ← お前か！
v0.56.0 OK
v0.56.3 OK

リリース情報の中身を念入りチェックしていたら、気になる一文を発見。

英語読めないので、翻訳しました。

これだ。

\themes\xxxx\layouts\_default\list.html の中に .Pages を使っていたので、そこを .Site.RegularPages に直すことで解決しました。

半日近くかかったよ。

あれ、引用がごっそり消えている

たまたま気付いたんですが、引用した部分がごっそり消えていたんですよ。

html のソースを見ると、その部分が

<!-- raw HTML omitted -->

となっていました。

これは Google ですぐに見付けました。

v0.60.0 から、記事ファイル（hoge.md）に書かれた html が表示されなくなったとのこと。（なんで？）

解決策は config.toml にオプションを追加すればオッケー。

[markup.goldmark.renderer]
unsafe= true

すぐ直って良かった。

ということで、今回から最新版の Hugo を使っていきます。