diff --git a/content/docs/_index.md b/content/docs/_index.md index 44bf520..51937f8 100644 --- a/content/docs/_index.md +++ b/content/docs/_index.md @@ -12,6 +12,20 @@ cascade: # Curated landing cards (headings + external video); the theme's # auto-generated child grid can't reproduce them, so suppress it. disableCards: true +# PDF export. This one page opting into `book` is the whole opt-in: the format +# stitches this page plus its entire .Pages subtree into one print document. This +# site is flat and unversioned, so there is exactly one page to target and the +# manual covers the whole of /docs/. +# +# LIST THE WHOLE SET, not just html and book. Hugo's `outputs` REPLACES a page's +# defaults rather than adding to them, so `["html", "book"]` would silently drop +# this page's .md, RSS and llms.txt. Nothing fails and only this page is +# affected, which is exactly why it would survive review. These four are +# `outputs.section` from hugo.yaml, copied, plus `book`. +# +# The book is not built by an ordinary build: docs-theme-extras gates it behind +# `HUGO_PARAMS_BUILDBOOK=true`, which only the PDF workflow in solo-io/docs sets. +outputs: ["html", "rss", "markdown", "llms", "book"] --- Agentregistry, an open source, secure, and centralized AI artifact catalog that helps you build, package, publish, discover, and govern Docker images for AI artifacts, including agents, skills, prompts, and MCP servers that are spread across multiple container registries and GitHub repositories. It provides a centralized view of the images you allow your teams to share and deploy into their environments. diff --git a/go.mod b/go.mod index 7788d20..85039e8 100644 --- a/go.mod +++ b/go.mod @@ -5,4 +5,4 @@ go 1.25.1 // docs-theme-extras declares the hextra import itself (pinned to v0.12.3), so // hextra is a transitive dependency and is not listed here — matching // agentgateway / kgateway / ambientmesh. Its checksums stay in go.sum. -require github.com/solo-io/docs-theme-extras v0.3.5 // indirect +require github.com/solo-io/docs-theme-extras v0.3.8 // indirect diff --git a/go.sum b/go.sum index bd60b62..3287469 100644 --- a/go.sum +++ b/go.sum @@ -1,2 +1,2 @@ -github.com/solo-io/docs-theme-extras v0.3.5 h1:KaCM1CaqV3IyyIY/7uc0z5WHutL0aHA4brV1zGwfGw0= -github.com/solo-io/docs-theme-extras v0.3.5/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= +github.com/solo-io/docs-theme-extras v0.3.8 h1:adccTdWRD21FHUhxv49RKW3VbP+y7d+jXzZMxADAWoM= +github.com/solo-io/docs-theme-extras v0.3.8/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= diff --git a/hugo.yaml b/hugo.yaml index 3920b17..47370f0 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -38,6 +38,30 @@ params: # preview URL. prodHost: "https://aregistry.ai" + # "Download all docs (PDF)" in the Copy-as-Markdown menu on docs pages, added by + # the module's copy-markdown.html. Setting `distribution` turns the item on and + # selects the solo-io/docs-pdfs release-asset URL shape, which the module + # supplies so it is not repeated per consumer: + # + # .../releases/download/{product}-{distribution}-{version}/{product}-{distribution}-{version}.pdf + # + # `{version}` resolves to `latest`: this site has no versions and registers no + # `params.sections`, so there is no version segment to substitute and no section + # to prefix it with. That substitution needs docs-theme-extras v0.3.8-beta.1 or + # later; on the v0.3.5 this site used to pin, the item did not render on an + # unversioned site at all and no configuration here could make it. solo-io/docs' + # pdf-export.yml labels this entry `latest` for the same reason, so the link and + # the published asset agree by construction. + # + # `product` is set explicitly because it is otherwise read from + # `params.currentProduct` or `params.folder`, and this site sets neither. + # + # The item renders only under /docs/, because it asks that section for its + # output formats — the marketing pages carry no `book` format and show nothing. + pdfDownload: + distribution: oss + product: agentregistry + theme: default: dark displayToggle: true