README.md

mborne.github.io

Ce dépôt est la source de https://mborne.github.io.

Travail en local

Avec uv :

# démarrage du serveur sur http://localhost:8000 :
uv run mkdocs serve

# mise à jour des dépendances
uv sync --upgrade

Formatage des fichiers Markdown

Voir .markdownlint.yml :

npx markdownlint-cli2 "docs/**/*.md" --fix

Contrôle des liens

npx -y markdown-link-check -c markdown-link-check.config.json ./docs

Contrôle du site

Le mode --strict signale notamment les pages absentes de la navigation (nav dans mkdocs.yml) ainsi que les liens et ancres internes cassés :

uv run mkdocs build --strict

Ressources

• squidfunk.github.io - Getting started
• squidfunk.github.io - Minimal configuration pour .vscode/settings.json

Licence

MIT