1.4 Changelog Updates: Giscus light/dark themes

[cwickham]

Moved from #7906

• (#4820): Add support for setting the Giscus light/dark themes.

[cderv]

it seems for the commenting section we are keeping things short: https://quarto.org/docs/output-formats/html-basics.html#commenting

Review the Giscus documentation for instructions on setting up Giscus in your repository. Additional options are covered here.

Currently, the reference documentation should already cover the new options through the schema

quarto-cli/src/resources/schema/definitions.yml

Lines 269 to 294 in d587180

	theme:
	anyOf:
	- string
	- enum:
	[
	light,
	light_high_contrast,
	light_protanopia,
	dark,
	dark_high_contrast,
	dark_protanopia,
	dark_dimmed,
	transparent_dark,
	preferred_color_scheme,
	]
	- object:
	closed: true
	properties:
	light:
	string:
	description: The light theme name.
	dark:
	string:
	description: The dark theme name.
	description: The giscus theme to use when displaying comments.

However, the description could be improved with details about the possible values.

So, should we document this new light/dark theme as part of the schema long description?
Or do we want to add more to https://quarto.org/docs/output-formats/html-basics.html#commenting?

Or even mention this elsewhere in themes (maybe a link, at least in that case ?)

I can definitely work on this, but needed do discuss this before doing a PR. Thanks

[cwickham]

Since we don't talk about theme currently on https://quarto.org/docs/output-formats/html-basics.html#commenting, I think the changes should be to the Reference page.

The reference page generation script doesn't reveal parts of the schema below the top-level options, so I think editing the long description is the best option here.