From 6bd88485d29d9c9bc41fbccf8f8e6353e06950ca Mon Sep 17 00:00:00 2001
From: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
Date: Sun, 18 Sep 2022 21:53:41 +0800
Subject: [PATCH] Added recommended fonts for social cards and Asian languages
 (#4357)

---
 docs/setup/setting-up-social-cards.md | 66 +++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/docs/setup/setting-up-social-cards.md b/docs/setup/setting-up-social-cards.md
index c99f5e61b..8ccdbed00 100644
--- a/docs/setup/setting-up-social-cards.md
+++ b/docs/setup/setting-up-social-cards.md
@@ -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