Merge pull request #23718 from dvdksn/llms-txt-fixes

llms txt fixes

Author: dvdksn

hugo.yaml

@@ -69,19 +69,6 @@ outputFormats:
     isPlainText: true
     mediaType: "application/json"
     notAlternative: true
-  # robots.txt, see: layouts/index.robots.json
-  robots:
-    baseName: robots
-    isPlainText: true
-    mediaType: "text/plain"
-    notAlternative: true
-  # Markdown for LLMs, see layouts/_default/single.markdown.md
-  Markdown:
-    baseName: index
-    mediaType: "text/markdown"
-    isPlainText: true
-    isHTML: false
-    permalinkable: false
   # llms.txt
   llms:
     baseName: llms
@@ -101,10 +88,10 @@ outputs:
     - llms
   page:
     - html
-    - Markdown
+    - markdown
   section:
     - html
-    - Markdown
+    - markdown
 
 languages:
   en:

layouts/_default/index.llms.txt

@@ -3,9 +3,17 @@
 {{- $grouped := $sorted.GroupBy "Section" -}}
 
 # Docker Documentation
+{{- range $grouped }}
 
-{{ range $grouped }}
 ## {{ humanize .Key }}
-{{ range .Pages }}
-- [{{ .Title }}]({{ .Permalink }}){{ end }}
-{{ end -}}
+{{- range .Pages }}
+{{- template "pageItem" . }}
+{{- end }}
+{{- end -}}
+
+{{- define "pageItem" }}
+{{- if and .Title .Permalink }}
+- [{{ .Title }}]({{ .Permalink }})
+  {{- with .Description }}: {{ chomp (replace . "\n" " ") }}{{- end }}
+{{- end }}
+{{- end }}

layouts/_default/list.markdown.md

@@ -1,7 +1,5 @@
-{{ .Title }}
-
-{{ .RawContent }}
-
-{{ range .Pages }}
-- [{{ .Title }}](https://docs.docker.com{{ .RelPermalink }})
-{{ end }}
+# {{ .Title }}
+{{ .RenderShortcodes }}
+{{ range where .Pages "Permalink" "ne" "" }}
+- [{{ .Title }}]({{ .Permalink }})
+{{ end }}

layouts/_default/single.markdown.md

@@ -1,3 +1,2 @@
-{{ .Title }}
-
-{{ .RawContent }}
+# {{ .Title }}
+{{ .RenderShortcodes }}