Knowledge website (knowledge-website.yaml)

Knowledge website (knowledge-website.yaml)

.github/workflows/knowledge-website.yaml is the workflow named “Knowledge website”, a copy of the ktl-website template. It runs on a push to the default branch, every Monday at 05:23 UTC, and by hand. It also runs on a pull request that touches website/, .lokf/, the README, docs/, the changelog, llms.txt, a justfile, a pyproject.toml or a uv.lock.¹ Its build job runs under a read-only token. It:

• checks the repository out with its full history;
• installs the sidecar’s toolkit with uv sync --locked;
• links the just the sidecar’s lock pins, when the site builds a folder with it;
• runs npm ci --ignore-scripts and npm run build, which syncs the pages, builds the site and checks every link;
• uploads website/dist as the Pages artifact.

Its deploy job holds pages: write and id-token: write in the github-pages Environment, and runs only from the default branch once the repository variable KNOWLEDGE_WEBSITE_ENABLED is true. Documentation site describes what it publishes.

Footnotes

1. .github/workflows/knowledge-website.yaml, the header comment, the on key and the jobs ↩