Site-wide Setup
Instead of configuring support-this in every page, you can set it up once for a whole website or blog, or for one folder of it. Pages then get the support section with no configuration of their own.
A whole website or blog
Put the filter and the options in _quarto.yml. Every page of the project gets the section.
project:
type: website
filters:
- support-this
extensions:
support-this:
description: "Your support keeps this work going."
platforms:
github: username
ko_fi: usernameOne folder
To add the section to only some pages, such as the posts of a blog, put the same keys in a _metadata.yml file in their folder. Pages in the folder and its subfolders get the section; the rest of the site doesn’t.
# posts/_metadata.yml
filters:
- support-this
extensions:
support-this:
description: "Your support keeps this work going."
platforms:
github: username
ko_fi: usernameIf _quarto.yml also sets support-this options, a folder’s _metadata.yml adds to them: it can change the display for the folder, or add a platform, and keep the rest.
Live example
This site’s blog/ folder has this _metadata.yml:
filters:
- support-this
extensions:
support-this:
heading: "Enjoying the Blog?"
description: "Set once in blog/_metadata.yml."
platforms:
github: coatless
patreon: username
ko_fi: usernameIts two pages, First Post and Second Post, have only a title in their front matter, and both end with the support section.
Changing one page
A page’s own
extensions: support-this:options are combined with the shared ones. Options the page sets replace the shared values, and the rest still apply. Platforms combine the same way: the page’s platforms are added to the shared ones, and a platform set in both places uses the page’s account.To leave the section off one page, set the entry to
false:extensions: support-this: falseRemoving the filter doesn’t work there: Quarto combines a page’s
filterswith the shared ones.A page that also lists
filters: [support-this]still gets the section only once.