Epic: `_brand.yml`

[cscheid]

MVP:

• yaml intelligence: _brand.yml quarto#483
• automatic branding of quarto create
• merging of defaults.quarto metadata
• color
  • primary, background, foreground, secondary, tertiary
    • html (single documents + websites)
    • dashboard
    • revealjs
  • other color names
  • typst
    • TODO: @cscheid + @gordonwoodhull coordinate on this
  • public Lua API for access
  • shortcode
• typography
  • base, headings, monospace, monospace-inline, monospace-block:
    • html, revealjs, dashboard _brand.yml: fonts in html-like formats, font colors, schema updates, etc #10727
      • font properties. The full mapping is at src/core/sass/brand.ts; not all entries map to all formats/typeface configurations
      • family
      • size
      • weight
      • line-height
      • color
      • background-color
  • typst
  • public Lua API for access lua: expose quarto.brand; add has_mode() function #12486
  • shortcode
• logo
  • _brand.yml: logo forwarding to "bootstrap" formats #11002
  • brand epic: revealjs #10966
  • typst
  • public Lua API for access (brand,logo,lua - add support for resolving logo images in brand short… #11140)
  • shortcode (brand,logo,lua - add support for resolving logo images in brand short… #11140)
• Quarto-specific features:
  • path resolution rules, relative vs project-relative. TODO: resolve them in brand.ts
  • Brand overriding/configuration with brand: <filename> or brand: false
    • project-level
    • document-level
• preview monitoring of _brand.yml

PRs:

• _brand.yml - schemas/validation, storage, access in Lua #10250
• _brand.yml - color field into HTML formats #10327: color entries into HTML bootstrap SASS
• _brand.yml - pass colors to revealjs theme. use sass 'primary' variable for links in revealjs #10341: color entries into revealjs SASS. Respect primary as link color
• _brand.yml - Lua API, shortcodes #10362: color: Lua API, brand shortcode (currently only color support)
• brand,project - store and forward per-file brand information #10623
• _brand.yml: fonts in html-like formats, font colors, schema updates, etc #10727
• brand epic: revealjs #10966
• _brand.yml: logo forwarding to "bootstrap" formats #11002
• brand,logo,lua - add support for resolving logo images in brand short… #11140: logo shortcode and Lua API.

Verification:

• Kitchen sink example for cross-format comparison: https://github.com/quarto-dev/quarto-cli/blob/main/tests/docs/brand-yaml/kitchen-sink/brand-typography.qmd

Docs:

Main docs entry point at https://github.com/quarto-dev/quarto-web/blob/prerelease/docs/authoring/brand.qmd

• Explain changes in themes
  • revealjs now follows bootstrappy sass names.
    • primary for link colors
• Shortcode
• Lua API