From dec859b39ee1aee7e0122cf8a90bd7d72715063d Mon Sep 17 00:00:00 2001 From: Artem Kladov Date: Thu, 30 Jul 2026 19:07:09 +0300 Subject: [PATCH 1/4] [docs] Add LLM output formats and fix sitemap paths - Enable markdown, llms, corpus, and print output formats on documentation section indexes for both languages to support AI-agent-consumable content generation - Relocate per-language sitemaps into the documentation subdirectory during the build setup phase and disable the global sitemap output to align with the nested URL structure - Bump the Hugo web product module dependency to pick up the new output format definitions and LLM summary configuration support Signed-off-by: Artem Kladov --- config/_default/hugo.yaml | 7 ++++++- content/documentation/_index.md | 4 ++++ content/documentation/_index.ru.md | 4 ++++ go.mod | 4 ++-- go.sum | 4 ++-- werf.yaml | 2 ++ 6 files changed, 20 insertions(+), 5 deletions(-) diff --git a/config/_default/hugo.yaml b/config/_default/hugo.yaml index a987303..48ce229 100644 --- a/config/_default/hugo.yaml +++ b/config/_default/hugo.yaml @@ -45,7 +45,7 @@ disableKinds: - robotsTXT - RSS #- section -- sitemap +#- sitemap - taxonomy - term @@ -67,6 +67,11 @@ params: # Enable Lunr.js offline search offlineSearch: true + # Optional one-sentence summary for /{lang}/documentation/llms.txt (AI agents). + # Default: "Documentation for ." + # llms: + # summary: "..." + # Global relevant links. links: diff --git a/content/documentation/_index.md b/content/documentation/_index.md index 0eda738..ffd1c05 100644 --- a/content/documentation/_index.md +++ b/content/documentation/_index.md @@ -7,7 +7,11 @@ params: no_list: true outputs: - HTML + - markdown - search + - llms + - corpus + - print cascade: params: simple_list: true diff --git a/content/documentation/_index.ru.md b/content/documentation/_index.ru.md index b1eb8df..a51fc19 100644 --- a/content/documentation/_index.ru.md +++ b/content/documentation/_index.ru.md @@ -7,7 +7,11 @@ params: no_list: true outputs: - HTML + - markdown - search + - llms + - corpus + - print cascade: params: simple_list: true diff --git a/go.mod b/go.mod index 7d0549f..29a157c 100644 --- a/go.mod +++ b/go.mod @@ -1,8 +1,8 @@ module github.com/deckhouse/website-delivery-kit -// replace github.com/deckhouse/hugo-web-product-module => /hugo-web-product-module + //replace github.com/deckhouse/hugo-web-product-module => ../hugo-web-product-module go 1.24.2 -require github.com/deckhouse/hugo-web-product-module v0.1.23 // indirect +require github.com/deckhouse/hugo-web-product-module v0.1.24 // indirect diff --git a/go.sum b/go.sum index 1e1bd84..3d73b13 100644 --- a/go.sum +++ b/go.sum @@ -1,2 +1,2 @@ -github.com/deckhouse/hugo-web-product-module v0.1.23 h1:tgadyMP55nKQ6SS1ae9dNO+vwOJB8TZi7IaWymdxg6o= -github.com/deckhouse/hugo-web-product-module v0.1.23/go.mod h1:iLVlLSCkbOoi7RjYm5RjwAQi+Whs6DjSumhaH1GBjqw= +github.com/deckhouse/hugo-web-product-module v0.1.24 h1:UUsgCDrFOkVdGuIqENt+/tUTtWbgE6Hr4rn5kqiYVgQ= +github.com/deckhouse/hugo-web-product-module v0.1.24/go.mod h1:iLVlLSCkbOoi7RjYm5RjwAQi+Whs6DjSumhaH1GBjqw= diff --git a/werf.yaml b/werf.yaml index 03aadc3..4dd7dc3 100644 --- a/werf.yaml +++ b/werf.yaml @@ -8,6 +8,8 @@ final: false shell: setup: - hugo -s /src -d /out --minify --enableGitInfo=false + - mv -f /out/ru/sitemap.xml /out/ru/documentation/sitemap.xml + - mv -f /out/en/sitemap.xml /out/en/documentation/sitemap.xml git: - add: / to: /src From 8e9d317a5e8032d38d6bbe663e50afaf268bfc81 Mon Sep 17 00:00:00 2001 From: Artem Kladov <6360800+z9r5@users.noreply.github.com> Date: Thu, 30 Jul 2026 19:08:23 +0300 Subject: [PATCH 2/4] Apply suggestion from @z9r5 Signed-off-by: Artem Kladov <6360800+z9r5@users.noreply.github.com> --- go.mod | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/go.mod b/go.mod index 29a157c..b77530f 100644 --- a/go.mod +++ b/go.mod @@ -1,6 +1,6 @@ module github.com/deckhouse/website-delivery-kit - //replace github.com/deckhouse/hugo-web-product-module => ../hugo-web-product-module +//replace github.com/deckhouse/hugo-web-product-module => ../hugo-web-product-module go 1.24.2 From e2d6c53b40c9513e84ef1e23e0557d3dee2712a9 Mon Sep 17 00:00:00 2001 From: Artem Kladov <6360800+z9r5@users.noreply.github.com> Date: Thu, 30 Jul 2026 19:08:44 +0300 Subject: [PATCH 3/4] Apply suggestion from @z9r5 Signed-off-by: Artem Kladov <6360800+z9r5@users.noreply.github.com> --- go.mod | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/go.mod b/go.mod index b77530f..be395b7 100644 --- a/go.mod +++ b/go.mod @@ -1,6 +1,6 @@ module github.com/deckhouse/website-delivery-kit -//replace github.com/deckhouse/hugo-web-product-module => ../hugo-web-product-module +// replace github.com/deckhouse/hugo-web-product-module => ../hugo-web-product-module go 1.24.2 From 52cf5f5f036ced4b08020e0d1bed9dde9272bc7d Mon Sep 17 00:00:00 2001 From: Artem Kladov Date: Thu, 30 Jul 2026 19:10:58 +0300 Subject: [PATCH 4/4] [docs] Add LLM output formats and fix sitemap paths - Enable markdown, llms, corpus, and print output formats on documentation section indexes for both languages to support AI-agent-consumable content generation - Relocate per-language sitemaps into the documentation subdirectory during the build setup phase and disable the global sitemap output to align with the nested URL structure - Bump the Hugo web product module dependency to pick up the new output format definitions and LLM summary configuration support Signed-off-by: Artem Kladov --- config/_default/hugo.yaml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/config/_default/hugo.yaml b/config/_default/hugo.yaml index 48ce229..cd441c6 100644 --- a/config/_default/hugo.yaml +++ b/config/_default/hugo.yaml @@ -52,6 +52,10 @@ disableKinds: enableGitInfo: true +outputs: + page: [HTML, markdown] + section: [HTML, markdown] + sitemap: filename: "sitemap.xml" priority: 0.75