feat: enhanced llms.txt support

Author: davlgd

docs/hugo.yaml

@@ -14,8 +14,8 @@ hasCJKLanguage: true
 
 outputs:
   home: [html, llms]
-  page: [html]
-  section: [html, rss]
+  page: [html, markdown]
+  section: [html, markdown, rss]
 
 defaultContentLanguage: en
 languages:

hugo.toml

@@ -8,3 +8,6 @@
     baseName = 'llms'
     mediaType = 'text/plain'
     isPlainText = true
+  [outputFormats.markdown]
+    name = 'Markdown'
+    baseName = 'index.html'

layouts/list.md

@@ -0,0 +1,2 @@
+# {{ .Title }}
+{{ .RawContent | htmlUnescape }}

layouts/llms.txt

@@ -2,35 +2,49 @@
 
 > {{ .Site.Params.description }}
 
-{{ range $section := site.Sections }}
-{{- template "llms-section-tree" dict "context" . "level" 2 }}
-{{ end }}
+{{- if and (not .Params.llmsTxtOptional) (gt (len .Pages) 0) }}
+{{- $sortedSections := sort .Site.Sections "Title" }}
+{{- range $sortedSections }}
+{{- $allSections := slice . -}}
+{{- range .Sections -}}
+{{- if not .Params.llmsTxtOptional -}}
+{{- $allSections = $allSections | append . -}}
+{{- end -}}
+{{- end -}}
+{{- $sortedAllSections := sort $allSections "Title" -}}
+{{- range $sortedAllSections }}
 
-{{- $rootPages := where site.RegularPages "Section" "" }}
-{{- if $rootPages }}
+## {{ .Title }}
+{{- $pages := sort .Pages "Title" "asc" }}
+{{- range $pages }}
+- [{{ .Title }}]({{ .Permalink }}index.html.md): {{ .Summary | plainify | truncate 100 | strings.TrimSpace }}{{ if .Date }} - Published {{ .Date.Format "2006-01-02" }}{{ end }}
+{{- end }}
+{{- end }}
+{{- end }}
 
-## Root Pages
-{{- range $rootPages }}
-- [{{ .Title }}]({{ .Permalink }}): {{ .Summary | plainify | truncate 100 | strings.TrimSpace }}{{ if .Date }} - Published {{ .Date.Format "2006-01-02" }}{{ end }}
+## Optional
+{{- range .Site.Sections }}
+{{- if .Params.llmsTxtOptional }}
+{{- $pages := sort .Pages "Title" "asc" }}
+{{- range $pages }}
+- [{{ .Title }}]({{ .Permalink }}index.html.md){{ with .Description }}: {{ . }}{{ end }}
 {{- end }}
 {{- end }}
+{{- range .Sections }}
+{{- if .Params.llmsTxtOptional }}
+{{- $pages := sort .Pages "Title" "asc" }}
+{{- range $pages }}
+- [{{ .Title }}]({{ .RelPermalink }}index.html.md){{ with .Description }}: {{ . }}{{ end }}
+{{- end }}
+{{- end }}
+{{- end }}
+{{- end }}
+{{- else -}}
+{{- .RawContent | .Page.RenderString -}}
+{{- end -}}
+{{- "\n" -}}
+{{- "\n" -}}
 
 ---
 Generated on {{ now.Format "2006-01-02 15:04:05 UTC" }}
 Site: {{ .Site.BaseURL }}
-
-{{- define "llms-section-tree" -}}
-{{- $context := .context -}}
-{{- $level := .level | default 2 -}}
-{{- $headerHashes := strings.Repeat $level "#" -}}
-{{- "\n" -}}
-{{ $headerHashes }} {{ $context.Title }}
-
-{{- range $context.RegularPages }}
-- [{{ .Title }}]({{ .Permalink }}): {{ .Summary | plainify | truncate 100 | strings.TrimSpace }}{{ if .Date }} - Published {{ .Date.Format "2006-01-02" }}{{ end }}
-{{- end }}
-
-{{- range $context.Sections }}
-{{ template "llms-section-tree" dict "context" . "level" (add $level 1) }}
-{{- end }}
-{{- end -}}

layouts/single.md

@@ -0,0 +1,2 @@
+# {{ .Title }}
+{{ .RawContent | htmlUnescape }}