Webサイトのリダイレクト設計と設定の整理

Hugo はデフォルトで taxonomy（タグ・カテゴリ）のページを生成する。しかし実際には使われておらず、ビルド成果物に含まれるだけの存在だった。

hugo.toml に以下を追加することで無効化できる。

disableKinds = ["taxonomy", "term", "section"]

taxonomy はタグ一覧（~/tags/~）、~term~ は個別タグページ（~/tags/golang/~）、~section~ はセクション一覧（~/ja/posts/~）に対応する。ホームページ（~/ja/~）は home という別の kind であるため、これを追加しても影響しない。

/posts/page/2/ 以降のページネーションも、レイアウトが正しく実装されていないため表示が崩れていた。根本的なレイアウト修正ではなく、ページネーション自体を発生させないという判断をした。

Hugo v0.128 以降では [pagination] セクションで設定する。

[pagination]
  pagerSize = 999999

記事数より大きな値を指定することで、全記事が1ページに収まり、ページネーションページが生成されなくなる。

このサイトは日本語・英語・ポルトガル語・インドネシア語・トルコ語の5言語に対応している。記事は常に日本語版が存在するが、他言語版はないことも多い。

目標はシンプルだ。他言語版が存在しない URL にアクセスがあった場合、対応する日本語版へリダイレクトする。他言語版が存在する場合はそのまま表示する。

最初に試みたのは static/_redirects にワイルドカードルールを書く方法だ。

/posts/*    /ja/posts/:splat 301
/pt/posts/* /ja/posts/:splat 301
/id/posts/* /ja/posts/:splat 301
/tr/posts/* /ja/posts/:splat 301

Netlify は静的ファイルをリダイレクトより優先して配信するため、この方式が成立する。しかし Cloudflare Pages は異なる。リダイレクトルールが静的ファイルより先に評価されるため、英語版が存在する記事まで日本語にリダイレクトされてしまった。

解決策は、ビルド時に「翻訳が存在しない言語のルールだけ」を生成することだ。

Hugo のカスタム出力フォーマットを使う。~hugo.toml~ に以下を追加する。

[mediaTypes."text/redirects"]
  suffixes = [""]

[outputFormats.redirects]
  baseName = "_redirects"
  isPlainText = true
  mediaType = "text/redirects"
  notAlternative = true

[outputs]
  home = ["HTML", "RSS", "redirects"]

layouts/index.redirects テンプレートでは、日本語記事を全件走査し、各言語の翻訳が存在するかを確認する。存在しない言語にのみリダイレクトルールを出力する。

{{- $defaultLang := (index site.Languages 0).Lang }}
{{- if eq site.Language.Lang $defaultLang }}
{{- $jaSite := index (where site.Sites "Language.Lang" "ja") 0 }}
{{- range $jaSite.RegularPages }}
{{- $jaURL := .RelPermalink }}
{{- $basePath := strings.TrimPrefix "/ja" $jaURL }}
{{- $translationLangs := slice }}
{{- range .Translations }}{{- $translationLangs = $translationLangs | append .Lang }}{{- end }}
{{- range site.Sites }}
{{- $lang := .Language.Lang }}
{{- if and (ne $lang "ja") (not (in $translationLangs $lang)) }}
{{- if eq $lang $defaultLang }}
{{ $basePath }} {{ $jaURL }} 301{{ else }}
/{{ $lang }}{{ $basePath }} {{ $jaURL }} 301{{ end }}
{{- end }}
{{- end }}
{{- end }}
{{- end }}

site.DefaultContentLanguage は Hugo テンプレートでは直接参照できないため、~(index site.Languages 0).Lang~ で代替している点に注意が必要だ。

_redirects を static/ に配置したにもかかわらず、ビルド後の public/ に現れないという問題が発生した。

原因は hugo.toml の [[module.mounts]] 設定にある。Hugo はモジュールマウントを1件でも定義すると、そのコンポーネントのデフォルトマウントを無効化する。このサイトでは static/game/scroll などへのカスタムマウントが設定されていたため、~static → static~ のデフォルトマウントが失われていた。

[module] セクションに明示的なマウントを追加する。

[[module.mounts]]
  source = "static"
  target = "static"

content → content のマウントはすでに定義されていたが、~static~ は抜け落ちていた。