Cookbook for my kids. Makes use of mkdos. With every push to the main branch the static sites are build afresh and published to the corresponding netlify project. See the github action file for details.
Install uv and the run
uv init
uv add -r requirements.txt
To run locally start the mkdocs server wit the command
uv run mkdocs serve
This will serve the sites on http://127.0.0.1:8000/.
The netify project has been set up manually. A personal netlify access token has been created and registered with the github repository as a secret. The manual project creation produces an app id that can be used when running the netlify deploy --dir=public --prod command. This command picks up the NETLIFY_SITE_ID and the NETLIFY_AUTH_TOKEN environmental variables.