How to include multiple links in format:html:link-external-filter?

[Qepanna]

Description

Hi, I'm very new to Quarto and I need help to understand some coding basics.

In my -quarto.yml file, I would like to use the options for external links as follows:

project:
  type: website

format:
  html:
    link-external-icon: true
    link-external-newwindow: true
    link-external-filter: '^(?:http:|https:)\/\/www\.quarto\.org\/custom'

This works.

But I would also like to add more links to the link-external-filter option. I tried something like this:

project:
  type: website

format:
  html:
    link-external-icon: true
    link-external-newwindow: true
    link-external-filter:
      - '^(?:http:|https:)\/\/www\.quarto\.org\/custom'
      - '^(?:http:|https:)\/\/www\.doi\.org\/custom'

But I get the following error message:

Project _quarto.yml validation failed.

In file C:\goFlux-workshop\_quarto.yml
(line 12, column 7 through line 13, column 53) Field "link-external-filter" has value

- '^(?:http:|https:)\/\/www\.quarto\.org\/custom'
  - '^(?:http:|https:)\/\/www\.doi\.org\/custom'

The value must instead be a string.
11:     link-external-filter:
12:       - '^(?:http:|https:)\/\/www\.quarto\.org\/custom'
         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
13:       - '^(?:http:|https:)\/\/www\.doi\.org\/custom'
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
x The value

- '^(?:http:|https:)\/\/www\.quarto\.org\/custom'
  - '^(?:http:|https:)\/\/www\.doi\.org\/custom'

is of type an array.
i The error happened in location format:html:link-external-filter.

I don't understand what it is suggesting me to do.

Thank you for your help!

Best,
Karelle

[mcanouil]

link-external-filter: '^(?:http:|https:)\/\/www\.quarto\.org\/custom'

This is a string provided to the option.

link-external-filter:
  - '^(?:http:|https:)\/\/www\.quarto\.org\/custom'

This is an array of strings.

The string is a regular expression as explained in the documentation.
Something like below (not tested).

link-external-filter: '^(?:http:|https:)\/\/(www\.quarto\.org|www\.doi\.org)\/custom'

[Qepanna]

Your solution works for complete links, such as the ones in your examples. Is there a way to make it work for any link that contain 'https://www.quarto.org/' or 'https://www.doi.org/'? For example, can I use a wild card?

I tried something like this:

link-external-filter: '^mailto:[email protected]|(?:http:|https:)\/\/(www\.quarto\.pub\/*|twitter\.com\/KarelleRheault|www\.doi\.org\/*)'

This works for my email and my Twitter, but not for the rest.

[mcanouil]

It's a regular expression, so any pattern properly written should work.
Note that providing a small reproducible example helps, see mine from earlier.

[Qepanna]

None of the doi links nor the quarto links are actually in the source script. All the quarto links are my own internal links between sections, and the doi links are from citations.

DOI example

Hutchinson and Mosier @hutchinson1981

Internal link example

[Import all files](import.qmd#sec-import2RData)

[mcanouil]

It works just fine.
Please provide as I do a small and complete reproducible example of this not working.
There is nothing we can do with screenshots.

---
title: "Quarto Playground"
format:
  html:
    link-external-icon: true
    link-external-newwindow: true
    link-external-filter: '^(?:http:|https:)\/\/(www\.)*(quarto\.org|doi\.org)\/.*$'
---

<https://www.quarto.org/>

<https://www.quarto.org/docs/get-started/>

<https://www.doi.org/>

<https://doi.org/10.2337/dc20-2960>

<https://mickael.canouil.fr/>

[Qepanna]

Thank you, it worked with your last suggestion!

link-external-filter: '^mailto:[email protected]|(?:http:|https:)\/\/(?:www\.)*(qepanna\.quarto\.pub|doi\.org|twitter\.com)\/.*$'

[mcanouil]

It's regular expression: https://regex101.com/