Skip to content

llms txt fixes #23718

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Nov 13, 2025
Merged

llms txt fixes #23718

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
be9c6d7
llms.txt: reduce whitespaces and remove dud entries
dvdksn Nov 11, 2025
69e7b81
llms.txt: add page descriptions
dvdksn Nov 11, 2025
3a8312b
llms.txt: resolve shortcodes in rendered Markdown
dvdksn Nov 11, 2025
e17aa3e
llms.txt: only render section links to existing pages
dvdksn Nov 11, 2025
d4bbf9b
llms.txt: add markup for h1
dvdksn Nov 11, 2025
5a8fdb1
hugo: remove redundant outputformats config
dvdksn Nov 12, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 2 additions & 15 deletions hugo.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -101,10 +88,10 @@ outputs:
- llms
page:
- html
- Markdown
- markdown
section:
- html
- Markdown
- markdown

languages:
en:
Expand Down
16 changes: 12 additions & 4 deletions layouts/_default/index.llms.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 }}
12 changes: 5 additions & 7 deletions layouts/_default/list.markdown.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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 }}
5 changes: 2 additions & 3 deletions layouts/_default/single.markdown.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,2 @@
{{ .Title }}

{{ .RawContent }}
# {{ .Title }}
{{ .RenderShortcodes }}