[feature] brand - forward logo.small to favicon

Author: cscheid

news/changelog-1.7.md

@@ -17,6 +17,7 @@ All changes included in 1.7:
 ## Website projects
 
 - ([#11701](https://github.com/quarto-dev/quarto-cli/issues/11701)): Wrap HTML emitted by EJS templates in `{=html}` blocks to avoid memory blowup issues with Pandoc's parser.
+- ([#12134](https://github.com/quarto-dev/quarto-cli/issues/12134)): Forward `logo.small` images in `_brand.yml` files to a website `favicon`.
 
 ## Blog projects
 
@@ -25,6 +26,7 @@ All changes included in 1.7:
 ## Book projects
 
 - ([#11520](https://github.com/quarto-dev/quarto-cli/issues/11520)): Book's cover image now escapes lightbox treatment, which was incorrectly applied to it when `lightbox: true` was set in the book's configuration.
+- ([#12134](https://github.com/quarto-dev/quarto-cli/issues/12134)): Forward `logo.small` images in `_brand.yml` files to the `favicon` of the book's website.
 
 ## `quarto check`
 

src/core/brand/brand.ts

@@ -283,3 +283,11 @@ export class Brand {
     }
   }
 }
+
+export const getFavicon = (brand: Brand): string | undefined => {
+  const logoInfo = brand.getLogo("small");
+  if (!logoInfo) {
+    return undefined;
+  }
+  return logoInfo.light.path;
+};

src/project/types/book/book-config.ts

@@ -125,6 +125,7 @@ import {
 import { projectType } from "../project-types.ts";
 import { BookRenderItem, BookRenderItemType } from "./book-types.ts";
 import { isAbsoluteRef } from "../../../core/http.ts";
+import { getFavicon } from "../../../core/brand/brand.ts";
 
 export async function bookProjectConfig(
   project: ProjectContext,
@@ -141,6 +142,12 @@ export async function bookProjectConfig(
   if (book) {
     site[kSiteTitle] = book[kSiteTitle];
     site[kSiteFavicon] = book[kSiteFavicon];
+    if (!site[kSiteFavicon]) {
+      const brand = await project.resolveBrand();
+      if (brand) {
+        site[kSiteFavicon] = getFavicon(brand);
+      }
+    }
     site[kSiteUrl] = book[kSiteUrl];
     site[kSitePath] = book[kSitePath];
     site[kSiteRepoUrl] = book[kSiteRepoUrl];

src/project/types/website/website.ts

@@ -90,6 +90,7 @@ import { kFieldCategories } from "./listing/website-listing-shared.ts";
 import { pandocNativeStr } from "../../../core/pandoc/codegen.ts";
 import { asArray } from "../../../core/array.ts";
 import { canonicalizeTitlePostprocessor } from "../../../format/html/format-html-title.ts";
+import { getFavicon } from "../../../core/brand/brand.ts";
 
 export const kSiteTemplateDefault = "default";
 export const kSiteTemplateBlog = "blog";
@@ -178,7 +179,13 @@ export const websiteProjectType: ProjectType = {
     }
 
     // dependency for favicon if we have one
-    const favicon = websiteConfigString(kSiteFavicon, project.config);
+    let favicon = websiteConfigString(kSiteFavicon, project.config);
+    if (!favicon) {
+      const brand = await project.resolveBrand();
+      if (brand) {
+        favicon = getFavicon(brand);
+      }
+    }
     if (favicon) {
       const offset = projectOffset(project, source);
       extras.html = extras.html || {};

tests/docs/smoke-all/brand/logo/brand-icon-small-favicon-book/.gitignore

@@ -0,0 +1 @@
+/.quarto/

tests/docs/smoke-all/brand/logo/brand-icon-small-favicon-book/_brand.yml

@@ -0,0 +1,2 @@
+logo:
+  small: logos/small.png

tests/docs/smoke-all/brand/logo/brand-icon-small-favicon-book/_quarto.yml

@@ -0,0 +1,25 @@
+project:
+  type: book
+
+book:
+  title: "brand-icon-small-favicon-book"
+  author: "Norah Jones"
+  date: "2/21/2025"
+  chapters:
+    - index.qmd
+    - intro.qmd
+    - summary.qmd
+    - references.qmd
+
+bibliography: references.bib
+
+format:
+  html:
+    theme:
+      - cosmo
+      - brand
+  pdf:
+    documentclass: scrreprt
+
+
+

tests/docs/smoke-all/brand/logo/brand-icon-small-favicon-book/cover.png

@@ -0,0 +1,14 @@
+---
+_quarto:
+  tests:
+    html:
+      ensureFileRegexMatches:
+        - ['<link href="./logos/small.png" rel="icon" type="image/png">']
+        - []
+---
+
+# Preface {.unnumbered}
+
+This is a Quarto book.
+
+To learn more about Quarto books visit <https://quarto.org/docs/books>.

tests/docs/smoke-all/brand/logo/brand-icon-small-favicon-book/index.qmd

@@ -0,0 +1,5 @@
+# Introduction
+
+This is a book created from markdown and executable code.
+
+See @knuth84 for additional discussion of literate programming.