From 03accb90e5884eee38d2175e097a3b89b1d933fb Mon Sep 17 00:00:00 2001
From: Patrick Kollitsch <davidsneighbourdev+gh@gmail.com>
Date: Thu, 19 Nov 2026 11:51:55 +0000
Subject: [PATCH] feat(layouts): deprecate overriding the header partials
---
layouts/_partials/func/debug-cli.html | 39 ++++++++++++++++++++++++++++++++++++---
1 files changed, 36 insertions(+), 3 deletions(-)
diff --git a/layouts/_partials/func/debug-cli.html b/layouts/_partials/func/debug-cli.html
index acd844d..ecefeea 100644
--- a/layouts/_partials/func/debug-cli.html
+++ b/layouts/_partials/func/debug-cli.html
@@ -14,6 +14,20 @@
*/}}
{{/*
+Parameters:
+
+@param message string The message.
+@param severity string debug, info, warning, error, or deprecated.
+@param id string Optional. Log id. With an id, the message is logged
+ with fmt.Warnidf or fmt.Erroridf, so a site can
+ suppress it with `ignoreLogs = ['<id>']`.
+
+The `deprecated` severity is for deprecation notices. It is always printed,
+whatever the verbosity is, in the warning colour with the label DEPR. Hugo
+prints an identical message only once per build.
+*/}}
+
+{{/*
| Primary | `#AA99FF` | `170, 153, 255` |
| Ananke | `#FF80BF` | `255, 128, 191` |
| Comment | `#708CA9` | `112, 140, 169` |
@@ -39,6 +53,8 @@
{{- $severity = "error" -}}
{{- else if compare.Eq $severity "infos" -}}
{{- $severity = "info" -}}
+{{- else if or (compare.Eq $severity "deprecation") (compare.Eq $severity "depr") -}}
+ {{- $severity = "deprecated" -}}
{{- end -}}
{{- $verbosity := $config.verbosity | compare.Default "error" -}}
@@ -54,7 +70,9 @@
{{- end -}}
{{- $shouldOutput := false -}}
-{{- if compare.Eq $verbosity "debug" -}}
+{{- if compare.Eq $severity "deprecated" -}}
+ {{- $shouldOutput = true -}}
+{{- else if compare.Eq $verbosity "debug" -}}
{{- $shouldOutput = true -}}
{{- else if and (compare.Eq $verbosity "info") (not (compare.Eq $severity "debug")) -}}
{{- $shouldOutput = true -}}
@@ -76,12 +94,27 @@
{{- else if compare.Eq $severity "debug" -}}
{{- $colourLevel = $colourComment -}}
{{- $severityLabel = "DEBG" -}}
+{{- else if compare.Eq $severity "deprecated" -}}
+ {{- $colourLevel = $colourWarning -}}
+ {{- $severityLabel = "DEPR" -}}
{{- end -}}
+{{/* Deprecation notices show the whole message in the warning colour. */}}
+{{- $colourMessage := compare.Conditional (compare.Eq $severity "deprecated") $colourWarning $colourComment -}}
+
{{- if $shouldOutput -}}
+ {{- $line := fmt.Printf "%s%s%s/%s%s %s%s%s" $colourAnanke $namespace $colourComment $colourLevel $severityLabel $colourMessage .message $colourReset -}}
{{- if compare.Eq $severity "error" -}}
- {{- fmt.Errorf (fmt.Printf "%s%s%s/%s%s %s%s%s" $colourAnanke $namespace $colourComment $colourLevel $severityLabel $colourComment .message $colourReset) -}}
+ {{- with .id -}}
+ {{- fmt.Erroridf . "%s" $line -}}
+ {{- else -}}
+ {{- fmt.Errorf "%s" $line -}}
+ {{- end -}}
{{- else -}}
- {{- fmt.Warnf (fmt.Printf "%s%s%s/%s%s %s%s%s" $colourAnanke $namespace $colourComment $colourLevel $severityLabel $colourComment .message $colourReset) -}}
+ {{- with .id -}}
+ {{- fmt.Warnidf . "%s" $line -}}
+ {{- else -}}
+ {{- fmt.Warnf "%s" $line -}}
+ {{- end -}}
{{- end -}}
{{- end -}}
--
Gitblit v1.10.0