From 10ed3466d03d094712d2ebd88941b90d50415e00 Mon Sep 17 00:00:00 2001 From: Keith Gaughan Date: Sun, 31 May 2026 16:42:00 +0100 Subject: [PATCH] Update mkdocs dependencies and fix makefile targets Given Mkdocs is essentially a dead project, it may be an idea to investigate Zensical or something similar as an alternative. --- Makefile | 10 +++++----- docs/requirements.txt | 8 ++++---- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/Makefile b/Makefile index ee89dabc..e76fa314 100644 --- a/Makefile +++ b/Makefile @@ -157,21 +157,21 @@ lint-yaml: $(PYTHON): $(info Creating virtualenv in $(VENV)) - @python -m venv $(VENV) + @python3 -m venv $(VENV) $(DOCS_DEPS): $(PYTHON) docs/requirements.txt $(info Installing dependencies) - @pip install --upgrade pip - @pip install --requirement docs/requirements.txt + @$(VENV)/bin/pip install --upgrade pip + @$(VENV)/bin/pip install --requirement docs/requirements.txt @touch $(DOCS_DEPS) docs/setup: $(DOCS_DEPS) docs/serve: docs/setup $(info Running documentation live development server) - @mkdocs serve --strict + @$(VENV)/bin/mkdocs serve --strict .PHONY: docs docs: docs/setup $(info Building documentation) - @mkdocs build --strict + @$(VENV)/bin/mkdocs build --strict diff --git a/docs/requirements.txt b/docs/requirements.txt index 7e1b447f..254b4b24 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -1,6 +1,6 @@ -mkdocs-material==9.5.23 -mkdocs-macros-plugin==1.0.5 -mkdocs-awesome-pages-plugin==2.9.2 +mkdocs-material==9.7.6 +mkdocs-macros-plugin==1.5.0 +mkdocs-awesome-pages-plugin==2.10.1 mkdocs-exclude==1.0.2 mdx-breakless-lists==1.0.1 -pygments==2.18.0 +pygments==2.20.0