feat: Added macros/utils define_env and site_url macro definition

macros/__init__.py

@@ -11,7 +11,7 @@ import re
 import yaml
 
 from mkdocs_macros.plugin import MacrosPlugin
-from . import (diagram, gitlab, services, table)
+from . import (diagram, gitlab, services, table, utils)
 from .constants import TEMPLATE_VARIABLES
 
 def define_env(env: MacrosPlugin):
@@ -27,3 +27,4 @@ def define_env(env: MacrosPlugin):
     gitlab.define_env(env)
     services.define_env(env)
     table.define_env(env)
+    utils.define_env(env)

macros/utils.py

@@ -3,6 +3,8 @@
 from mkdocs_macros.plugin import MacrosPlugin
 from urllib.parse import urljoin
 
+# Utilities:
+
 def environment(env: MacrosPlugin) -> dict:
     """
     Useful for debugging & development.
@@ -26,3 +28,17 @@ def variables(env: MacrosPlugin) -> dict:
 def rel_url(env: MacrosPlugin, rel_path: str) -> str:
     site_url = environment(env)["conf"]["site_url"]
     return urljoin(site_url, rel_path)
+
+# Generic Macros:
+
+_ENV = None
+
+def define_env(env: MacrosPlugin):
+    global _ENV
+    _ENV = env
+    env.macro(site_url)
+
+def site_url() -> str:
+    env = environment(_ENV)
+    return env["conf"]["site_url"]
+    #return environment(_ENV)["conf"]["site_url"]