search

spinkube / documentation

Site and Docs for the SpinKube community project
https://www.spinkube.dev/
Apache License 2.0
15 stars 24 forks source link

fix ambiguous page references #190

Closed bacongobbler closed 2 months ago

bacongobbler commented 2 months ago

When running npm run build, the error message "page reference 'glossary' is ambiguous" was shown.

This fixes the issue by putting in a hard reference to the glossary page.

Signed-off-by: Matthew Fisher matt.fisher@fermyon.com

bacongobbler commented 2 months ago

According to #191, these errors do not present themselves in hugo 0.123.0 (what we manually install in CI), but is present in 0.128.0 (what is currently installed via npm install).

I'll take a look through Hugo's release notes to see if there's a better way to address this.

bacongobbler commented 2 months ago

I was able to reproduce the issue on hugo 0.126.3. All versions prior to Hugo 0.126.3 does not show this error.

0.126.2:

><> npm run build

> spinkube-documentation@0.1.0 build
> npm run _build --

> spinkube-documentation@0.1.0 _build
> npm run _hugo-dev --

> spinkube-documentation@0.1.0 _hugo-dev
> npm run _hugo -- -e dev -DFE

> spinkube-documentation@0.1.0 _hugo
> hugo --cleanDestinationDir -e dev -DFE

Start building sites … 
hugo v0.126.0-32c967551be308fbd14e5f0dfba0ff50a60e7f5e+extended linux/amd64 BuildDate=2024-05-14T13:24:11Z VendorInfo=gohugoio

                   | EN   
-------------------+------
  Pages            | 187  
  Paginator pages  |   0  
  Non-page files   |  11  
  Static files     |  51  
  Processed images |   6  
  Aliases          |   3  
  Cleaned          |   0  

Total in 548 ms

0.126.3/0.127.0:

><> npm run build

> spinkube-documentation@0.1.0 build
> npm run _build --

> spinkube-documentation@0.1.0 _build
> npm run _hugo-dev --

> spinkube-documentation@0.1.0 _hugo-dev
> npm run _hugo -- -e dev -DFE

> spinkube-documentation@0.1.0 _hugo
> hugo --cleanDestinationDir -e dev -DFE

Start building sites … 
hugo v0.127.0-74e0f3bd63c51f3c7a0f07a7c779eec9e922957e+extended linux/amd64 BuildDate=2024-06-05T10:27:59Z VendorInfo=gohugoio

ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/_index.md:25:42": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "runtime-class-manager": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/_index.md:27:150": page reference "runtime-class-manager" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "containerd-shim-spin": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/_index.md:27:307": page reference "containerd-shim-spin" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/overview/_index.md:23:51": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/quickstart/_index.md:50:44": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/quickstart/_index.md:70:36": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/tutorials/deploy-on-azure-kubernetes-service.md:74:142": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/tutorials/deploy-on-azure-kubernetes-service.md:143:36": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "runtime-class-manager": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/installation/installing-with-helm.md:34:228": page reference "runtime-class-manager" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/installation/installing-with-helm.md:57:56": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/installation/installing-with-helm.md:63:35": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/installation/installing-with-helm.md:72:65": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/tutorials/scaling-with-hpa.md:55:70": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/tutorials/scaling-with-hpa.md:55:162": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/tutorials/scaling-with-hpa.md:67:68": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/tutorials/scaling-with-keda.md:55:70": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/tutorials/scaling-with-keda.md:55:162": page reference "glossary" is ambiguous
ERROR [en] REF_NOT_FOUND: Ref "glossary": "/home/bacongobbler/code/github.com/spinkube/documentation/content/en/docs/spin-operator/tutorials/scaling-with-keda.md:67:68": page reference "glossary" is ambiguous
Total in 550 ms
Error: error building site: logged 18 error(s)