implement brand yml for dashboard

allowing logo override with path or resource name
also allowing logo object with path containing one of those and opt alt text

Author: gordonwoodhull

src/resources/filters/quarto-post/dashboard.lua

@@ -737,6 +737,44 @@ function render_dashboard()
           return doc
         end
       end
+    }, {
+      -- todo: dark mode
+      Meta = function(meta)
+        local logo = meta.logo
+        local resolved
+        if logo then
+          local which
+          if pandoc.utils.type(logo) == 'Inlines' then 
+            which = logo[1].text
+            local brandLogo = _quarto.modules.brand.get_logo(logo[1].text)
+            resolved = brandLogo and brandLogo.light
+          elseif type(logo) == 'table' then
+            local brandLogo = _quarto.modules.brand.get_logo(logo.path[1].text)
+            if brandLogo then
+              resolved = brandLogo.light
+              if logo.alt then
+                resolved.alt = logo.alt
+              end
+            else
+              resolved = {
+                path = logo.path,
+                alt = logo.alt
+              }
+            end
+          end
+        else
+          logo = _quarto.modules.brand.get_logo('small')
+            or _quarto.modules.brand.get_logo('medium')
+            or _quarto.modules.brand.get_logo('large')
+          resolved = logo and logo.light
+        end
+        if resolved then
+          meta.logo = resolved.path
+          meta['logo-alt'] = resolved.alt
+        end
+
+        return meta
+      end
     }
   }
 end

tests/docs/smoke-all/brand/logo/choose-logo-resource.qmd

@@ -0,0 +1,26 @@
+---
+title: brand and base logo
+format:
+  dashboard: default
+brand:
+  logo:
+    images:
+      quarto:
+        path: quarto.png
+        alt: quarto logo
+      posit:
+        path: posit-logo-2024.svg
+        alt: posit logo
+    medium: quarto
+    large: posit
+logo: large
+_quarto:
+  tests:
+    dashboard:
+      ensureFileRegexMatches:
+        -
+          - '<img src="posit-logo-2024\.svg" alt="posit logo"'
+        - []
+---
+
+{{< lipsum 4 >}}

tests/docs/smoke-all/brand/logo/default-logo.qmd

@@ -0,0 +1,25 @@
+---
+title: brand and base logo
+format:
+  dashboard: default
+brand:
+  logo:
+    images:
+      quarto:
+        path: quarto.png
+        alt: quarto logo
+      posit:
+        path: posit-logo-2024.svg
+        alt: posit logo
+    medium: quarto
+    large: posit
+_quarto:
+  tests:
+    dashboard:
+      ensureFileRegexMatches:
+        -
+          - '<img src="quarto\.png" alt="quarto logo"'
+        - []
+---
+
+{{< lipsum 4 >}}

tests/docs/smoke-all/brand/logo/override-logo-path-alt.qmd

@@ -0,0 +1,28 @@
+---
+title: brand and base logo
+format:
+  dashboard: default
+brand:
+  logo:
+    images:
+      quarto:
+        path: quarto.png
+        alt: quarto logo
+      posit:
+        path: posit-logo-2024.svg
+        alt: posit logo
+    medium: quarto
+    large: posit
+logo:
+  path: posit-logo-2024.svg
+  alt: posit logo
+_quarto:
+  tests:
+    dashboard:
+      ensureFileRegexMatches:
+        -
+          - '<img src="posit-logo-2024\.svg" alt="posit logo"'
+        - []
+---
+
+{{< lipsum 4 >}}

tests/docs/smoke-all/brand/logo/override-logo-path.qmd

@@ -0,0 +1,26 @@
+---
+title: brand and base logo
+format:
+  dashboard: default
+brand:
+  logo:
+    images:
+      quarto:
+        path: quarto.png
+        alt: quarto logo
+      posit:
+        path: posit-logo-2024.svg
+        alt: posit logo
+    medium: quarto
+    large: posit
+logo: posit-logo-2024.svg
+_quarto:
+  tests:
+    dashboard:
+      ensureFileRegexMatches:
+        -
+          - '<img src="posit-logo-2024\.svg" alt=""'
+        - []
+---
+
+{{< lipsum 4 >}}

tests/docs/smoke-all/brand/logo/override-logo-resource-alt.qmd

@@ -0,0 +1,28 @@
+---
+title: brand and base logo
+format:
+  dashboard: default
+brand:
+  logo:
+    images:
+      quarto:
+        path: quarto.png
+        alt: quarto logo
+      posit:
+        path: posit-logo-2024.svg
+        alt: posit logo
+    medium: quarto
+    large: posit
+logo:
+  path: large
+  alt: logo of posit
+_quarto:
+  tests:
+    dashboard:
+      ensureFileRegexMatches:
+        -
+          - '<img src="posit-logo-2024\.svg" alt="logo of posit"'
+        - []
+---
+
+{{< lipsum 4 >}}

tests/docs/smoke-all/brand/logo/override-logo-resource.qmd

@@ -0,0 +1,27 @@
+---
+title: brand and base logo
+format:
+  dashboard: default
+brand:
+  logo:
+    images:
+      quarto:
+        path: quarto.png
+        alt: quarto logo
+      posit:
+        path: posit-logo-2024.svg
+        alt: posit logo
+    medium: quarto
+    large: posit
+logo:
+  path: large
+_quarto:
+  tests:
+    dashboard:
+      ensureFileRegexMatches:
+        -
+          - '<img src="posit-logo-2024\.svg" alt="posit logo"'
+        - []
+---
+
+{{< lipsum 4 >}}