OpenSourceArk/mkdocs-material
1
0
Fork 0
mirror of https://github.com/squidfunk/mkdocs-material.git synced 2024-06-14 11:52:32 +03:00
Code Issues Packages Projects Releases Wiki Activity

Added recommended fonts for social cards and Asian languages (#4357)

Browse Source
This commit is contained in:
Jason Ren 2022-09-18 21:53:41 +08:00 committed by GitHub
parent a750a66f9c
commit 6bd88485d2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 66 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

66
docs/setup/setting-up-social-cards.md
View File

@ -95,6 +95,72 @@ The following configuration options are available:
cards_font: Roboto
```
!!! tip "Limitations of the default `Roboto` font"
The default font value `Roboto` has no support to CJK languages,
if you tend to have these characters in your page's title,
or your `site_name` and `site_description` is containing CJK letters,
you may switch to Noto family (`Noto Sans` or `Noto Serif`) which provides support to CJK languages, to avoid render error.
=== "Simplified Chinese"
=== "Sans Serif Font"
``` yaml
plugins:
- social:
cards_font: Noto Sans SC
```
=== "Serif Font"
``` yaml
plugins:
- social:
cards_font: Noto Serif SC
```
=== "Traditional Chinese"
=== "Sans Serif Font"
``` yaml
plugins:
- social:
cards_font: Noto Sans TC
```
=== "Serif Font"
``` yaml
plugins:
- social:
cards_font: Noto Serif TC
```
=== "Japanese"
=== "Sans Serif Font"
``` yaml
plugins:
- social:
cards_font: Noto Sans JP
```
=== "Serif Font"
``` yaml
plugins:
- social:
cards_font: Noto Serif JP
```
=== "Korean"
=== "Sans Serif Font"
``` yaml
plugins:
- social:
cards_font: Noto Sans KR
```
=== "Serif Font"
``` yaml
plugins:
- social:
cards_font: Noto Serif KR
```
[`cards_dir`](#+social.cards_dir){ #+social.cards_dir }
: :octicons-milestone-24: Default: `assets/images/social` – This option