Epic: `_brand.yml`

[cscheid]

MVP:

• [x] https://github.com/quarto-dev/quarto/issues/483
• [ ] automatic branding of quarto create
• [ ] merging of defaults.quarto metadata
• [ ] color
  • [x] primary, background, foreground, secondary, tertiary
  • [x] html (single documents + websites)
  • [x] dashboard
  • [x] revealjs
  • [ ] other color names
  • [x] typst
  • [ ] TODO: @cscheid + @gordonwoodhull coordinate on this
  • [x] public Lua API for access
  • [x] shortcode
• [ ] typography
  • base, headings, monospace, monospace-inline, monospace-block:
  • [ ] html, revealjs, dashboard https://github.com/quarto-dev/quarto-cli/pull/10727
    • font properties. The full mapping is at src/core/sass/brand.ts; not all entries map to all formats/typeface configurations
    • [x] family
    • [x] size
    • [x] weight
    • [x] line-height
    • [x] color
    • [x] background-color
  • [x] typst
  • [ ] public Lua API for access
  • [ ] shortcode
• [ ] logo
  • [x] #11002
  • [x] #10966
  • [x] typst
  • [x] public Lua API for access (https://github.com/quarto-dev/quarto-cli/pull/11140)
  • [x] shortcode (https://github.com/quarto-dev/quarto-cli/pull/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
  • [x] project-level
  • [x] document-level
• [ ] preview monitoring of _brand.yml

PRs:

• [x] https://github.com/quarto-dev/quarto-cli/pull/10250
• [x] https://github.com/quarto-dev/quarto-cli/pull/10327: color entries into HTML bootstrap SASS
• [x] https://github.com/quarto-dev/quarto-cli/pull/10341: color entries into revealjs SASS. Respect primary as link color
• [x] https://github.com/quarto-dev/quarto-cli/pull/10362: color: Lua API, brand shortcode (currently only color support)
• [x] https://github.com/quarto-dev/quarto-cli/pull/10623
• [x] https://github.com/quarto-dev/quarto-cli/pull/10727
• [x] #10966
• [x] #11002
• [ ] https://github.com/quarto-dev/quarto-cli/pull/11140: logo shortcode and Lua API.

Verification:

• [x] 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

[cscheid]

I'm happy to ship what we have with 1.6 and continue improving it in 1.7.