Describe the bug
The docs site fails to build on Windows with the following error:
Error: Validation of "_meta" file has failed.
The field key "User Guide" in _meta file refers to a page that cannot be found, remove this key from "_meta" file.
Output from KubeStellar-Snapshot.sh
Root Cause
The getAllDocFiles() function in src/app/docs/page-map.ts uses path.relative() to generate file paths. On Windows, this returns backslashes (direct\get-started.md), while the navigation structure uses forward slashes (direct/get-started.md).
When checking allDocFiles.includes(value), the comparison fails because:
direct\get-started.md (Windows path) ≠ direct/get-started.md (nav structure)
This causes pages to not be found, and the _meta validation fails.
Steps To Reproduce
- Clone the repo on a Windows machine
- Run npm install
- Run npm run dev or npm run build
- Observe the _meta validation error
Expected Behavior
It should run without any build error.
Want to contribute?
Additional Context
No response
Describe the bug
The docs site fails to build on Windows with the following error:
Output from KubeStellar-Snapshot.sh
Root Cause
The
getAllDocFiles()function insrc/app/docs/page-map.tsusespath.relative()to generate file paths. On Windows, this returns backslashes (direct\get-started.md), while the navigation structure uses forward slashes (direct/get-started.md).When checking
allDocFiles.includes(value), the comparison fails because:direct\get-started.md(Windows path) ≠direct/get-started.md(nav structure)This causes pages to not be found, and the
_metavalidation fails.Steps To Reproduce
Expected Behavior
It should run without any build error.
Want to contribute?
Additional Context
No response