Documentation

docs/setup/setting-up-social-cards.md

@@ -95,71 +95,45 @@ 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.
+    !!! question "Why do social cards render boxes for CJK languages?"
 
-        === "Simplified Chinese"
-            === "Sans Serif Font"
-                ``` yaml
-                plugins:
-                  - social:
-                      cards_font: Noto Sans SC
-                ```
+        Some fonts do not contain CJK characters, like for example the
+        [default font, `Roboto`][font.text]. In case your `site_name`,
+        `site_description`, or [page title] contain CJK characters, choose
+        another font from [Google Fonts] which comes with CJK characters, e.g.
+        one from the `Noto Sans` font family:
 
-            === "Serif Font"
-                ``` yaml
-                plugins:
-                  - social:
-                      cards_font: Noto Serif SC
-                ```
+        === "Chinese (Simplified)"
 
-        === "Traditional Chinese"
-            === "Sans Serif Font"
-                ``` yaml
-                plugins:
-                  - social:
-                      cards_font: Noto Sans TC
-                ```
+            ``` yaml
+            plugins:
+              - social:
+                  cards_font: Noto Sans SC
+            ```
 
-            === "Serif Font"
-                ``` yaml
-                plugins:
-                  - social:
-                      cards_font: Noto Serif TC
-                ```
+        === "Chinese (Traditional)"
+
+            ``` yaml
+            plugins:
+              - social:
+                  cards_font: Noto Sans TC
+            ```
 
         === "Japanese"
-            === "Sans Serif Font"
-                ``` yaml
-                plugins:
-                  - social:
-                      cards_font: Noto Sans JP
-                ```
 
-            === "Serif Font"
-                ``` yaml
-                plugins:
-                  - social:
-                      cards_font: Noto Serif JP
-                ```
+            ``` yaml
+            plugins:
+              - social:
+                  cards_font: Noto Sans JP
+            ```
 
         === "Korean"
-            === "Sans Serif Font"
-                ``` yaml
-                plugins:
-                  - social:
-                      cards_font: Noto Sans KR
-                ```
 
-            === "Serif Font"
-                ``` yaml
-                plugins:
-                  - social:
-                      cards_font: Noto Serif KR
-                ```
+            ``` yaml
+            plugins:
+              - social:
+                  cards_font: Noto Sans KR
+            ```
 
 [`cards_dir`](#+social.cards_dir){ #+social.cards_dir }
 
@@ -181,6 +155,7 @@ The following configuration options are available:
   [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
+  [page title]: ../reference/index.md#setting-the-page-title
 
 #### Dependencies