この記事を作った動機

　hugo を使っていて、解決に手こずったことがあったのでそれを記録しようと思っただけ。

問題を解消するには

　タグ名、もしくはヘッダーのアイテムの項目の識別子がかぶらないように変更する。

　今回は、hugo.yamlのidentifierの内容を、“idea"から、“ideaList"に変更する例を示す。実際にはこれ以外にも任意の名前に変更しても問題ないと思われる。

とある記事.md の例

+++
date = '2025-06-10T07:11:01+09:00'
draft = false
title = 'EC 開発'
tags = ['ChatGPT', 'Idea' , 'BGA' , 'Research']
showToc = true
+++
...

hugo.yaml の例

  • 修正前
...
menu:
    main:
...
        - identifier: "Images"
          name: "Images"
          url: "/images/"
          weight: 3

        - identifier: "idea"
          name: "Idea"
          url: "/posts/idea/"
          weight: 5
...
  • 修正後
...
menu:
    main:
...
        - identifier: "Images"
          name: "Images"
          url: "/images/"
          weight: 3

        - identifier: "ideaList"
          name: "Idea"
          url: "/posts/idea/"
          weight: 5
...

どういうときに症状が再現する？

　各記事ごとのタグ名と、ヘッダーのアイテムの項目の識別子がかぶっているとき。今回は、“Idea"という項目がかぶっている例を示す。

とある記事.md

tags 内に、“Idea"がある

+++
date = '2025-06-10T07:11:01+09:00'
draft = false
title = 'EC 開発'
tags = ['ChatGPT', 'Idea' , 'BGA' , 'Research']
showToc = true
+++
...

hugo.yaml

　identifierとして、“idea"が存在する。（大文字と小文字は区別してないのかわからないが、“idea"と"Idea"は多分同じ扱いになっている)

...
menu:
    main:
...
        - identifier: "Images"
          name: "Images"
          url: "/images/"
          weight: 3

        - identifier: "idea"
          name: "Idea"
          url: "/posts/idea/"
          weight: 5
...

どんなエラーが出る？

　最初は何のことかさっぱりだったが、GetPage: page reference "idea" is ambiguousと言われていることに気づいた。以下は一応無理やり改行したり、インデントをつけてみたが、どうあがいてもエラー文は読みやすくはならなかった。。。

　ちなみに実際には、これは一行で一つでまとまってごちゃごちゃに表示されるため、かなり具体的に何が悪いのか、わかりづらい状態である。何というか、低レベルな実装の詳細なエラーが出ているという感じである。

ERROR render of "/categories" failed: 
    "/PathToProjectRoot/layouts/_default/baseof.html:20:8": 
        execute of template failed: template: 
            _default/terms.html:20:8: 
                executing "_default/terms.html" at <partialCached "header.html" . .Page>: 
                    error calling partialCached: 
                        "/PathToProjectRoot/themes/PaperMod/layouts/partials/header.html:127:38": 
                            execute of template failed: 
                                template: _partials/header.html:127:38: executing "_partials/header.html" at <site.GetPage>: 
                                    error calling GetPage: page reference "idea" is ambiguous

# 似たようなエラーがいくつかズラリと並ぶ。
...

参考にしたサイトとか