yuriy/quartz-website
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: updated fonts configuration

Browse Source
This commit is contained in:
saberzero1
2026-06-11 10:46:55 +02:00
parent 58593c7c72
commit 87083faeb6
1 changed files with 10 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/plugins/Fonts.md
+10 -10
View File
@@ -10,7 +10,7 @@ enabled: true
required: false required: false
--- ---
This plugin provides fine-grained control over fonts in your Quartz site. It supports per-heading font families, automatic theme font discovery when used with [[plugins/QuartzTheme|QuartzTheme]], Google Fonts integration with automatic weight and italic loading, and falls back to Obsidian's default system font stacks. This plugin provides fine-grained control over fonts in your Quartz site. It supports per-heading font families, automatic theme font discovery when used with [Quartz Themes](https://github.com/saberzero1/quartz-themes), Google Fonts integration with automatic weight and italic loading, and falls back to Obsidian's default system font stacks.
> [!note] > [!note]
> For information on how to add, remove or configure plugins, see the [[configuration#Plugins|Configuration]] page. > For information on how to add, remove or configure plugins, see the [[configuration#Plugins|Configuration]] page.
@@ -51,8 +51,8 @@ This plugin accepts the following configuration options:
| `code` | `FontSpecification` | Obsidian default | Font family for code and monospace elements. | | `code` | `FontSpecification` | Obsidian default | Font family for code and monospace elements. |
| `interface` | `FontSpecification` | Obsidian default | Font family for UI elements. | | `interface` | `FontSpecification` | Obsidian default | Font family for UI elements. |
| `h1` – `h6` | `FontSpecification` | `header` value | Per-heading font family overrides. | | `h1` – `h6` | `FontSpecification` | `header` value | Per-heading font family overrides. |
| `useThemeFonts` | `boolean` | `true` | Use fonts from QuartzTheme as defaults when it is installed. | | `useThemeFonts` | `boolean` | `true` | Use fonts from [Quartz Themes](https://github.com/saberzero1/quartz-themes) as defaults when it is installed. |
| `fontOrigin` | `string` | `"local"` | `"googleFonts"` to load from Google Fonts CDN, `"selfHosted"` to download and serve locally, `"local"` for no loading. | | `fontOrigin` | `string` | `"googleFonts"` | `"googleFonts"` to load from Google Fonts CDN, `"selfHosted"` to download and serve locally, `"local"` for no loading. |
### Default options ### Default options
@@ -61,7 +61,7 @@ This plugin accepts the following configuration options:
enabled: true enabled: true
options: options:
useThemeFonts: true useThemeFonts: true
fontOrigin: local fontOrigin: googleFonts
``` ```
### Font resolution ### Font resolution
@@ -70,7 +70,7 @@ Fonts are resolved using a priority chain:
``` ```
User config (plugin options) User config (plugin options)
→ Theme fonts (from QuartzTheme, if installed) → Theme fonts (from Quartz Themes, if installed)
→ Obsidian defaults (system font stacks) → Obsidian defaults (system font stacks)
``` ```
@@ -86,16 +86,16 @@ For the site title:
title option → header option → theme font → Obsidian default title option → header option → theme font → Obsidian default
``` ```
## Usage with QuartzTheme ## Usage with Quartz Themes
When [[plugins/QuartzTheme|QuartzTheme]] is installed and enabled, Fonts automatically discovers the theme's font metadata and uses it as defaults. Any options you explicitly set in Fonts will override the theme fonts. When [Quartz Themes](https://github.com/saberzero1/quartz-themes) is installed and enabled, Fonts automatically discovers the theme's font metadata and uses it as defaults. Any options you explicitly set in Fonts will override the theme fonts.
Fonts must run **after** QuartzTheme. This is handled automatically by plugin ordering (QuartzTheme = 50, Fonts = 60). Fonts must run **after** Quartz Themes. This is handled automatically by plugin ordering (Quartz Themes = 10, Fonts = 60).
> [!warning] > [!warning]
> If QuartzTheme is enabled but hasn't run yet when Fonts executes, you'll see a warning in the console. Make sure QuartzTheme has a lower `defaultOrder` than Fonts. > If Quartz Themes is enabled but hasn't run yet when Fonts executes, you'll see a warning in the console. Make sure Quartz Themes has a lower `defaultOrder` than Fonts.
## Usage without QuartzTheme ## Usage without Quartz Themes
Fonts works standalone. Without a theme, it falls back to Obsidian's default system font stacks. You can set fonts explicitly via the plugin options. Fonts works standalone. Without a theme, it falls back to Obsidian's default system font stacks. You can set fonts explicitly via the plugin options.