diff --git a/docs/content/_index.md b/docs/content/_index.md index ef44d7b..0012714 100644 --- a/docs/content/_index.md +++ b/docs/content/_index.md @@ -1,6 +1,12 @@ --- title: 'certel' toc: false +# Give every descendant page the docs layout so the left navigation sidebar +# persists on single pages too (metrics, alternatives, and each ADR). Without +# this they fall back to Hextra's centered no-sidebar single layout. The +# cascade does not apply to this home page itself, so the landing cards stay. +cascade: + type: docs --- **Cert**ificate **E**xpiry & **L**ogs. diff --git a/docs/content/adr/adr-0000-template.md b/docs/content/adr/adr-0000-template.md index 64b3def..4421940 100644 --- a/docs/content/adr/adr-0000-template.md +++ b/docs/content/adr/adr-0000-template.md @@ -1,7 +1,13 @@ --- title: 'NNNN. Short title of the decision' weight: 999 +# This is the copy-me scaffold, not a real decision: keep it reachable via the +# explicit link in the ADR index Conventions section, but out of the auto-built +# navigation sidebar, the site search, and the generated llms.txt outline. excludeSearch: true +llms: false +sidebar: + exclude: true --- - **Status:** Proposed | Accepted | Superseded by NNNN | Deprecated diff --git a/docs/content/alternatives.md b/docs/content/alternatives.md index 735eff0..7c2c1c7 100644 --- a/docs/content/alternatives.md +++ b/docs/content/alternatives.md @@ -1,7 +1,7 @@ --- title: 'Survey of existing SSL certificate monitoring tools' linkTitle: 'Alternatives' -weight: 20 +weight: 40 --- An analysis of open-source alternatives carried out before development started diff --git a/docs/hugo.toml b/docs/hugo.toml index 813da29..d65e470 100644 --- a/docs/hugo.toml +++ b/docs/hugo.toml @@ -6,6 +6,13 @@ title = "certel" enableRobotsTXT = true enableGitInfo = true +# Emit an llms.txt at the site root — a structured outline of every section and +# page for AI agents/LLMs. Only the home kind carries the extra format; page and +# section keep Hugo's defaults. Exclude a page with `llms: false` in its front +# matter. The template pulls the site description below into the summary line. +[outputs] + home = ["html", "llms"] + [module] [[module.imports]] path = "github.com/imfing/hextra" @@ -24,13 +31,9 @@ enableGitInfo = true [menu] [[menu.main]] - name = "Documentation" + name = "Home" pageRef = "/" weight = 1 - [[menu.main]] - name = "ADRs" - pageRef = "/adr" - weight = 2 [[menu.main]] name = "Search" weight = 3 @@ -44,6 +47,8 @@ enableGitInfo = true icon = "github" [params] + description = "Self-hosted SSL/TLS certificate monitor: a single binary and a single YAML file, with templated webhook alerts and optional Prometheus metrics." + [params.navbar] displayTitle = true displayLogo = false diff --git a/docs/i18n/en.yaml b/docs/i18n/en.yaml new file mode 100644 index 0000000..eccd3f2 --- /dev/null +++ b/docs/i18n/en.yaml @@ -0,0 +1 @@ +copyright: "© 2026 [certel](https://github.com/antonkomarev/certel)"