Problem
The 9 generated OpenBolt reference pages (e.g. bolt_command_reference.html, plan_functions.html, etc.) return 404 on the live site at https://docs.openvoxproject.org/openbolt/latest/.
Static pages in the same collection load fine.
Root cause
The rake references:openbolt pipeline checks out the latest openbolt release tag (5.5.0). At that tag, the ERB templates in documentation/templates/ do not include Jekyll front matter. Jekyll 4.4 treats collection documents without front matter as static files and copies them as .md rather than compiling them to .html, resulting in 404s on the .html URLs.
The fix landed in openbolt main via PR OpenVoxProject/openbolt#233, which added layout: and title: front matter to all 9 ERB templates. However, no release tag has been cut from main yet, so the build pipeline still picks up 5.5.0.
Verification
Tested locally:
VERSION=5.5.0 (default): generated files have no front matter → Jekyll outputs .md static files → 404VERSION=main: generated files have front matter → Jekyll compiles to .html → pages load correctly
Fix
Cut a new openbolt release tag (e.g. 5.6.0) from the current main. The next rake references:openbolt run will pick it up automatically and the generated reference pages will appear on the site.
Problem
The 9 generated OpenBolt reference pages (e.g.
bolt_command_reference.html,plan_functions.html, etc.) return 404 on the live site at https://docs.openvoxproject.org/openbolt/latest/.Static pages in the same collection load fine.
Root cause
The
rake references:openboltpipeline checks out the latest openbolt release tag (5.5.0). At that tag, the ERB templates indocumentation/templates/do not include Jekyll front matter. Jekyll 4.4 treats collection documents without front matter as static files and copies them as.mdrather than compiling them to.html, resulting in 404s on the.htmlURLs.The fix landed in openbolt
mainvia PR OpenVoxProject/openbolt#233, which addedlayout:andtitle:front matter to all 9 ERB templates. However, no release tag has been cut frommainyet, so the build pipeline still picks up5.5.0.Verification
Tested locally:
VERSION=5.5.0(default): generated files have no front matter → Jekyll outputs.mdstatic files → 404VERSION=main: generated files have front matter → Jekyll compiles to.html→ pages load correctlyFix
Cut a new openbolt release tag (e.g.
5.6.0) from the currentmain. The nextrake references:openboltrun will pick it up automatically and the generated reference pages will appear on the site.