sneak
7cad989724
Adopt the Scripts to Rule Them All standard for this Hugo site: - script/ POSIX-sh entrypoints (bootstrap, setup, projectname, test, lint, fmt, fmt-check, check, docker, cibuild, precommit, install-precommit). The correctness check (test/lint) is a clean `hugo --minify` production build; fmt/fmt-check run prettier over the repo's own top-level markdown only, leaving content/ untouched. - Makefile targets reduced to thin shims that call script/NAME, plus a convenience serve target for `hugo server`. - Dockerfile on a sha256-pinned alpine base that installs deps via script/bootstrap and runs `make check`, so the image build fails on any formatting or Hugo build error; .dockerignore added. - .gitea/workflows/check.yml runs script/cibuild on push. - README Entrypoints section documenting the scripts.
2.1 KiB
2.1 KiB
Workflow
- branch (from
main) - do the work in Next Step
- move Next Step to the top of Completed Steps
- move the top item of Future Steps into Next Step
- commit (
TODO.mdchanges in the same commit as the work) - merge to
mainif the branch is not protected, otherwise open a PR - push
Status
pre-1.0
No git tags. The site is live and now has the scripts-to-rule-them-all scaffold
(Makefile, script/, Dockerfile, check.yml); still missing LICENSE and
policy files.
Next Step
Add the remaining policy scaffold: LICENSE, REPO_POLICIES.md,
.editorconfig, and prettier config files (.prettierrc, .prettierignore).
Update README.md accordingly.
Completed Steps
- 2026-07-25: added the scripts-to-rule-them-all scaffold (closes #4):
script/entrypoints,Makefileshims, a HugoDockerfile(sha256-pinned alpine) plus.dockerignorethat runsmake check,.gitea/workflows/check.ymlrunningscript/cibuild, and a README Entrypoints section.test/lintare a cleanhugo --minifybuild;fmt/fmt-checkrun prettier over the repo's own top-level markdown only - 2026-02-10: design pass: minimal light theme with inline CSS, grey wells for mesh channels and signal groups, horizontal overflow fix, body width tuning, map link update
- 2026-02-10: added README and footer contribute link
- 2026-02-10: added Gitea workflow that builds the site and deploys to Cloudflare Pages
- 2026-02-08: initial Hugo static site for lora.vegas
Future Steps
- Pin the images and actions in
deploy.ymlby sha256 (klakegg/hugo:ext-alpine,node:20,actions/checkout,upload/download-artifactare all unpinned) - Rework README.md into the standard sections: Description, Getting Started, Rationale, Design, TODO, License, Author (currently About, Contributing, Technical Details, License)
- Replace the "content is provided as-is" README note with the text of the committed LICENSE
- Expand .gitignore beyond Hugo outputs (OS and editor files)
- Verify the Cloudflare Pages deploy still works after the workflow changes
- Keep mesh channel and signal group listings current