Expand AI Actions cards (#2860)

* Added more cards related to AI Actions

* Added grouping

* Added user doc link

* Applied Vale suggestion

* Update docs/ai_actions/ai_actions.md

Author: mnocon

docs/ai_actions/ai_actions.md

@@ -11,8 +11,24 @@ After you configure it, it can generate alt text for images or transform text pa
 
 You can also extend it to perform other tasks or support additional AI services.
 
+##  Getting Started
+
 [[= cards([
 "ai_actions/ai_actions_guide",
 "ai_actions/configure_ai_actions",
+("permissions/policies#ai-actions", "Policies", "Learn about the available AI Actions policies"),
+("https://doc.ibexa.co/projects/userguide/en/5.0/ai_actions/work_with_ai_actions/"),
+], columns=2) =]]
+
+## Development
+
+[[= cards([
 "ai_actions/extend_ai_actions",
+"api/event_reference/ai_action_events",
+("https://doc.ibexa.co/en/5.0/api/rest_api/rest_api_reference/rest_api_reference.html#tag/Connector-AI", "REST API Reference", "See the available endpoints for AI Actions"),
+"templating/twig_function_reference/ai_actions_twig_functions",
+"search/ai_actions_search_reference/action_configuration_criteria",
+"search/ai_actions_search_reference/action_configuration_sort_clauses",
+("content_management/data_migration/importing_data#ai-action-configurations", "Importing AI actions", "Learn how to manage Action Configurations using data migrations"),
 ], columns=4) =]]
+

docs/search/ai_actions_search_reference/action_configuration_criteria.md

@@ -1,10 +1,11 @@
 ---
 month_change: false
+description: Search Criteria available for Action Configuration search
 ---
 
 # Action Configuration Search Criterion reference
 
-Search criterions are found in the `Ibexa\Contracts\ConnectorAi\ActionConfiguration\Query\Criterion` namespace, implementing the [CriterionInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ConnectorAi-ActionConfiguration-Query-CriterionInterface.html) interface:
+Search criteria are found in the `Ibexa\Contracts\ConnectorAi\ActionConfiguration\Query\Criterion` namespace, implementing the [CriterionInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ConnectorAi-ActionConfiguration-Query-CriterionInterface.html) interface:
 
 | Criterion | Description |
 |---|---|

docs/search/ai_actions_search_reference/action_configuration_sort_clauses.md

@@ -1,5 +1,6 @@
 ---
 month_change: false
+description: Sort Clauses available for Action Configuration search
 ---
 
 # Action Configuration Search Sort Clauses reference

main.py

@@ -57,7 +57,13 @@ def cards(pages, columns=1, style="cards", force_version=False):
         if isinstance(pages, str):
             pages = [pages]
         cards = []
-        for page in pages:
+        for page_data in pages:
+            if isinstance(page_data, tuple):
+                page, custom_title, custom_description = page_data
+            else:
+                page = page_data
+                custom_title = None
+                custom_description = None
             match = re.search("https://[^@/]+.ibexa.co", page)
             if match:
                 with urllib.request.urlopen(page) as file:
@@ -81,8 +87,12 @@ def cards(pages, columns=1, style="cards", force_version=False):
                         else:
                             description = ""
                     href = page
+                title = custom_title if custom_title else title
+                title = title.replace("(Ibexa Documentation)", "").strip()
+                description = custom_description if custom_description else description
             else:
-                with open("docs/%s.md" % page, "r") as doc_file:
+                file, _ = page.split("#") if "#" in page else (page, "")
+                with open("docs/%s.md" % file, "r") as doc_file:
                     doc = doc_file.read()
                     match = re.search("^# (.*)", doc, re.MULTILINE)
                     if match:
@@ -105,8 +115,9 @@ def cards(pages, columns=1, style="cards", force_version=False):
                         version,
                         page
                     ))
-                    title = doc_meta['short'] or doc_meta['title']
-                    description = doc_meta['description'] or " "
+                title = custom_title if custom_title else doc_meta['short'] or doc_meta['title']
+                description = custom_description if custom_description else doc_meta['description'] or " "
+
             cards.append(
                 CARDS_TEMPLATE % (
                     href,