Added variable support to cards and description macro

docs/ibexa_engage/install_ibexa_engage.md

@@ -1,9 +1,9 @@
 ---
-description: Install and configure Ibexa Engage.
+description: Install and configure [[= product_name_engage =]].
 edition: experience
 ---
 
-# Ibexa Engage
+# [[= product_name_engage =]]
 
 [[= product_name_engage =]] is a data collection tool. It enables you to engage your audiences by using the [Qualifio](https://qualifio.com/) tools.
 You can use interactive content to gather valuable data, for example, customer data or recent orders list, and create connections.
@@ -52,4 +52,4 @@
     [[= product_name_base =]] configures the `channel` and `client_id` values so that the selections can be filled up automatically on [[= product_name =]] side.
 
     The `feed_url` and `variable_map` values don't need to be set at the installation process.
-    They're preconfigured and can be overwritten.
+    They're preconfigured and can be overwritten.

docs/resources/release_process_and_roadmap.md

@@ -2,7 +2,7 @@
 description: "Ibexa DXP releases new versions periodically in different flavors: Ibexa Headless, Ibexa Experience and Ibexa Commerce, plus open-source Ibexa OSS."
 ---
 
-# Ibexa DXP release process and roadmap
+# [[= product_name =]] release process and roadmap
 
 ## Release process
 

main.py

@@ -20,7 +20,7 @@
 """
 
 
 def define_env(env):
     """
     This is the hook for defining variables, macros and filters
 
@@ -64,6 +64,9 @@
 
         if isinstance(pages, str):
             pages = [pages]
+        variables = env.conf.get('extra', {})
+        var_start = env.config['j2_variable_start_string']
+        var_end = env.config['j2_variable_end_string']
         cards = []
         for page_data in pages:
             if isinstance(page_data, tuple):
@@ -144,6 +147,8 @@
                 href = page
                 title = custom_title if custom_title else current_meta['short'] or current_meta['title']
                 description = custom_description if custom_description else current_meta['description'] or " "
+                title = resolve_variables(title, var_start, var_end, variables)
+                description = resolve_variables(description, var_start, var_end, variables)
 
             cards.append(
                 CARDS_TEMPLATE % (
@@ -231,6 +236,16 @@
     def release_note_entry_end() -> str:
         return "</div>"
 
+    def resolve_variables(text, var_start, var_end, variables):
+        """Replace variable references (e.g. [[= var =]]) with variables."""
+        pattern = re.escape(var_start) + r'\s*([\w.]+)\s*' + re.escape(var_end)
+        def replacer(match):
+            key = match.group(1).strip()
+            if key not in variables:
+                raise KeyError("Undefined variable '%s' used in cards macro" % key)
+            return str(variables[key])
+        return re.sub(pattern, replacer, text)
+
     def slugify(text: str) -> str:
         return text.lower().replace(' ', '-')
 
@@ -242,3 +257,16 @@
                 raise ValueError(
                     "Unknown category: {category}. Available categories are: {available_categories}".format(category=category, available_categories=" ".join(available_categories))
                     )
+
+
+def on_pre_page_macros(env):
+    """
+    Resolve variable references in the page's description front matter field
+    so that they are substituted before MkDocs renders the <meta> tag.
+    """
+    page = env._page
+    if page.meta and 'description' in page.meta:
+        page.meta['description'] = env.render(
+            markdown=page.meta['description'],
+            force_rendering=True
+        )