From f0eafa7132b078172a79fafa888a26aebd7677e4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Fri, 17 Jul 2026 13:33:18 +0200 Subject: [PATCH 1/6] AFDocs: LLM and Markdown discoverability --- mkdocs.yml | 2 ++ theme/main.html | 7 ++++++- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index 4620a3e4..3639c4f2 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,6 +1,8 @@ INHERIT: plugins.yml site_name: User Documentation +site_description: >- + User documentation for Ibexa DXP covers content management, product catalog, commerce,and site administration for editors and business users. repo_url: https://github.com/ezsystems/user-documentation site_url: https://doc.ibexa.co/projects/userguide/en/latest/ copyright: "Copyright 1999-2026 Ibexa AS and others" diff --git a/theme/main.html b/theme/main.html index bdbda737..88e330d8 100644 --- a/theme/main.html +++ b/theme/main.html @@ -1,4 +1,5 @@ {% extends "base.html" %} +{% set md_href = page.file.dest_uri | replace('.html', '.md') if page else '' %} {% block htmltitle %} {%- if page and page.meta and page.meta.title -%} {{ page.meta.title }} @@ -20,7 +21,6 @@ {% if page and not page.meta.exclude_from_llmstxt %} - {% set md_href = page.file.dest_uri | replace('.html', '.md') %} {% endif %} @@ -58,6 +58,11 @@ {% block content %} + + {% set ns = namespace(bootstrap_extra_css='') %} {% for md_file in config.extra.append_bootstrap if 'docs' + md_file in page.edit_url %} {% set ns.bootstrap_extra_css = ' bootstrap-iso' %} From cf3408cb92a5203f220f61cb673b7c7b5c23086a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Fri, 17 Jul 2026 15:04:28 +0200 Subject: [PATCH 2/6] Updated base_url for llmstxt --- plugins.yml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/plugins.yml b/plugins.yml index 3e76ae52..181dbcb4 100644 --- a/plugins.yml +++ b/plugins.yml @@ -68,7 +68,11 @@ plugins: - llmstxt: preprocess: llmstxt_preprocess.py - + + # Pin links in the generated Markdown (and llms.txt) to this branch's + # version instead of site_url's en/latest, without affecting the HTML + # site's canonical URLs. Update when branching a new version. + base_url: https://doc.ibexa.co/en/5.0/ autoclean: false full_output: llms-full.txt sections: From 0734ec014cd7f0d7e4a4a5166ee1cae818b0cfaa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Fri, 17 Jul 2026 17:09:31 +0200 Subject: [PATCH 3/6] Fixed baseurl --- plugins.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugins.yml b/plugins.yml index 181dbcb4..6a0eca01 100644 --- a/plugins.yml +++ b/plugins.yml @@ -72,7 +72,7 @@ plugins: # Pin links in the generated Markdown (and llms.txt) to this branch's # version instead of site_url's en/latest, without affecting the HTML # site's canonical URLs. Update when branching a new version. - base_url: https://doc.ibexa.co/en/5.0/ + base_url: https://doc.ibexa.co/projects/userguide/en/5.0/ autoclean: false full_output: llms-full.txt sections: From e849340178a43824e580a9d0299fb82692efe13e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Tue, 21 Jul 2026 11:42:36 +0200 Subject: [PATCH 4/6] Updated description --- mkdocs.yml | 2 -- plugins.yml | 3 ++- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/mkdocs.yml b/mkdocs.yml index 3639c4f2..4620a3e4 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,8 +1,6 @@ INHERIT: plugins.yml site_name: User Documentation -site_description: >- - User documentation for Ibexa DXP covers content management, product catalog, commerce,and site administration for editors and business users. repo_url: https://github.com/ezsystems/user-documentation site_url: https://doc.ibexa.co/projects/userguide/en/latest/ copyright: "Copyright 1999-2026 Ibexa AS and others" diff --git a/plugins.yml b/plugins.yml index 6a0eca01..431d046f 100644 --- a/plugins.yml +++ b/plugins.yml @@ -68,7 +68,8 @@ plugins: - llmstxt: preprocess: llmstxt_preprocess.py - + markdown_description: >- + User documentation for Ibexa DXP covers content management, product catalog, commerce, and site administration for editors and business users. # Pin links in the generated Markdown (and llms.txt) to this branch's # version instead of site_url's en/latest, without affecting the HTML # site's canonical URLs. Update when branching a new version. From 88750c275c888e254f815e9d295a98c91bcfb6c7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Tue, 21 Jul 2026 13:11:00 +0200 Subject: [PATCH 5/6] Added blockquote --- plugins.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugins.yml b/plugins.yml index 431d046f..a9270a73 100644 --- a/plugins.yml +++ b/plugins.yml @@ -69,7 +69,7 @@ plugins: - llmstxt: preprocess: llmstxt_preprocess.py markdown_description: >- - User documentation for Ibexa DXP covers content management, product catalog, commerce, and site administration for editors and business users. + > User documentation for Ibexa DXP covers content management, product catalog, commerce, and site administration for editors and business users. # Pin links in the generated Markdown (and llms.txt) to this branch's # version instead of site_url's en/latest, without affecting the HTML # site's canonical URLs. Update when branching a new version. From 16b30fca86072d82f02ba76db58a9bd8fe817ef7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Tue, 21 Jul 2026 14:57:49 +0200 Subject: [PATCH 6/6] Nav -> div changes --- theme/main.html | 7 +++++-- theme/partials/nav-item.html | 8 ++++++-- theme/partials/nav.html | 7 +++++-- theme/partials/toc.html | 11 +++++++---- 4 files changed, 23 insertions(+), 10 deletions(-) diff --git a/theme/main.html b/theme/main.html index 88e330d8..f13e89e1 100644 --- a/theme/main.html +++ b/theme/main.html @@ -30,7 +30,10 @@ {% block site_nav %} {% if nav %} -
+ {# The single
- + {% endif %} {% if page.toc %}
diff --git a/theme/partials/nav-item.html b/theme/partials/nav-item.html index 006289ea..a647322a 100644 --- a/theme/partials/nav-item.html +++ b/theme/partials/nav-item.html @@ -9,7 +9,8 @@ -
{% elif nav_item == page %}
  • @@ -40,6 +41,9 @@ {% if nav_item.meta.month_change %}New{% endif %} {% if toc | first is defined %} + {# toc_inside_nav: render the TOC with a
    wrapper because it sits inside the + sidebar
    • diff --git a/theme/partials/nav.html b/theme/partials/nav.html index a63cd746..b2934a1a 100644 --- a/theme/partials/nav.html +++ b/theme/partials/nav.html @@ -1,4 +1,7 @@ -