feat: add auto-generated llms.txt file for all localizations

Author: xirehat

hugo.toml

@@ -81,7 +81,7 @@ blog = "/:section/:year/:month/:day/:slug/"
 
 # Be explicit about the output formats. We (currently) only want an RSS feed for the home page.
 [outputs]
-home = [ "HTML", "RSS", "HEADERS" ]
+home = [ "HTML", "RSS", "HEADERS", "TXT" ]
 page = [ "HTML"]
 section = [ "HTML", "print" ]
 
@@ -101,6 +101,11 @@ baseName = "_headers"
 isPlainText = true
 notAlternative = true
 
+[outputFormats.TXT]
+mediaType = "text/plain"
+baseName = "llms"
+isPlainText = true
+
 # Image processing configuration.
 [imaging]
 resampleFilter = "CatmullRom" # cSpell:disable-line

layouts/_default/index.txt

@@ -0,0 +1,46 @@
+{{ with .Site.Title -}}
+    # {{ . }}
+{{- end }}
+
+{{ with .Site.Params.Description -}}
+> {{ . }}
+{{- end }}
+
+{{ range (sort ((.Site.GetPage "/").Pages) "Weight" "asc" "Date" "desc" "Lastmod" "desc") -}}
+    - [{{ .Title }}]({{ .Permalink }}): {{ .Description }}
+{{ end -}}
+
+{{/* Sections */}}
+{{ range (sort ((.Site.GetPage "/").Sections) "Weight" "asc" "Date" "desc" "Lastmod" "desc") -}}
+{{ with .Title -}}
+    ## {{ . }}
+{{- end }}
+
+{{ with .Description -}}
+    > {{ . }}
+{{- end }}
+
+{{ range (sort .Pages "Weight" "asc" "Date" "desc" "Lastmod" "desc") -}}
+    {{ if .Title -}}
+        - [{{ .Title }}]({{ .Permalink }}){{ with .Description }}: {{ . }}{{ end }}
+    {{- end }}
+{{ end -}}
+
+{{/* Sub-Sections */}}
+{{ range (sort .Sections "Weight" "asc" "Date" "desc" "Lastmod" "desc") -}}
+{{ with .Title -}}
+    ### {{ . }}
+{{- end }}
+
+{{ with .Description -}}
+    > {{ . }}
+{{- end }}
+
+{{ range (sort .Pages "Weight" "asc" "Date" "desc" "Lastmod" "desc") -}}
+    {{ if .Title -}}
+        - [{{ .Title }}]({{ .Permalink }}){{ with .Description }}: {{ . }}{{ end }}
+    {{- end }}
+{{ end }}
+{{ end -}}
+
+{{ end -}}