FMG-10: correct the STL previews guide and point it at forgejo-stlview #5
Loading…
Reference in a new issue
No description provided.
Delete branch "butterrobot/fmg-10-stl-guide-corrections"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Corrects the STL previews post against the actual deployed setup. Full findings in FMG-10. Replaces the copy-Codeberg's-file instruction with a pointer to forgejo-stlview, and documents the volume mounts, the load-bearing classList.remove('stl-page'), and the three.js bare-specifier patch. Verified with hugo --minify (extended 0.165.0, matching CI).
The guide told readers to copy Codeberg's stlview.js verbatim, but the deployed viewer is a rewrite of it: it keys off the URL instead of the "view raw" block, takes over .file-view, and loads three.js as ES modules rather than through the UMD global. Following the guide as written left you with a viewer that never loaded. Point at forgejo-stlview instead. Also documents three things that were load-bearing but unstated: the volume mounts (and that the container path is /data/gitea), the classList.remove('stl-page') without which the step 2 CSS hides the injected canvas, and the patch the three.js example modules need because they import via the bare 'three' specifier. Adds the file-view-only limitation, the [stlview] console-logging debug hint, AGPL-3.0 attribution for the derived viewer, and the Forgejo version this was verified against. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>ae32ef81f2c23c75317eView command line instructions
Checkout
From your project repository, check out a new branch and test the changes.Merge
Merge the changes and update on Forgejo.Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.