format-links create a new link instead of renaming

Quarto document	HTML
--- title: "Demo" format: html: default typst: default format-links: - format: typst text: Whatever --- {{< lipsum 1 >}}

FYI, it was first reported in #8610 (comment)

Current workaround is to add all formats into the format-links part, including html

---
title: "Demo"
format:
  html: default
  typst: default
format-links:
  - html
  - format: typst
    text: Whatever
---

{{< lipsum 1 >}}

Probably filtering would be better, but this is currently how it works

Finally solved `format-link` issue creating new links. See quarto-dev…

I can still reproduce this with 1.11.9 and the 1.12.0 prerelease. It also happens when format-links is set under format: html:, with several formats:

format:
  html:
    format-links:
      - format: typst
        text: PDF
        icon: file-pdf
      - format: docx
        text: Word
        icon: file-word
  typst: default
  docx: default

"Other Formats" shows PDF, Word, Typst, MS Word.

The default links are added unless one entry is a plain string, and {format: ...} entries are not counted:

quarto-cli/src/format/html/format-html-links.ts

Lines 157 to 167 in d5e0617

    
           const userLinksHasFormat = userLinks && 
        
             userLinks.some((link) => typeof link === "string"); 
        
           if (!userLinksHasFormat) { 
        
             formats.forEach((renderedFormat) => { 
        
               const baseFormat = renderedFormat.format.identifier["base-format"]; 
        
               if (!kExcludeFormatUnlessExplicit.includes(baseFormat || "html")) { 
        
                 alternateLinks.push(alternateLinkForFormat(renderedFormat, count)); 
        
               } 
        
               count++; 
        
             }); 
        
           }

This check dates from when the {format, text} form was added (6b62246), so not a regression. We could count entries with a format key too, so that listing any format in format-links replaces the default list.

The - html workaround above still works with 1.12.0. Writing the format itself as a plain string (- docx) also removes the duplicates, but that link then keeps its default name.

I opened #15312 for this. With it, a {format, text} entry renames the link of that format instead of adding a second one. Other rendered formats keep their default link, so the original example shows only "Whatever".

I didn't go with counting format entries like plain format names, as I suggested above, because that would also drop the links to every rendered format not listed, and some documents rely on them. To show only some formats, add them as plain strings in format-links, as today.

Fix format-links object entries adding a duplicate link (quarto-dev#1…

Navigation Menu

Repository navigation

`format-links` create a new link instead of renaming #9606

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

	const userLinksHasFormat = userLinks &&
	userLinks.some((link) => typeof link === "string");
	if (!userLinksHasFormat) {
	formats.forEach((renderedFormat) => {
	const baseFormat = renderedFormat.format.identifier["base-format"];
	if (!kExcludeFormatUnlessExplicit.includes(baseFormat \|\| "html")) {
	alternateLinks.push(alternateLinkForFormat(renderedFormat, count));
	}
	count++;
	});
	}

format-links create a new link instead of renaming #9606

Description

Activity

cderv commented on May 14, 2024

cderv commented on Nov 6, 2026

cderv commented on Nov 6, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

`format-links` create a new link instead of renaming #9606