{html_module.escape(code_elem.get_text())}", "html.parser")
+ )
+
+
+# ---------------------------------------------------------------------------
+# Frontmatter editions
+# ---------------------------------------------------------------------------
+
+def _get_editions_from_source(output: str) -> list:
+ """Return edition display names read from the source markdown frontmatter."""
+ # Map output path back to source: .../site/some/page/index.md -> .../docs/some/page.md
+ if "/site/" not in output:
+ return []
+
+ path = output.replace("/site/", "/docs/", 1)
+ if path.endswith("/index.md"):
+ path = path[: -len("/index.md")] + ".md"
+
+ if not os.path.exists(path):
+ return []
+
+ try:
+ from mkdocs.utils import meta as mkdocs_meta
+
+ with open(path, encoding="utf-8") as f:
+ content = f.read()
+ _, frontmatter = mkdocs_meta.get_data(content)
+
+ edition = frontmatter.get("edition")
+ editions = frontmatter.get("editions") or []
+
+ if isinstance(edition, str):
+ all_editions = [edition] + (editions if isinstance(editions, list) else [])
+ elif isinstance(edition, list):
+ all_editions = edition + (editions if isinstance(editions, list) else [])
+ else:
+ all_editions = editions if isinstance(editions, list) else []
+
+ return [FRONTMATTER_EDITION_DISPLAY.get(e, e) for e in all_editions if e]
+ except Exception:
+ return []
+
+
+def _process_frontmatter_editions(soup: "BeautifulSoup", output: str) -> None:
+ """Inject 'Editions: X, Y' paragraph after the first h1."""
+ editions = _get_editions_from_source(output)
+ if not editions:
+ return
+
+ p = soup.new_tag("p")
+ p.string = "Editions: " + ", ".join(editions)
+
+ h1 = soup.find("h1")
+ if h1:
+ h1.insert_after(p)
+ else:
+ soup.insert(0, p)
+
+
+# ---------------------------------------------------------------------------
+# Inline edition badge spans (from snippet includes)
+# ---------------------------------------------------------------------------
+
+def _process_inline_pills(soup: "BeautifulSoup") -> None:
+ """Replace inline edition pill spans with readable text, e.g. '(Experience)'."""
+ for span in soup.find_all("span", class_="pill--inline"):
+ span_classes = span.get("class", [])
+ for pill_cls, edition_name in PILL_CLASS_TO_EDITION.items():
+ if pill_cls in span_classes:
+ span.replace_with(soup.new_string(f" ({edition_name})"))
+ break
+
+
+# ---------------------------------------------------------------------------
+# Release notes filters
+# ---------------------------------------------------------------------------
+
+def _process_release_notes_filters(soup: "BeautifulSoup") -> None:
+ """Remove interactive release-notes filter UI elements."""
+ for container in soup.find_all("div", class_="release-notes-filters"):
+ container.decompose()
+
+
+# ---------------------------------------------------------------------------
+# Card macros
+# ---------------------------------------------------------------------------
+
+def _process_cards(soup: "BeautifulSoup") -> None:
+ """Convert card macro HTML structures into markdown-friendly lists with links."""
+ for cards_div in soup.find_all("div", class_=lambda c: c and c.startswith("cards ")):
+ card_wrappers = cards_div.find_all("div", class_="card-wrapper")
+
+ if not card_wrappers:
+ continue
+
+ ul = soup.new_tag("ul")
+
+ for card_wrapper in card_wrappers:
+ link = card_wrapper.find("a", class_="card")
+ if not link:
+ continue
+
+ href = link.get("href", "")
+ if href.startswith("//"):
+ href = "https:" + href
+
+ title_elem = link.find("p", class_="title")
+ description_elem = link.find("p", class_="description")
+
+ if not title_elem:
+ continue
+
+ title = title_elem.get_text(strip=True)
+ description = description_elem.get_text(strip=True) if description_elem else ""
+
+ li = soup.new_tag("li")
+ link_tag = soup.new_tag("a", href=href)
+ link_tag.string = title
+ li.append(link_tag)
+
+ if description:
+ li.append(soup.new_string(" - "))
+ li.append(soup.new_string(description))
+
+ ul.append(li)
+
+ cards_div.replace_with(ul)
diff --git a/mkdocs.yml b/mkdocs.yml
index a2082cc594..3f5f242903 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -2,6 +2,7 @@ INHERIT: plugins.yml
site_name: Developer Documentation
repo_url: https://github.com/ibexa/documentation-developer
+edit_uri: edit/5.0/docs/
site_url: https://doc.ibexa.co/en/latest/
copyright: "Copyright 1999-2026 Ibexa AS and others"
validation:
@@ -1092,3 +1093,6 @@ markdown_extensions:
custom_checkbox: true
- pymdownx.tilde
- pymdownx.details
+
+hooks:
+ - hooks.py
diff --git a/plugins.yml b/plugins.yml
index 77c3fd4879..6ffe173de5 100644
--- a/plugins.yml
+++ b/plugins.yml
@@ -586,3 +586,13 @@ plugins:
'ai_actions/install_ai_actions.md': 'ai_actions/configure_ai_actions.md'
'discounts/install_discounts.md': 'discounts/configure_discounts.md'
'content_management/collaborative_editing/install_collaborative_editing.md': 'content_management/collaborative_editing/configure_collaborative_editing.md'
+
+ - llmstxt:
+ preprocess: llmstxt_preprocess.py
+
+ autoclean: false
+ full_output: llms-full.txt
+ sections:
+ # Built automatically when running MkDocs build based on MkDocs nav configuration, don't change
+ Ibexa DXP developer documentation:
+ - index.md
diff --git a/requirements.txt b/requirements.txt
index c03e3d1a35..688d9446a1 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -7,3 +7,4 @@ mkdocs-macros-plugin==1.3.7
mkdocs-redirects==1.2.2
mkdocs-autolinks-plugin==0.7.1
Jinja2==3.1.6
+mkdocs-llmstxt
diff --git a/theme/assets/page-actions.js b/theme/assets/page-actions.js
new file mode 100644
index 0000000000..51faa495f1
--- /dev/null
+++ b/theme/assets/page-actions.js
@@ -0,0 +1,55 @@
+/**
+ * Page Actions JavaScript
+ * Handles functionality for page action buttons (Copy as Markdown, View as Markdown, Edit on GitHub)
+ */
+
+async function copyPageForLLM() {
+ const mdPath = document.querySelector('meta[name="markdown-path"]').content;
+
+ try {
+ const response = await fetch(mdPath);
+ if (!response.ok) {
+ throw new Error(`HTTP error! status: ${response.status}`);
+ }
+ const markdownContent = await response.text();
+ await navigator.clipboard.writeText(markdownContent);
+ showButtonFeedback('success', 'Copied!', '📋');
+ } catch (error) {
+ console.error('Failed to copy content:', error);
+ window.open(mdPath, '_blank');
+ showButtonFeedback('info', 'Opened in tab', '🔗');
+ }
+}
+
+function showButtonFeedback(type, message, icon) {
+ const button = document.querySelector('button[onclick="copyPageForLLM()"]');
+ if (!button) return;
+
+ const originalHTML = button.innerHTML;
+ button.innerHTML = `${icon} ${message}`;
+
+ if (type === 'success') {
+ button.classList.add('page-action-btn--success');
+ } else if (type === 'error') {
+ button.classList.add('page-action-btn--error');
+ } else if (type === 'info') {
+ button.classList.add('page-action-btn--info');
+ }
+
+ setTimeout(() => {
+ button.innerHTML = originalHTML;
+ button.classList.remove('page-action-btn--success', 'page-action-btn--error', 'page-action-btn--info');
+ }, 2000);
+}
+
+document.addEventListener('DOMContentLoaded', function() {
+ console.log('Page actions initialized');
+
+ const pageActions = document.getElementById('page-actions');
+ const firstH1 = document.querySelector('.bootstrap-iso h1, h1');
+
+ if (pageActions && firstH1) {
+ firstH1.insertAdjacentElement('afterend', pageActions);
+ pageActions.classList.add('page-actions--visible');
+ }
+});
diff --git a/theme/main.html b/theme/main.html
index 66ce7dc87d..e7051c6f61 100644
--- a/theme/main.html
+++ b/theme/main.html
@@ -13,6 +13,13 @@
+ {% if config.repo_url and page.edit_url %}
+
+
+ {% endif %}
+
+
+
{% endblock %}
{% block site_nav %}
{% if nav %}
@@ -75,7 +82,36 @@
{% endif %}
{% include "partials/eol_warning.html" %}
- {{ page.content }}
+
+