Warnings

Some inputs cannot be honoured exactly. There are three cases: a snippet too long to render legibly, described in the code template and reported the same way for a terminal session; a post whose badge prop is neither a badge nor false, described in Templates; and an image that will not fit its maxBytes cap even at the lowest quality.

Colophon renders anyway and reports the compromise through onWarning, which defaults to console.warn. Pass your build’s logger to route the messages somewhere else, or a no-op to silence them:

export default defineConfig({
  onWarning: () => {},
});

generate prefixes each message with the content file it came from, so a build over a whole tree still names the post to fix:

colophon: content/post/index.md: code snippet does not fit the 1200x630 image at
a legible size: 4 of 13 lines dropped. Shorten the sample, or lower
code.minFontScale to fit it in smaller.

onWarning is left out of the rebuild stamp, because where a message goes cannot change a pixel. It cannot be overridden per size for the same reason.