dynamically set algobattle version in docs

docs/macros.py

@@ -0,0 +1,11 @@
+import tomllib
+from pathlib import Path
+
+from mkdocs_macros.plugin import MacrosPlugin
+
+
+def define_env(env: MacrosPlugin) -> None:
+    project = tomllib.loads(
+        (Path(__file__).parent.parent / "pyproject.toml").read_text(encoding="utf-8")
+    )
+    env.variables["package_version"] = project["project"]["version"]

docs/tutorial/getting_started.md

@@ -27,7 +27,7 @@ contains a selection of basic problems. We can install it with uv just like the
 package:
 
 ```console
-uv tool install --with algobattle-problems algobattle-base==4.4.2
+uv tool install --with algobattle-problems algobattle-base=={{ package_version }}
 ```
 
 ## Setting up the workspace

docs/tutorial/installation.md

@@ -83,7 +83,7 @@ whichever installation process and version you like.
 Then all we need to do is run this command:
 
 ```console
-uv tool install algobattle-base==4.4.2
+uv tool install algobattle-base=={{ package_version }}
 ```
 
 This will take care of installing the correct Python version and all dependencies we need. It also

mkdocs.yml

@@ -6,7 +6,8 @@ edit_uri: ""
 
 plugins:
   - search
-
+  - macros:
+      module_name: docs/macros
   - mkdocstrings:
       handlers:
         python:

pyproject.toml

@@ -49,6 +49,7 @@ dev = [
     "pymdown-extensions>=12.1.0",
     "mkdocstrings[python]>=1.0.6",
     "mdx-include>=1.4.2",
+    "mkdocs-macros-plugin>=1.5.0",
 ]