From 236e4901d8924b06a9387c7eb12d1bd83d4a6956 Mon Sep 17 00:00:00 2001
From: Enno Hermann <enno.hermann@idiap.ch>
Date: Wed, 11 Dec 2024 23:26:21 +0100
Subject: [PATCH] build(docs): update dependencies, fix makefile

---
 Makefile            |  5 +----
 docs/source/conf.py |  3 +++
 pyproject.toml      | 10 +++++-----
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/Makefile b/Makefile
index 1d6867f5..6964773f 100644
--- a/Makefile
+++ b/Makefile
@@ -59,9 +59,6 @@ lint:	## run linters.
 system-deps:	## install linux system deps
 	sudo apt-get install -y libsndfile1-dev
 
-build-docs: ## build the docs
-	cd docs && make clean && make build
-
 install:	## install 🐸 TTS
 	uv sync --all-extras
 
@@ -70,4 +67,4 @@ install_dev:	## install 🐸 TTS for development.
 	uv run pre-commit install
 
 docs:	## build the docs
-	$(MAKE) -C docs clean && $(MAKE) -C docs html
+	uv run --group docs $(MAKE) -C docs clean && uv run --group docs $(MAKE) -C docs html
diff --git a/docs/source/conf.py b/docs/source/conf.py
index e7d36c1f..e878d0e8 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -52,6 +52,7 @@ extensions = [
     "sphinx_inline_tabs",
 ]
 
+suppress_warnings = ["autosectionlabel.*"]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
@@ -67,6 +68,8 @@ myst_enable_extensions = [
     "linkify",
 ]
 
+myst_heading_anchors = 4
+
 # 'sphinxcontrib.katex',
 # 'sphinx.ext.autosectionlabel',
 
diff --git a/pyproject.toml b/pyproject.toml
index bf0a1d88..16d990c1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -143,12 +143,12 @@ dev = [
 ]
 # Dependencies for building the documentation
 docs = [
-    "furo>=2023.5.20",
-    "myst-parser==2.0.0",
-    "sphinx==7.2.5",
+    "furo>=2024.8.6",
+    "myst-parser==3.0.1",
+    "sphinx==7.4.7",
     "sphinx_inline_tabs>=2023.4.21",
-    "sphinx_copybutton>=0.1",
-    "linkify-it-py>=2.0.0",
+    "sphinx_copybutton>=0.5.2",
+    "linkify-it-py>=2.0.3",
 ]
 
 [project.urls]