diff --git a/CHANGELOG b/CHANGELOG index fcf9340ef..74d9e669e 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -1,3 +1,8 @@ +mkdocs-material-8.0.4+insiders-4.3.0 (2021-12-05) + + * Added support for custom fonts in social cards + * Fixed #3300: Announcement bar reappearing when using instant loading + mkdocs-material-8.0.4 (2012-12-04) * Improved support for deeply nested code annotations diff --git a/docs/insiders/changelog.md b/docs/insiders/changelog.md index 8ca7ac7e3..6d40aa665 100644 --- a/docs/insiders/changelog.md +++ b/docs/insiders/changelog.md @@ -6,6 +6,11 @@ template: overrides/main.html ## Material for MkDocs Insiders +### 4.3.0 _ December 5, 2021 { id="4.3.0" } + +- Added support for custom fonts in social cards +- Fixed #3300: Announcement bar reappearing when using instant loading + ### 4.2.0 _ December 2, 2021 { id="4.2.0" } - Added support for dismissable announcement bar diff --git a/docs/setup/setting-up-social-cards.md b/docs/setup/setting-up-social-cards.md index 44f4efd7f..ae0fe6a8d 100644 --- a/docs/setup/setting-up-social-cards.md +++ b/docs/setup/setting-up-social-cards.md @@ -57,7 +57,7 @@ The following configuration options are available: `cards`{ #cards } -: :octicons-milestone-24: Default: `true` – This option specifies whether +: :octicons-milestone-24: Default: `true` – This option specifies whether to generate social card images. If you want to switch the plugin off, e.g. for local builds, you can use an [environment variable]: @@ -70,9 +70,9 @@ The following configuration options are available: `cards_color`{ #cards-color } : [:octicons-tag-24: insiders-2.13.0][Insiders] · :octicons-milestone-24: - Default: [primary color][palette.primary] – This option specifies which - colors to use for the background `fill` and foreground `text` when - generating the social card: + Default: [`theme.palette.primary`][palette.primary] – This option specifies + the colors for the background `fill` and foreground `text` when generating + the social card: ``` yaml plugins: @@ -85,6 +85,19 @@ The following configuration options are available: 1. Colors can either be defined as HEX colors, or as [CSS color keywords]. Note that HEX colors must be enclosed in quotes. +`cards_font`{ #cards-font } + +: [:octicons-tag-24: insiders-4.3.0][Insiders] · :octicons-milestone-24: + Default: [`theme.font.text`][font.text] – This option specifies which font + to use for rendering the social card, which can be any font hosted on + [Google Fonts]: + + ``` yaml + plugins: + - social: + cards_font: Roboto + ``` + `cards_directory`{ #cards-directory } : :octicons-milestone-24: Default: `assets/images/social` – This option @@ -102,6 +115,7 @@ The following configuration options are available: [site_url]: https://www.mkdocs.org/user-guide/configuration/#site_url [environment variable]: https://www.mkdocs.org/user-guide/configuration/#environment-variables [CSS color keywords]: https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#color_keywords + [Google Fonts]: https://fonts.google.com #### Dependencies