Skip to content

Docs local preview fails on Windows PowerShell and Hugo 0.92.1 #6741

@abdollahShahid

Description

@abdollahShahid

I tested the docs local preview workflow on Windows PowerShell from a clean upstream worktree.

Screenshot 1 shows the clean test setup. I created a separate worktree from origin/master, entered it, and confirmed git status showed nothing to commit, working tree clean.

Image

Screenshot 2 shows the first failure. Running the documented command:

Image
make run/site

fails in PowerShell because grep is not recognized. The command then continues with an empty RELEASE value and fails at Makefile:206.

Screenshot 3 shows the Hugo version I used for the direct test:

Image
hugo v0.92.1 ... extended windows/amd64

Screenshot 4 shows the second failure. After setting the release manually and running Hugo directly:

Image
$env:RELEASE = "v0.55.0"
& "$env:TEMP\hugo-0.92.1\hugo.exe" server --source=docs

the docs site starts building, but fails with:

can't evaluate field IsServer in type interface {}

Screenshot 5 shows the worktree was still clean after testing, so this does not appear to be caused by local docs changes.

Image

Expected behavior should be The documented local docs preview workflow should work on Windows, or the docs should explain the supported Windows workflow and required tools. My Envirnment is Windows PowerShell with hugo v0.92.1 extended windows/amd64.

Metadata

Metadata

Assignees

No one assigned

    Labels

    kind/bugSomething isn't working as expected

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions