[HDDS-5189] PSA: hugo 0.83.0 / 0.83.1 broke hadoop-hdds/docs/dev-support/bin/generate-site.sh

• Type: Task
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.2.0
• Fix Version/s: 1.2.0
• Component/s: build
• Labels: pull-request-available
• Assignee: Marton Elek
• Reporter: Siyao Meng
• Created: 04/May/21 19:58
• Updated: 09/Jul/21 09:47
• Resolved: 14/May/21 19:37

Description

After upgrading my hugo to 0.83.1, a maven build would fail at hadoop-hdds-docs for me.

[INFO] --- exec-maven-plugin:1.3.1:exec (default) @ hadoop-hdds-docs ---
Error: Error building site: ".../hadoop-hdds/docs/content/interface/ReconApi.md:1:1": [BUG] goldmark: runtime error: slice bounds out of range [3503:3501]: create an issue on GitHub attaching the file in: /var/folders/yp/sxzthlnd45vdwcwvdldf_12r0000gp/T/hugo_bugs/goldmark_267fdfa526d051bdccb7cf9a98e0772d.txt
Start building sites …
goroutine 60 [running]:
runtime/debug.Stack(0x5f70c80, 0x6b7c280, 0xc00117c310)
	runtime/debug/stack.go:24 +0x9f
github.com/gohugoio/hugo/markup/goldmark.(*goldmarkConverter).Convert.func1(0xc000a2e6c0, 0xc000d25500, 0x2b24, 0x3038, 0x1, 0x0, 0x0, 0x0, 0x0, 0x0, ...)

ReconApi.md itself hasn't changed since Nov 2020, it's also unlikely that other markdowns have caused this. This issue can be simply repro'ed with:

./hadoop-hdds/docs/dev-support/bin/generate-site.sh

on hugo 0.83.0 or 0.83.1.

After reverting hugo to 0.82.1 (homebrew build), the problem goes away for me.

$ hugo version
hugo v0.82.1+extended darwin/amd64 BuildDate=unknown

PSA: Do not upgrade hugo to 0.83.0 or 0.83.1 if you want to compile hadoop-hdds-docs, it is still broken right now.

Issue Links

• is duplicated by: HDDS-5399 cannot build the doc on branch 1.1
• links to: GitHub Pull Request #2232