Skip to content

fix(explore): quote frontmatter description to fix Hugo build failure - #1593

Merged
jung-thomas merged 1 commit into
mainfrom
worktree-fix-explore-yaml-colon
Aug 10, 2026
Merged

jung-thomas merged 1 commit into
mainfrom
worktree-fix-explore-yaml-colon

Conversation

@jung-thomas

Copy link
Copy Markdown
Contributor

Problem

The content rebuild is failing at the Build Hugo site step:

Error: ... "hugo/content/explore/_index.md:2:1": failed to unmarshal YAML:
yaml: line 2: mapping values are not allowed in this context

(failing run)

Root cause

Commit c5157b6 ("Update _index.md explore") changed the description frontmatter to an unquoted string containing a colon-space:

description: Interactive visualization of the SAP Developers knowledge graph: tutorials, missions, ...

In YAML, : (colon + space) inside an unquoted scalar is interpreted as a nested mapping key, which is illegal in that position — hence the parse error. Hugo reports it at the frontmatter offset (line 2).

Fix

Wrap the description value in double quotes so the colon is treated as literal text. Robust against colons and other punctuation.

Verified the frontmatter now parses cleanly as a single string.

Commit c5157b6 introduced an unquoted colon-space in the description
value ("...knowledge graph: tutorials..."), which YAML parses as a
nested mapping, breaking the Hugo build:

  failed to unmarshal YAML: mapping values are not allowed in this context

Quoting the string makes it robust against colons and other punctuation.
@jung-thomas
jung-thomas merged commit c6bce18 into main Aug 10, 2026
3 checks passed
@jung-thomas
jung-thomas deleted the worktree-fix-explore-yaml-colon branch August 13, 2026 15:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant