Markdown versions of all docs pages are available by appending .md to any docs URL.

Every themeExtras config key the module reads.

Every themeExtras.* key this module reads, discovered by scanning layouts/ and assets/ rather than from a hand-kept list, so a key added to a template shows up here whether or not anyone remembered to document it.

[params.themeExtras]
  brand = "oss"   # or "enterprise"

themeExtras.alertTypes

Custom GitHub-style alert types, beyond the built-in set plus this module’s own [!SOLO] and [!SUCCESS]. An unknown type still warns and falls back to the default style, so a typo is visible rather than silent.

Read in assets/css/print-book.css, layouts/_markup/render-blockquote-alert.html, layouts/_partials/components/github-style-alert.html.

themeExtras.brand

Selects the brand CSS layer loaded on top of the component baseline: oss loads brand-oss.css, enterprise loads brand-enterprise.css. Omit it entirely to get the neutral defaults with no brand layer. This is the only key most consumers set.

Read in assets/css/docs-theme-extras.css, layouts/_partials/breadcrumb.html, layouts/_partials/docs/book-document.html, layouts/partials/themeExtras/head-end.html.

themeExtras.changeHighlights

Turns the change-highlights overlay on or off. Unset, it is on under hugo server only, and off in every built site. true turns it on in any environment: a PR preview opts in with HUGO_PARAMS_THEMEEXTRAS_CHANGEHIGHLIGHTS=true on preview builds only. Never set true in a config that a production build reads. false turns it off everywhere, and any other value fails the build. The overlay only shows anything when scripts/changes_manifest.py has written static/_extras/changes.json. See Change highlights for what reviewers see and how to set it up.

Read in layouts/_partials/utils/change-highlights-enabled.html, layouts/_partials/utils/change-highlights.html.

themeExtras.logo

Logo used in the schema.org Organization block. Falls back to the navbar logo, and is left empty when neither is set. This is metadata only — it does not affect what renders in the navbar.

Read in layouts/_partials/schema.html.

themeExtras.outputs

A table, not a scalar. Its markdown key gates half of the llms.txt directive, so the directive never advertises a URL that would 404. Set outputs.markdown = false when the site does not publish the Markdown output format.

Read in layouts/_partials/docs-llms-directive.html.

themeExtras.prodHost

Production host used for the absolute URLs that some outputs must carry: links in the Copy-as-Markdown output and llms.txt, every URL in sitemap.xml and the multilingual sitemap index, the canonical link, the Open Graph URL, image, and video tags, the Twitter card image, and the schema.org JSON-LD. Resolution order is this key, then the host from baseURL, then empty — so a site whose baseURL already carries a scheme and host does not need to set it. A site with a host-less baseURL ("/") must set it, or those outputs carry root-relative URLs, which the sitemap protocol and Open Graph do not allow.

Read in layouts/_partials/head.html, layouts/_partials/opengraph.html, layouts/_partials/page-to-markdown.html, layouts/partials/copy-markdown.html, layouts/partials/utils/prod-host.html.

themeExtras.schemaOrgName

Organization name in the schema.org JSON-LD block. Defaults to site.Title, which is usually right; set it when the legal or brand name differs from the site title.

Read in layouts/_partials/schema.html.

themeExtras.twitterSite

Value for the twitter:site meta tag, for example @soloio_inc. Omitted from the page entirely when unset.

Read in layouts/_partials/twitter_cards.html.

themeExtras.warnMissingDescription

Set to false to silence the per-page warning for a page with no front-matter description. Leave it on: without a description, the description meta tag, OpenGraph, Twitter card and JSON-LD all fall back to the raw page summary. Treat any opt-out as temporary, held only while a backlog of missing descriptions is worked through.

Read in layouts/partials/themeExtras/head-end.html, layouts/partials/utils/warn-missing-description.html.